{"id":13423819,"url":"https://github.com/cpanse/recmap","last_synced_at":"2025-08-17T19:44:55.390Z","repository":{"id":52118230,"uuid":"56375894","full_name":"cpanse/recmap","owner":"cpanse","description":" draw rectangular statistical cartograms - CRAN package","archived":false,"fork":false,"pushed_at":"2025-08-02T10:00:17.000Z","size":21318,"stargazers_count":21,"open_issues_count":6,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-02T12:24:32.525Z","etag":null,"topics":["cartogram","cran-r","demographics","genetic-algorithm","geovisualization","graph-drawing","spatial","spatial-data-analysis","value-by-area-maps"],"latest_commit_sha":null,"homepage":"https://CRAN.R-project.org/package=recmap","language":"C++","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/cpanse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2016-04-16T09:31:35.000Z","updated_at":"2025-08-02T10:00:20.000Z","dependencies_parsed_at":"2023-12-15T21:18:04.521Z","dependency_job_id":"cfa5a071-8484-423c-8c72-995a55876ebd","html_url":"https://github.com/cpanse/recmap","commit_stats":{"total_commits":546,"total_committers":3,"mean_commits":182.0,"dds":0.4560439560439561,"last_synced_commit":"d827196ef471608971fdae586afd028cc33cc6c5"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/cpanse/recmap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cpanse%2Frecmap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cpanse%2Frecmap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cpanse%2Frecmap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cpanse%2Frecmap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cpanse","download_url":"https://codeload.github.com/cpanse/recmap/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cpanse%2Frecmap/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268391681,"owners_count":24243296,"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","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cartogram","cran-r","demographics","genetic-algorithm","geovisualization","graph-drawing","spatial","spatial-data-analysis","value-by-area-maps"],"created_at":"2024-07-31T00:00:43.192Z","updated_at":"2025-08-14T23:32:32.312Z","avatar_url":"https://github.com/cpanse.png","language":"C++","readme":"[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/recmap)](https://cran.r-project.org/package=recmap)\n[![Research software impact](http://depsy.org/api/package/cran/recmap/badge.svg)](http://depsy.org/package/r/recmap)\n[![](http://cranlogs.r-pkg.org/badges/grand-total/recmap)](https://cran.r-project.org/package=recmap)\n[![](http://cranlogs.r-pkg.org/badges/recmap)](https://cran.r-project.org/package=recmap) \n![](https://github.com/cpanse/recmap/workflows/R-CMD-check-recmap/badge.svg)\n[![JSS](https://img.shields.io/badge/JSS-10.18637%2Fjss.v086.c01-brightgreen)](http://dx.doi.org/10.18637/jss.v086.c01)\n[![codecov](https://codecov.io/github/cpanse/recmap/branch/master/graph/badge.svg?token=QbuhWl5bx5)](https://codecov.io/github/cpanse/recmap)\n\n# recmap - Compute the Rectangular Statistical Cartogram \n\nThis package implements the [RecMap construction algorithm (MP2)](http://dx.doi.org/10.1109/INFVIS.2004.57) using the [GA]( https://CRAN.R-project.org/package=GA) CRAN package as a metaheuristic.\n\n\n![rectangular population cartogram construction demo - animated gif](https://user-images.githubusercontent.com/4901987/64121133-3dfc9100-cd9e-11e9-8c35-078678966100.gif)\n\n## 1. Installation\n\nuse [CRAN](https://CRAN.R-project.org/package=recmap)\n\n`recmap` requires R 3.6 or later.\n\nReleased and tested versions of `recmap` are available via\n[CRAN](https://CRAN.R-project.org/package=recmap), \nand can be installed using the following code\n\n```{r}\ninstall.packages('recmap')\n```\n\nbefore running, `R CMD build` and `R CMD check` or running the shiny demo execute\n```{r}\npkgs \u003c- c('colorspace', 'doParallel', 'DT', 'knitr', 'maps',\n  'shiny', 'testthat', 'tufte')\npkgs \u003c- pkgs[(!pkgs %in% unique(installed.packages()[,'Package']))]\nif(length(pkgs) \u003e 0){install.packages(pkgs)}\n```\n\n## 2. Documentation\n\nThe package ships with a package \n[vignette](https://CRAN.R-project.org/package=recmap/vignettes/recmap.html)\n(`browseVignettes('recmap')`)\nand a reference manual (just type `?recmap` on the R shell).\nBoth documents are also available on the package's \n[CRAN](https://CRAN.R-project.org/package=recmap) page.\nA white paper containing more technical information and examples is\navailable through [jss.v086.c01](http://dx.doi.org/10.18637/jss.v086.c01).\n\n## 3. Demonstration\n\nRun an interactive shiny application\n\n```{r}\nlibrary(recmap)\nGA::gaControl(\"useRcpp\" = FALSE) # apple M1\nrecmap_shiny \u003c- system.file('shiny-examples', package = 'recmap')\nshiny::runApp(recmap_shiny, display.mode = 'normal')\n```\n\nTo run the recmap shiny demonstration as a stand-alone application\non Linux and macOS systems, use the Terminal application and add the following\ncode to your alias file, e.g., `$HOME/.bashrc`\n\n```\nalias recmapShiny=\"R -e \\\"library(shiny); \\\n  recmap_shiny \u003c- system.file('shiny-examples', package = 'recmap'); \\\n  shiny::runApp(recmap_shiny, display.mode = 'normal', launch.browser=TRUE)\\\"\"\n```\n\nexecute \n\n`. $HOME/.bashrc \u0026\u0026 recmapShiny` \n\n## 4. (Frequently) Asked Questions\n\n### 4.1 Is there an easy way to convert a `recmap` object to an [`sf`](https://CRAN.R-project.org/package=sf ) object?\n\n\nUse [`as.SpatialPolygonsDataFrame`](https://github.com/cpanse/recmap/blob/da2f90d2edb3feda7464bb543147d2908851e92b/R/recmap.R#L265),\nsee also issue [#13](https://github.com/cpanse/recmap/issues/13). \nThe `as.recmap` function performs the transformation from a\n`SpatialPolygonsDataFrame` into a `recmap` compatible object.\n\n## 5. Related approaches\n\n* [Rectangular Cartograms: the game](https://bspeckmann.win.tue.nl/demos/game/index.html), [Rectangular Cartograms](https://bspeckmann.win.tue.nl/Cartograms/SoccerCarto.html)\n* cartogram: Create Cartograms with R [https://CRAN.R-project.org/package=cartogram](https://CRAN.R-project.org/package=cartogram)\n* [Rcartogram](https://github.com/omegahat/Rcartogram)\n* [High-performance software to produce flow-based cartograms.](https://github.com/Flow-Based-Cartograms/go_cart) \n* see also [CRAN Task View: Analysis of Spatial Data](https://CRAN.R-project.org/view=Spatial)\n* Computing Stable Demers Cartograms - https://arxiv.org/abs/1908.07291\n* Wang, L., Yuan, H., Li, X., Lu, P., \u0026 Li, Y. (2025). A New Construction Method for Rectangular Cartograms. ISPRS International Journal of Geo-Information, 14(1), 25. [doi 10.3390/ijgi14010025](https://doi.org/10.3390/ijgi14010025)\n","funding_links":[],"categories":["C++"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcpanse%2Frecmap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcpanse%2Frecmap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcpanse%2Frecmap/lists"}