{"id":13571127,"url":"https://github.com/riatelab/mapsf","last_synced_at":"2025-04-09T06:12:03.411Z","repository":{"id":42064929,"uuid":"274923318","full_name":"riatelab/mapsf","owner":"riatelab","description":"Thematic cartography with R","archived":false,"fork":false,"pushed_at":"2025-03-25T16:58:46.000Z","size":138487,"stargazers_count":229,"open_issues_count":1,"forks_count":25,"subscribers_count":11,"default_branch":"dev","last_synced_at":"2025-04-02T04:07:23.992Z","etag":null,"topics":["cartography","map","r","r-package","rstats","spatial","spatial-analysis"],"latest_commit_sha":null,"homepage":"https://riatelab.github.io/mapsf/","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/riatelab.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":"codemeta.json"}},"created_at":"2020-06-25T13:28:50.000Z","updated_at":"2025-03-22T20:54:02.000Z","dependencies_parsed_at":"2023-10-03T17:01:47.712Z","dependency_job_id":"89f17b30-f556-4934-8f7b-c8db339368b1","html_url":"https://github.com/riatelab/mapsf","commit_stats":{"total_commits":323,"total_committers":5,"mean_commits":64.6,"dds":"0.018575851393188847","last_synced_commit":"4202728ef976ad1afbb6041b9555f1db9b5999ea"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riatelab%2Fmapsf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riatelab%2Fmapsf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riatelab%2Fmapsf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riatelab%2Fmapsf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/riatelab","download_url":"https://codeload.github.com/riatelab/mapsf/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247987285,"owners_count":21028895,"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":["cartography","map","r","r-package","rstats","spatial","spatial-analysis"],"created_at":"2024-08-01T14:00:58.953Z","updated_at":"2025-04-09T06:12:03.386Z","avatar_url":"https://github.com/riatelab.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/\",\n  fig.width = 5, fig.height = 6,\n  dev = \"png\"\n  # out.width = \"100%\"\n)\n```\n\n# mapsf \n\u003cimg src=\"man/figures/logo.png\" align=\"right\" width=\"120\"/\u003e\n\n\n\u003c!-- badges: start --\u003e\n\n[![CRAN](https://www.r-pkg.org/badges/version-ago/mapsf)](https://cran.r-project.org/package=mapsf)\n[![R-CMD-check](https://github.com/riatelab/mapsf/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/riatelab/mapsf/actions/workflows/R-CMD-check.yaml)\n[![downloads](https://cranlogs.r-pkg.org/badges/mapsf?color=brightgreen)](https://cran.r-project.org/package=mapsf)\n[![Codecov test coverage](https://codecov.io/gh/riatelab/mapsf/branch/master/graph/badge.svg)](https://app.codecov.io/gh/riatelab/mapsf?branch=master)\n[![status](https://tinyverse.netlify.app/badge/mapsf)](https://CRAN.R-project.org/package=mapsf)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/8704/badge)](https://www.bestpractices.dev/projects/8704)\n[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n\u003c!-- badges: end --\u003e\n\n\n**Create thematic maps and integrate them into your R workflow.**  \nThis package helps you design different cartographic representations such as\nproportional symbols, choropleths, or typology maps.   \nIt also provides several functions for displaying layout elements\nthat enhance the graphical presentation of maps \n(e.g., scale bar, north arrow, title, labels).   \n`mapsf` maps `sf` objects on `base` graphics.\n\n![[Cheat Sheet](https://raw.githubusercontent.com/riatelab/mapsf/master/vignettes/web_only/img/mapsf_cheatsheet.pdf) \u0026 [Web Site](https://riatelab.github.io/mapsf/)](man/figures/mapsf_cheatsheet.png)  \n\n\n## Installation\n\nYou can install the released version of `mapsf`\nfrom [CRAN](https://cran.r-project.org/package=mapsf) with:\n\n``` r\ninstall.packages(\"mapsf\")\n```\n\nAlternatively, you can install the development version of `mapsf` \nfrom GitHub (**dev** branch) with:\n\n``` r\nremotes::install_github(\"riatelab/mapsf\", ref = \"dev\")\n```\n\n\n## Usage\n\nThis is a basic example which shows how to create a map with `mapsf`.  \nThe main `mapsf` function is `mf_map()`. \n\n```{r example1, fig.width = 4, fig.height = 5}\nlibrary(mapsf)\n# Import the sample dataset\nmtq \u003c- mf_get_mtq()\n# Plot the base map\nmf_map(x = mtq)\n# Plot proportional symbols\nmf_map(x = mtq, var = \"POP\", type = \"prop\", leg_pos = \"topright\")\n# Plot a map layout\nmf_layout(\n  title = \"Population in Martinique\",\n  credits = \"T. Giraud; Sources: INSEE \u0026 IGN, 2018\"\n)\n```\n\n\nA more detailed example:\n\n```{r example2, results=\"hide\", eval = TRUE, fig.width=6, fig.height=5.87}\n# A map with a theme and extra margins\nmf_theme(\"sol_dark\")\n# Plot a choropleth map\nmf_map(\n  x = mtq, var = \"MED\", type = \"choro\",\n  breaks = \"quantile\", nbreaks = 6,\n  leg_title = \"Median Income\\n(euros)\", leg_val_rnd = -2,\n  expandBB = c(0, 0, 0, .3)\n)\n# Start an inset map\nmf_inset_on(x = \"worldmap\", pos = \"right\")\n# Plot mtq position on a worldmap\nmf_worldmap(mtq, col = \"#0E3F5C\")\n# Close the inset\nmf_inset_off()\n# Plot a title\nmf_title(\"Wealth in Martinique, 2015\")\n# Plot credits\nmf_credits(\"T. Giraud\\nSources: INSEE \u0026 IGN, 2018\")\n# Plot a scale bar\nmf_scale(size = 5)\n# Plot a north arrow\nmf_arrow(\"topleft\")\n```\n\n\n## Alternatives\n\n- [tmap](https://github.com/r-tmap/tmap)  \n- [ggplot2](https://github.com/tidyverse/ggplot2) + [ggspatial](https://github.com/paleolimbot/ggspatial)  \n\n## Community Guidelines\n\nOne can contribute to the package through [pull requests](https://github.com/riatelab/mapsf/pulls) and report issues or ask questions [here](https://github.com/riatelab/mapsf/issues). See the [CONTRIBUTING.md](https://github.com/riatelab/mapsf/blob/master/CONTRIBUTING.md) file for detailed instructions on how to contribute.   \nThis project uses [conventional commits](https://www.conventionalcommits.org/en/v1.0.0-beta.3/) and [semantic versioning](https://semver.org/).\n","funding_links":[],"categories":["Tools (by Language/ parent software)","R"],"sub_categories":["R"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friatelab%2Fmapsf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Friatelab%2Fmapsf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friatelab%2Fmapsf/lists"}