{"id":13857324,"url":"https://github.com/Nowosad/supercells","last_synced_at":"2025-07-13T21:32:18.997Z","repository":{"id":38755251,"uuid":"362034983","full_name":"Nowosad/supercells","owner":"Nowosad","description":"The goal of supercells is to utilize the concept of superpixels to a variety of spatial data. ","archived":false,"fork":false,"pushed_at":"2024-08-30T14:05:03.000Z","size":39498,"stargazers_count":66,"open_issues_count":14,"forks_count":5,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-21T20:51:33.588Z","etag":null,"topics":["r","r-package","rspatial","rstats","spatial"],"latest_commit_sha":null,"homepage":"https://jakubnowosad.com/supercells/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nowosad.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-27T08:19:18.000Z","updated_at":"2024-09-29T15:09:21.000Z","dependencies_parsed_at":"2023-02-16T19:00:32.149Z","dependency_job_id":"9065cf85-0bc0-47e6-ad2f-292b03d1f909","html_url":"https://github.com/Nowosad/supercells","commit_stats":{"total_commits":243,"total_committers":2,"mean_commits":121.5,"dds":0.004115226337448541,"last_synced_commit":"0e32e3459dbee30976c19fcc99c82e193524810a"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nowosad%2Fsupercells","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nowosad%2Fsupercells/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nowosad%2Fsupercells/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nowosad%2Fsupercells/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nowosad","download_url":"https://codeload.github.com/Nowosad/supercells/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225920278,"owners_count":17545463,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["r","r-package","rspatial","rstats","spatial"],"created_at":"2024-08-05T03:01:33.440Z","updated_at":"2024-11-22T15:30:30.995Z","avatar_url":"https://github.com/Nowosad.png","language":"R","readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\",\n  out.width = \"100%\"\n)\n```\n\n# supercells \u003cimg src=\"man/figures/logo.png\" align=\"right\" width=\"150\" /\u003e\n\n\u003c!-- badges: start --\u003e\n[![CRAN status](https://www.r-pkg.org/badges/version/supercells)](https://CRAN.R-project.org/package=supercells)\n[![R-CMD-check](https://github.com/Nowosad/supercells/workflows/pkgdown/badge.svg)](https://github.com/Nowosad/supercells/actions)\n[![Codecov test coverage](https://codecov.io/gh/Nowosad/supercells/branch/master/graph/badge.svg)](https://app.codecov.io/gh/Nowosad/supercells?branch=master)\n[![CRAN RStudio mirror downloads](http://cranlogs.r-pkg.org/badges/supercells)](https://cran.r-project.org/package=supercells)\n\u003c!-- badges: end --\u003e\n\nThe goal of **supercells** is to utilize the concept of superpixels to a variety of spatial data. \nThis package works on spatial data with one variable (e.g., continuous raster), many variables (e.g., RGB rasters), and spatial patterns (e.g., areas in categorical rasters).\nIt is based on the SLIC algorithm (Achanta et al. (2012)), and readapts it to work with arbitrary dissimilarity measures. \n\n## Installation\n\nYou can install the released version of supercells from [CRAN](https://CRAN.R-project.org) with:\n\n``` r\ninstall.packages(\"supercells\")\n```\n\nYou can install the development version from [GitHub](https://github.com/) with:\n\n``` r\ninstall.packages(\"supercells\", repos = \"https://nowosad.r-universe.dev\")\n```\n\n\u003c!-- ``` r --\u003e\n\u003c!-- # install.packages(\"remotes\") --\u003e\n\u003c!-- remotes::install_github(\"Nowosad/supercells\") --\u003e\n\u003c!-- ``` --\u003e\n\n## Example\n\n```{r}\nlibrary(supercells)\nlibrary(terra)\nlibrary(sf)\nvol = rast(system.file(\"raster/volcano.tif\", package = \"supercells\"))\nplot(vol)\n```\n\n```{r, results='hide'}\nvol_slic1 = supercells(vol, k = 50, compactness = 1)\nplot(vol)\nplot(st_geometry(vol_slic1), add = TRUE, lwd = 0.2)\n```\n\n## Documentation\n\nSee the package's vignettes:\n\n1. [The `supercells()` function](https://jakubnowosad.com/supercells/articles/main-function.html)\n2. [Superpixels of a single raster layer](https://jakubnowosad.com/supercells/articles/articles/one_var.html)\n3. [Superpixels of an RGB raster](https://jakubnowosad.com/supercells/articles/articles/rgb_vars.html)\n4. [Superpixels of spatial categorical patterns](https://jakubnowosad.com/supercells/articles/articles/motifels.html)\n5. [Experimental features of the supercells package](https://jakubnowosad.com/supercells/articles/articles/experimental.html)\n\nWatch the presentations about this package and some related ideas:\n\n1. *Spatial segmentation in R using the supercells package*, 2021-09-02, OpenGeoHub Summer School - [slides](https://jakubnowosad.com/ogh2021/), [video](https://doi.org/10.5446/54880)\n2. *Generalizing the Simple Linear Iterative Clustering (SLIC) superpixels*, 2021-09-28, GIScience 2021 - [slides](https://jakubnowosad.com/giscience-2021/), [video](https://www.youtube.com/watch?v=AlyEFkyKLUw\u0026t=2018s)\n\nRead the related article:\n\n1. Nowosad, J., Stepinski, T. (2022). Extended SLIC superpixels algorithm for applications to non-imagery geospatial rasters. International Journal of Applied Earth Observation and Geoinformation, https://doi.org/10.1016/j.jag.2022.102935\n\n## Contribution\n\nContributions to this package are welcome - let us know if you need other distance measures or transformations, have any suggestions, or spotted a bug. \nThe preferred method of contribution is through a GitHub pull request. \nFeel also free to contact us by creating [an issue](https://github.com/nowosad/supercells/issues).\n","funding_links":[],"categories":["R"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNowosad%2Fsupercells","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNowosad%2Fsupercells","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNowosad%2Fsupercells/lists"}