quadratik
Collection of methods constructed using the kernel-based quadratic distances
Science Score: 49.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 10 DOI reference(s) in README -
✓Academic publication links
Links to: arxiv.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (15.3%) to scientific vocabulary
Repository
Collection of methods constructed using the kernel-based quadratic distances
Basic Info
- Host: GitHub
- Owner: ropensci
- License: gpl-3.0
- Language: HTML
- Default Branch: main
- Homepage: https://docs.ropensci.org/QuadratiK/
- Size: 96 MB
Statistics
- Stars: 1
- Watchers: 1
- Forks: 3
- Open Issues: 1
- Releases: 1
Metadata Files
README.md
| Usage | Release | Development |
|------------------|------------------------|------------------------------|
|
|
| 
| |
Collection of Methods Constructed using the Kernel-Based Quadratic Distances
QuadratiK provides the first implementation, in R and Python, of a comprehensive set of goodness-of-fit tests and a clustering technique for $d$-dimensional spherical data $d \ge 2$ using kernel-based quadratic distances. It includes:
Goodness-of-Fit Tests: The software implements one, two, and k-sample tests for goodness of fit, offering an efficient and mathematically sound way to assess the fit of probability distributions. Our tests are particularly useful for large, high dimensional data sets where the assessment of fit of probability models is of interest. Specifically, we offer tests for multivariate normality, as well as two- and k-sample tests, where testing equality of two or more distributions is of interest, that is $H0: F1 = F2$ and $H0: F1 = \ldots = Fk$ respectively. The proposed tests perform well in terms of level and power for contiguous alternatives, heavy tailed distributions and in higher dimensions.\ Expanded capabilities include supporting tests for uniformity on the d-dimensional Sphere based on the Poisson kernel, exhibiting excellent results especially in the case of multimodal distributions.
Poisson kernel-based distribution (PKBD): the package offers functions for computing the density value and for generating random samples from a PKBD. The Poisson kernel-based densities are based on the normalized Poisson kernel and are defined on the $d$-dimensional unit sphere. Given a vector $\mu \in \mathcal{S}^{d-1}$, and a parameter $\rho$ such that $0 < \rho < 1$, the probability density function of a $d$-variate Poisson kernel-based density is defined by: $$f(\mathbf{x}|\rho, \mathbf{\mu}) = \frac{1-\rho^2}{\omegad ||\mathbf{x} - \rho \mathbf{\mu}||^d},$$ where $\mu$ is a vector orienting the center of the distribution, $\rho$ is a parameter to control the concentration of the distribution around the vector $\mu$ and it is related to the variance of the distribution. Furthermore, $\omegad = 2\pi^{d/2} [\Gamma(d/2)]^{-1}$ is the surface area of the unit sphere in $\mathbb{R}^d$ (see Golzy and Markatou, 2020).
Clustering Algorithm for Spherical Data: the package incorporates a unique clustering algorithm specifically tailored for $d$-dimensional spherical data and it is especially useful in the presence of noise in the data and the presence of non-negligible overlap between clusters. This algorithm leverages a mixture of Poisson kernel-based densities on the $d$-dimensional Sphere, enabling effective clustering of spherical data or data that has been spherically transformed.
Additional Features: Alongside these functionalities, the software includes additional graphical functions, aiding users in validating and representing the cluster results as well as enhancing the interpretability and usability of the analysis.
For an introduction to the usage of QuadratiK see the vignette Introduction to the QuadratiK Package.
Installation
You can install the version published on CRAN of QuadratiK
r
install.packages("QuadratiK")
or the development version from GitHub
``` r library(devtools) install_github('ropensci/QuadratiK')
or via the rOpenSci organization repository
install.packages("QuadratiK", repos = "https://ropensci.r-universe.dev") ```
The QuadratiK package is also available in Python on PyPI https://pypi.org/project/QuadratiK/ and also as a Dashboard application. Usage instruction for the Dashboard can be found at https://quadratik.readthedocs.io/en/latest/user_guide/dashboard_application_usage.html.
Authors
Giovanni Saraceno, Marianthi Markatou, Raktim Mukhopadhyay, Mojgan Golzy\ Maintainer: Giovanni Saraceno <giovanni.saraceno\@unipd.it>
Citation
If you use this package in your research or work, please cite it as follows:
Saraceno, G., Markatou, M., Mukhopadhyay, R. and Golzy, M. (2024). QuadratiK: Collection of Methods Constructed using Kernel-Based Quadratic Distances. https://cran.r-project.org/package=QuadratiK, https://github.com/ropensci/QuadratiK, https://docs.ropensci.org/QuadratiK/.
@Manual{saraceno2024QuadratiK,
title = {QuadratiK: Collection of Methods Constructed using Kernel-Based
Quadratic Distances},
author = {Giovanni Saraceno and Marianthi Markatou and Raktim Mukhopadhyay
and Mojgan Golzy},
year = {2024},
note = {<https://cran.r-project.org/package=QuadratiK>,
<https://github.com/ropensci/QuadratiK>,
<https://docs.ropensci.org/QuadratiK/>},
}
and the associated paper:
Saraceno, G., Markatou, M., Mukhopadhyay, R. and Golzy, M. (2024). Goodness-of-Fit and Clustering of Spherical Data: the QuadratiK package in R and Python. arXiv preprint arXiv:2402.02290v2.
@misc{saraceno2024package,
title={Goodness-of-Fit and Clustering of Spherical Data: the QuadratiK
package in R and Python},
author={Giovanni Saraceno and Marianthi Markatou and Raktim Mukhopadhyay
and Mojgan Golzy},
year={2024},
eprint={2402.02290},
archivePrefix={arXiv},
primaryClass={stat.CO}, url={https://arxiv.org/abs/2402.02290}
}
References
Ding, Y., Markatou, M. and Saraceno, G. (2023). “Poisson Kernel-Based Tests for Uniformity on the d-Dimensional Sphere.” Statistica Sinica. doi: 10.5705/ss.202022.0347.
Golzy, M. & Markatou, M. (2020) Poisson Kernel-Based Clustering on the Sphere: Convergence Properties, Identifiability, and a Method of Sampling, Journal of Computational and Graphical Statistics, 29:4, 758-770, DOI: 10.1080/10618600.2020.1740713.
Markatou, M. and Saraceno, G. (2024). “A Unified Framework for Multivariate Two- and k-Sample Kernel-based Quadratic Distance Goodness-of-Fit Tests.” arXiv:2407.16374
Details
The work has been supported by Kaleida Health Foundation and National Science Foundation.
Please note that this package is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.
Owner
- Name: rOpenSci
- Login: ropensci
- Kind: organization
- Email: info@ropensci.org
- Location: Berkeley, CA
- Website: https://ropensci.org/
- Twitter: rOpenSci
- Repositories: 307
- Profile: https://github.com/ropensci
CodeMeta (codemeta.json)
{
"@context": "https://doi.org/10.5063/schema/codemeta-2.0",
"@type": "SoftwareSourceCode",
"identifier": "QuadratiK",
"description": "It includes test for multivariate normality, test for uniformity on the d-dimensional Sphere, non-parametric two- and k-sample tests, random generation of points from the Poisson kernel-based density and clustering algorithm for spherical data. For more information see Saraceno G., Markatou M., Mukhopadhyay R. and Golzy M. (2024) <doi:10.48550/arXiv.2402.02290> Markatou, M. and Saraceno, G. (2024) <doi:10.48550/arXiv.2407.16374>, Ding, Y., Markatou, M. and Saraceno, G. (2023) <doi:10.5705/ss.202022.0347>, and Golzy, M. and Markatou, M. (2020) <doi:10.1080/10618600.2020.1740713>.",
"name": "QuadratiK: Collection of Methods Constructed using Kernel-Based Quadratic Distances",
"relatedLink": [
"https://CRAN.R-project.org/package=QuadratiK",
"https://docs.ropensci.org/QuadratiK/"
],
"codeRepository": "https://github.com/ropensci/QuadratiK/",
"issueTracker": "https://github.com/ropensci/QuadratiK/issues",
"license": "https://spdx.org/licenses/GPL-3.0",
"version": "1.1.3",
"programmingLanguage": {
"@type": "ComputerLanguage",
"name": "R",
"url": "https://r-project.org"
},
"runtimePlatform": "R version 4.3.1 (2023-06-16 ucrt)",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"author": [
{
"@type": "Person",
"givenName": "Giovanni",
"familyName": "Saraceno",
"email": "giovanni.saraceno@unipd.it"
},
{
"@type": "Person",
"givenName": "Marianthi",
"familyName": "Markatou"
},
{
"@type": "Person",
"givenName": "Raktim",
"familyName": "Mukhopadhyay"
},
{
"@type": "Person",
"givenName": "Mojgan",
"familyName": "Golzy"
}
],
"maintainer": [
{
"@type": "Person",
"givenName": "Giovanni",
"familyName": "Saraceno",
"email": "giovanni.saraceno@unipd.it"
}
],
"softwareSuggestions": [
{
"@type": "SoftwareApplication",
"identifier": "knitr",
"name": "knitr",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=knitr"
},
{
"@type": "SoftwareApplication",
"identifier": "rmarkdown",
"name": "rmarkdown",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=rmarkdown"
},
{
"@type": "SoftwareApplication",
"identifier": "roxygen2",
"name": "roxygen2",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=roxygen2"
},
{
"@type": "SoftwareApplication",
"identifier": "testthat",
"name": "testthat",
"version": ">= 3.0.0",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=testthat"
},
{
"@type": "SoftwareApplication",
"identifier": "rgl",
"name": "rgl",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=rgl"
},
{
"@type": "SoftwareApplication",
"identifier": "sphunif",
"name": "sphunif",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=sphunif"
},
{
"@type": "SoftwareApplication",
"identifier": "circular",
"name": "circular",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=circular"
},
{
"@type": "SoftwareApplication",
"identifier": "cluster",
"name": "cluster",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=cluster"
},
{
"@type": "SoftwareApplication",
"identifier": "clusterRepro",
"name": "clusterRepro",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=clusterRepro"
},
{
"@type": "SoftwareApplication",
"identifier": "mclust",
"name": "mclust",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=mclust"
},
{
"@type": "SoftwareApplication",
"identifier": "Tinflex",
"name": "Tinflex",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=Tinflex"
},
{
"@type": "SoftwareApplication",
"identifier": "movMF",
"name": "movMF",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=movMF"
}
],
"softwareRequirements": {
"1": {
"@type": "SoftwareApplication",
"identifier": "R",
"name": "R",
"version": ">= 3.5.0"
},
"2": {
"@type": "SoftwareApplication",
"identifier": "parallel",
"name": "parallel"
},
"3": {
"@type": "SoftwareApplication",
"identifier": "doParallel",
"name": "doParallel",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=doParallel"
},
"4": {
"@type": "SoftwareApplication",
"identifier": "foreach",
"name": "foreach",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=foreach"
},
"5": {
"@type": "SoftwareApplication",
"identifier": "ggplot2",
"name": "ggplot2",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=ggplot2"
},
"6": {
"@type": "SoftwareApplication",
"identifier": "ggpubr",
"name": "ggpubr",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=ggpubr"
},
"7": {
"@type": "SoftwareApplication",
"identifier": "methods",
"name": "methods"
},
"8": {
"@type": "SoftwareApplication",
"identifier": "moments",
"name": "moments",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=moments"
},
"9": {
"@type": "SoftwareApplication",
"identifier": "mvtnorm",
"name": "mvtnorm",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=mvtnorm"
},
"10": {
"@type": "SoftwareApplication",
"identifier": "Rcpp",
"name": "Rcpp",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=Rcpp"
},
"11": {
"@type": "SoftwareApplication",
"identifier": "RcppEigen",
"name": "RcppEigen",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=RcppEigen"
},
"12": {
"@type": "SoftwareApplication",
"identifier": "rlecuyer",
"name": "rlecuyer",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=rlecuyer"
},
"13": {
"@type": "SoftwareApplication",
"identifier": "sn",
"name": "sn",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=sn"
},
"14": {
"@type": "SoftwareApplication",
"identifier": "stats",
"name": "stats"
},
"15": {
"@type": "SoftwareApplication",
"identifier": "rrcov",
"name": "rrcov",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=rrcov"
},
"16": {
"@type": "SoftwareApplication",
"identifier": "scatterplot3d",
"name": "scatterplot3d",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=scatterplot3d"
},
"SystemRequirements": null
},
"fileSize": "51936.238KB",
"citation": [
{
"@type": "SoftwareSourceCode",
"datePublished": "2024",
"author": [
{
"@type": "Person",
"givenName": "Giovanni",
"familyName": "Saraceno"
},
{
"@type": "Person",
"givenName": "Marianthi",
"familyName": "Markatou"
},
{
"@type": "Person",
"givenName": "Raktim",
"familyName": "Mukhopadhyay"
},
{
"@type": "Person",
"givenName": "Mojgan",
"familyName": "Golzy"
}
],
"name": "QuadratiK: Collection of Methods Constructed using Kernel-Based Quadratic Distances",
"url": "https://github.com/ropensci/QuadratiK",
"description": "Version 1.1.2"
},
{
"@type": "ScholarlyArticle",
"datePublished": "2024",
"author": [
{
"@type": "Person",
"givenName": "Marianthi",
"familyName": "Markatou"
},
{
"@type": "Person",
"givenName": "Giovanni",
"familyName": "Saraceno"
}
],
"name": "A Unified Framework for Multivariate Two- and k-Sample Kernel-based Quadratic Distance Goodness-of-Fit Tests",
"description": "https://doi.org/10.48550/arXiv.2407.16374",
"isPartOf": {
"@type": "PublicationIssue",
"datePublished": "2024",
"isPartOf": {
"@type": [
"PublicationVolume",
"Periodical"
],
"name": "arXiv preprint"
}
}
}
]
}GitHub Events
Total
- Issues event: 3
- Delete event: 1
- Issue comment event: 5
- Push event: 3
- Fork event: 1
- Create event: 1
Last Year
- Issues event: 3
- Delete event: 1
- Issue comment event: 5
- Push event: 3
- Fork event: 1
- Create event: 1
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 3
- Total pull requests: 0
- Average time to close issues: 6 months
- Average time to close pull requests: N/A
- Total issue authors: 2
- Total pull request authors: 0
- Average comments per issue: 28.33
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 2
- Bot pull requests: 0
Past Year
- Issues: 2
- Pull requests: 0
- Average time to close issues: about 2 hours
- Average time to close pull requests: N/A
- Issue authors: 2
- Pull request authors: 0
- Average comments per issue: 1.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 1
- Bot pull requests: 0
Top Authors
Issue Authors
- github-actions[bot] (1)
- jeroen (1)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Dependencies
- actions/checkout v4 composite
- r-lib/actions/check-r-package v2 composite
- r-lib/actions/setup-pandoc v2 composite
- r-lib/actions/setup-r v2 composite
- r-lib/actions/setup-r-dependencies v2 composite
- ropensci-review-tools/pkgcheck-action main composite
- JamesIves/github-pages-deploy-action v4.5.0 composite
- actions/checkout v4 composite
- r-lib/actions/setup-pandoc v2 composite
- r-lib/actions/setup-r v2 composite
- r-lib/actions/setup-r-dependencies v2 composite
- actions/checkout v4 composite
- r-lib/actions/pr-fetch v2 composite
- r-lib/actions/pr-push v2 composite
- r-lib/actions/setup-r v2 composite
- r-lib/actions/setup-r-dependencies v2 composite
- actions/checkout v4 composite
- actions/upload-artifact v4 composite
- r-lib/actions/setup-r v2 composite
- r-lib/actions/setup-r-dependencies v2 composite
- R >= 3.5.0 depends
- MASS * imports
- Rcpp * imports
- RcppEigen * imports
- Tinflex * imports
- cluster * imports
- clusterRepro * imports
- doParallel * imports
- foreach * imports
- ggplot2 * imports
- ggpp * imports
- ggpubr * imports
- mclust * imports
- methods * imports
- moments * imports
- movMF * imports
- mvtnorm * imports
- rgl * imports
- rlecuyer * imports
- rrcov * imports
- sn * imports
- stats * imports
- knitr * suggests
- rmarkdown * suggests
- roxygen2 * suggests
- testthat >= 3.0.0 suggests