{"id":29703348,"url":"https://github.com/severo/data-grid-cartograms","last_synced_at":"2026-02-04T09:46:35.718Z","repository":{"id":305048966,"uuid":"1020871744","full_name":"severo/data-grid-cartograms","owner":"severo","description":"A curated collection of grid cartograms","archived":false,"fork":false,"pushed_at":"2025-07-17T22:24:22.000Z","size":59,"stargazers_count":3,"open_issues_count":13,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-18T03:10:05.596Z","etag":null,"topics":["cartogram","collection","curated","data","dataviz","grid"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/severo.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":"2025-07-16T14:18:29.000Z","updated_at":"2025-07-17T22:24:26.000Z","dependencies_parsed_at":"2025-07-18T04:16:12.576Z","dependency_job_id":"e8435835-7870-46a9-95da-4e49da3ed398","html_url":"https://github.com/severo/data-grid-cartograms","commit_stats":null,"previous_names":["severo/data-grid-cartograms"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/severo/data-grid-cartograms","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/severo%2Fdata-grid-cartograms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/severo%2Fdata-grid-cartograms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/severo%2Fdata-grid-cartograms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/severo%2Fdata-grid-cartograms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/severo","download_url":"https://codeload.github.com/severo/data-grid-cartograms/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/severo%2Fdata-grid-cartograms/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266689758,"owners_count":23969145,"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-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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","collection","curated","data","dataviz","grid"],"created_at":"2025-07-23T13:39:06.258Z","updated_at":"2026-02-04T09:46:35.711Z","avatar_url":"https://github.com/severo.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# data-grid-cartograms\n\nA curated collection of grid cartograms, in a machine-readable format.\n\n\u003e A grid cartogram is a representation barely similar to a map, that distorts the forms and areas, and assigns to every subdivision one and only one unit of a grid. They are also referred as grid map, mosaic cartogram, pseudo-Demers cartogram, square cartograph maps, geofacets, geogrid, tile grid map, or tile map. For example, the following map represents every state of the United States by exactly one square in a rectangular grid:\n\n![Example of a grid cartogram, with one cell by state](./cartogram_us_example.png)\n\n## Structure of this collection\n\nThe collected grid cartograms are stored in a directory structure that follows the pattern:\n\n```\n.\n└── \u003ccategory\u003e\n    └── \u003cwhole\u003e\n        └── \u003cparts\u003e\n            └── \u003cname\u003e\n                ├── grid.csv\n                ├── ids.csv\n                └── README.md\n```\n\nWhere:\n\n- \u003ccategory\u003e is a broad category of the cartogram, such as \"continents\" or \"countries\".\n- \u003cwhole\u003e is the whole entity that the cartogram represents, such as \"us\", \"africa\", or \"world\".\n- \u003cparts\u003e is the parts that the whole is divided into, such as \"States\", \"Countries\", or \"Seats\".\n- \u003cname\u003e is the name of the cartogram\n- `grid.csv` contains the grid cartogram as ASCII art. A filled cell is represented by an identifier. For readability, all the identifiers should have the same length and an empty cell should be contain the same number of spaces. For countries or states, the identifier can be the ISO 3166-1 alpha-2 or alpha-3 code.\n- `ids.csv` contains the mapping between the identifiers in `grid.csv` and the actual names of the parts. The first column contains the identifier, and the second column contains the name. Additional columns can be added for metadata.\n- `README.md` contains a description of the cartogram, including the source, date, and any other relevant information.\n\nThe ASCII-art CSV is self-explaining, here is a grid cartogram of the world, by @clemsos:\n\n```csv\n   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   \n   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,ISL,   ,   ,   ,DNK,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   \n   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,NOR,SWE,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   \n   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,FIN,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   \n   ,   ,   ,CAN,   ,   ,   ,   ,   ,   ,   ,GBR,   ,   ,NLD,EST,LVA,LTU,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   \n   ,   ,   ,USA,   ,   ,   ,BHS,   ,   ,   ,IRL,   ,BEL,LUX,DEU,POL,CZE,BLR,SVK,RUS,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   \n   ,   ,MEX,   ,   ,   ,CUB,HTI,DOM,   ,   ,   ,FRA,CHE,LIE,AUT,BGR,HUN,MDA,UKR,UZB,KAZ,MNG,   ,   ,   ,   ,   ,   ,   ,   ,   \n   ,   ,GTM,BLZ,   ,   ,JAM,ATG,KNA,   ,   ,   ,AND,MCO,ITA,SVN,MNE,SRB,ROU,   ,ARM,TKM,KGZ,CHN,PRK,KOR,   ,JPN,   ,   ,   ,   \n   ,   ,   ,SLV,   ,   ,LCA,VCT,DMA,   ,   ,PRT,ESP,   ,SMR,HRV,MKD,BIH,CYP,TUR,GEO,AZE,TJK,NPL,BTN,   ,   ,   ,   ,   ,   ,   \n   ,   ,   ,HND,   ,   ,   ,   ,GRD,BRB,   ,   ,MLT,   ,   ,ALB,GRC,   ,   ,SYR,IRQ,IRN,AFG,PAK,BGD,MMR,THA,LAO,   ,   ,   ,   \n   ,   ,   ,NIC,CRI,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,LBN,KWT,   ,   ,IND,   ,   ,KHM,VNM,   ,   ,   ,   \n   ,   ,   ,   ,PAN,   ,   ,   ,   ,   ,   ,   ,   ,MAR,DZA,TUN,LBY,EGY,ISR,JOR,SAU,BHR,   ,   ,LKA,   ,MYS,   ,   ,   ,   ,   \n   ,   ,   ,ECU,COL,VEN,   ,   ,   ,   ,   ,   ,SEN,MRT,MLI,NER,TCD,SDN,ERI,   ,ARE,QAT,   ,MDV,   ,SGP,BRN,   ,PHL,   ,   ,   \n   ,   ,   ,PER,GUY,SUR,TTO,   ,   ,   ,   ,GMB,GIN,BFA,NGA,CAF,SSD,ETH,DJI,   ,YEM,OMN,   ,   ,   ,   ,IDN,PNG,   ,   ,   ,   \n   ,   ,   ,   ,BRA,   ,   ,   ,   ,   ,   ,   ,GNB,SLE,CIV,TGO,CMR,UGA,SOM,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   \n   ,   ,   ,   ,BOL,   ,   ,   ,   ,   ,   ,   ,LBR,GHA,BEN,COG,COD,KEN,   ,   ,   ,   ,   ,   ,TLS,   ,MHL,KIR,PLW,   ,   ,   \n   ,   ,   ,PRY,URY,   ,   ,   ,   ,   ,   ,   ,CPV,   ,STP,GNQ,RWA,TZA,   ,   ,   ,   ,   ,AUS,   ,   ,TUV,FSM,NRU,   ,   ,   \n   ,   ,   ,   ,ARG,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,GAB,BDI,MWI,   ,   ,COM,   ,   ,   ,NZL,   ,WSM,TON,   ,   ,   ,   \n   ,   ,   ,   ,CHL,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,AGO,ZMB,MOZ,   ,MDG,MUS,   ,   ,   ,   ,   ,FJI,SLB,VUT,   ,   ,   \n   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,NAM,BWA,ZWE,   ,   ,SYC,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   \n   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,ZAF,LSO,SWZ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   \n   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   ,   \n```\n\n## Contribute\n\nYou want to signal a grid cartogram should be added to the collection? Please open an [issue](https://github.com/severo/data-grid-cartograms/issues/new?template=propose-a-new-grid-cartogram.md) and paste the reference URL. We will then take care of transcribing it to the ASCII-art data format.\n\nYou want to add the data for a grid cartogram? Open a [pull request](https://github.com/severo/data-grid-cartograms/pulls) where you add a new directory to the collection. Take care of following the [structure](#structure-of-this-collection) and the formats of `grid.csv` and `ids.csv`. Also, please add a `README.md` file with a description of the cartogram, including the source, date, and any other relevant information. Finally, update the root `index.json` file to include the new cartogram.\n\nOther ideas? Open an issue or a pull request and let's discuss!\n\n## Explore the collection\n\nYou can browse all grid cartograms contributed so far in this [observable notebook](https://observablehq.com/@mauforonda/grid-cartogram-collection).\n\n## Read more on grid cartograms\n\nIn 2020, I wrote a [review about grid cartograms](https://observablehq.com/@severo/grid-cartograms) on Observable. It contains a good list of grid cartograms for countries, continents and the world, and I discussed the terms and the uses for such a chart.\n\nI also wrote some other notebooks around grid cartograms: utilities to load, convert and display the data, intents to automatically create grid cartograms, and tools to compare the accuracy of grid cartograms. You can check them ut in the [Grid cartograms Observable's collection](https://observablehq.com/collection/@severo/grid-maps).\n\n## Tools\n\nSome visualization and mapping tools that could work well with the grid cartograms in this repository:\n\n- https://eurostat.github.io/gridviz/: JavaScript library for visualizing gridded data\n- https://yanouski.com/work/graphing-belarus/tile-grid-map/process/: Making-of the tile grid map layout of Belarus, using d3-force.\n\nOpen a PR/issue to propose other tools!\n\n## Related projects\n\n- https://github.com/hafen/grid-designer/ / https://github.com/hafen/geofacet: Geo Grid Designer publishes dozens of grid cartograms in tidy CSV files.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsevero%2Fdata-grid-cartograms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsevero%2Fdata-grid-cartograms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsevero%2Fdata-grid-cartograms/lists"}