{"_id":"@d3ts/us-atlas","_rev":"1-cc467b815271096621bb9bf5a65f9b4b","name":"@d3ts/us-atlas","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@d3ts/us-atlas","version":"1.0.0","description":"Pre-built TopoJSON from the U.S. Census Bureau, including Insular Areas.","license":"ISC","keywords":["topojson","geojson","shapefile"],"author":{"name":"Brendan Ratter","url":"https://github.com/bratter"},"repository":{"type":"git","url":"https://github.com/bratter/us-atlas.git"},"scripts":{"postpublish":"git push && git push --tags"},"devDependencies":{"d3-dsv":"^1.0.3","d3-geo-projection":"^2.0.0","ndjson-cli":"^0.3.0","shapefile":"^0.6.1","topojson-client":"^3.0.0","topojson-server":"^3.0.0","topojson-simplify":"^3.0.0"},"dependencies":{"@d3ts/us-map":"^0.2.0"},"licenseText":"Copyright 2019 Brendan Ratter\n\nPermission to use, copy, modify, and/or distribute this software for any purpose\nwith or without fee is hereby granted, provided that the above copyright notice\nand this permission notice appear in all copies.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND\nFITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS\nOF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER\nTORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF\nTHIS SOFTWARE.\n\n\n---- ORIGINAL LICENSE -----\n\n\nCopyright 2013-2019 Michael Bostock\n\nPermission to use, copy, modify, and/or distribute this software for any purpose\nwith or without fee is hereby granted, provided that the above copyright notice\nand this permission notice appear in all copies.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND\nFITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS\nOF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER\nTORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF\nTHIS SOFTWARE.\n","_id":"@d3ts/us-atlas@1.0.0","dist":{"shasum":"d53caf1c4c269ac5ef37bbfb8c1b72f4db27f6af","tarball":"https://registry.npmjs.org/@d3ts/us-atlas/-/us-atlas-1.0.0.tgz","integrity":"sha512-TrlZz07H5OvcHnQ/eVonED2nKfl4qpSeN0SzSa4Vcfk6wKL4fgnvUeBUz7wN5pGzkDUJrOzrg8tbVXM+TM2KkQ==","fileCount":11,"unpackedSize":2046468,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe5vZECRA9TVsSAnZWagAApCwP/RGXAJUSk3NjWYF7PryX\nxQKILyfawkirSGASXom/rd6Zs4WJX3ow1zvKhf99kYfP6GtD2qcVDK7zOtX5\nY63iw4nwVs4Win+OlpOp/6vDuF3yuEN7KfC0FcmIOF9XTw9GiLEcTAakydBe\n2C+vSLfbNH1P3dab0W5lUg3fln3N8Cp+Rlpf554Avz2+e1P7JNjbpfShxLJg\nxhlFgXWkWZWAtjlaHpFzSNDKEIw4ryf1X9+QoSP0V60M1VndSTusLUB+6xHq\n2vcshSDVgLX+ZeTaean1fqjQzREf/qP3/cBhMKA1wZ2bDs0DAycj7XcdMM5r\nzXuU062caY6IpPum1JlBNaE0w6Hamrb8/mMGGa9Clrqfio/aFsswJhVIAXHw\nRHXFWW+VP9yxSAdczatLfpEW2oABMOm8+hbkAhKyTANIllIAfP/pU1O7uZ/Y\ng6UejldL9l61FEDDEH/Ja8asrTO4nztU41UYUanvaOV0b3SUEgrgiPCmC9dl\n/hfPF2H1C1jevsQXA5rB+6LhO0vp8nSdHbSNYQw2AS3PTL31fto4ScIAZ3Ck\nQepgYqmK8ACm7HtnT31NIaD6Np9+xftDst3cDbofvmJZWflrC9AUjcgcirCw\noBcUsPLmI+Tzr8p0YdCM66fEP/2WM+dv9zIXSbLTGC02vB7Bph5FhMuGAbrA\nn3/T\r\n=FxbN\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDT+QHxixNSLl6ZJBqWVlVSEp/A7f9JHveJ4gpMRoHY0gIhAI4w1Ccnyt8Xn6yGEXrCJBjbtsiWaVa+JT6BKt9O77B/"}]},"maintainers":[{"name":"bratter","email":"email@brendanratter.net"}],"_npmUser":{"name":"bratter","email":"email@brendanratter.net"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/us-atlas_1.0.0_1592194627468_0.5471407806570034"},"_hasShrinkwrap":false}},"time":{"created":"2020-06-15T04:17:07.202Z","1.0.0":"2020-06-15T04:17:07.678Z","modified":"2022-04-05T02:30:59.025Z"},"maintainers":[{"name":"bratter","email":"email@brendanratter.net"}],"description":"Pre-built TopoJSON from the U.S. Census Bureau, including Insular Areas.","keywords":["topojson","geojson","shapefile"],"repository":{"type":"git","url":"https://github.com/bratter/us-atlas.git"},"author":{"name":"Brendan Ratter","url":"https://github.com/bratter"},"license":"ISC","readme":"# US Atlas TopoJSON\n\nThis repository is a fork of [TopoJSON's US Atlas](https://github.com/topojson/us-atlas). As with the TopoJSON repository, it provides a convenient redistribution of the [Census Bureau’s](http://www.census.gov/) [cartographic boundary shapefiles](https://www.census.gov/geo/maps-data/data/tiger-cart-boundary.html) as TopoJSON. The current release uses the 2019 edition shapefiles. Both projected and unprojected geometries are included. The projection used by these files is:\n\n```js\nd3ts.usMapProjection();\n```\n\nThe base projection uses [d3.**geoAlbersUsa**()](https://github.com/d3/d3-geo#geoAlbersUsa), but designed to fit a 1024×576 widescreen viewport, rather than d3's default 1024×576. Additionally, the projected and unprojected files includes objects for all states and insular areas, including Alaska and Hawaii, plus Puerto Rico, US Virgin Islands, American Samoa, Guam, and the Northern Mariana Islands &ndash; insular areas are not present in d3's version. Detailed documentation for the projection is available [here](https://github.com/bratter/us-map#projection).\n\nFinally, this distribution ships with an additional topojson file with convenient outlines for each of the inset areas (only available as a projected file), plus some addiitonal state metadata for labelling. \n\nDetails on all included files can be found in the [file reference](#file-reference) section below.\n\n### Usage\n\nThese files were designed for use with d3ts [US Map tools](https://github.com/bratter/us-map#projection). For a browser example see:<br>\nhttps://observablehq.com/@bratter/us-map.\n\nIt can also be used as a drop-in replacement for TopoJSON's US Atlas, so all the examples work as expected:\n\nIn a browser, using [d3-geo](https://github.com/d3/d3-geo) and SVG:<br>\nhttps://observablehq.com/@d3/u-s-map\n\nIn a browser, using [d3-geo](https://github.com/d3/d3-geo) and Canvas:<br>\nhttps://observablehq.com/@d3/u-s-map-canvas\n\nIn Node, using [d3-geo](https://github.com/d3/d3-geo) and [node-canvas](https://github.com/Automattic/node-canvas):<br>\nhttps://bl.ocks.org/mbostock/885fffe88d72b2a25c090e0bbbef382f\n\n## File Reference\n\n<a href=\"#counties-10m.json\" name=\"counties-10m.json\">#</a> <b>counties-10m.json</b> · [Download](https://cdn.jsdelivr.net/npm/@d3ts/us-atlas@1/counties-10m.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections <i>counties</i>, <i>states</i>, and <i>nation</i>. The geometry is quantized and simplified, but not projected. This topology is derived from the Census Bureau’s [cartographic county boundaries, 2019 edition](https://www2.census.gov/geo/tiger/GENZ2019/shp/). The state boundaries are computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) counties, and the nation boundary is computed by merging states, ensuring a consistent topology.\n\n<a href=\"#counties-albers-10m.json\" name=\"counties-albers-10m.json\">#</a> <b>counties-albers-10m.json</b> · [Download](https://cdn.jsdelivr.net/npm/@d3ts/us-atlas@1/counties-albers-10m.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections <i>counties</i>, <i>states</i>, and <i>nation</i>. The geometry is quantized, projected using [d3ts.usMapProjection](https://github.com/bratter/us-map/blob/master/README.md#projection) to fit a 1024×576 viewport, and simplified. This topology is derived from the Census Bureau’s [cartographic county boundaries, 2019 edition](https://www2.census.gov/geo/tiger/GENZ2019/shp/). The state boundaries are computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) counties, and the nation boundary is computed by merging states, ensuring a consistent topology.\n\n<a href=\"#states-10m.json\" name=\"states-10m.json\">#</a> <b>states-10m.json</b> · [Download](https://cdn.jsdelivr.net/npm/@d3ts/us-atlas@1/states-10m.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections <i>states</i> and <i>nation</i>. The geometry is quantized and simplified, but not projected. This topology is derived from the Census Bureau’s [cartographic state boundaries, 2019 edition](https://www2.census.gov/geo/tiger/GENZ2019/shp/). The nation boundary is computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) states, ensuring a consistent topology.\n\n<a href=\"#states-albers-10m.json\" name=\"states-albers-10m.json\">#</a> <b>states-albers-10m.json</b> · [Download](https://cdn.jsdelivr.net/npm/@d3ts/us-atlas@1/states-albers-10m.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collections <i>states</i> and <i>nation</i>. The geometry is quantized, projected using [d3ts.usMapProjection](https://github.com/bratter/us-map/blob/master/README.md#projection) to fit a 1024×576 viewport, and simplified. This topology is derived from the Census Bureau’s [cartographic state boundaries, 2019 edition](https://www2.census.gov/geo/tiger/GENZ2019/shp/). The nation boundary is computed by [merging](https://github.com/topojson/topojson-client/blob/master/README.md#merge) states, ensuring a consistent topology.\n\n<a href=\"#nation-10m.json\" name=\"nation-10m.json\">#</a> <b>nation-10m.json</b> · [Download](https://cdn.jsdelivr.net/npm/@d3ts/us-atlas@1/nation-10m.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collection <i>nation</i>. The geometry is quantized and simplified, but not projected. This topology is derived from the Census Bureau’s [cartographic nation boundary, 2019 edition](https://www2.census.gov/geo/tiger/GENZ2019/shp/).\n\n<a href=\"#nation-albers-10m.json\" name=\"nation-albers-10m.json\">#</a> <b>nation-albers-10m.json</b> · [Download](https://cdn.jsdelivr.net/npm/@d3ts/us-atlas@1/nation-albers-10m.json \"Source\")\n\nA [TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collection <i>nation</i>. The geometry is quantized, projected using [d3ts.usMapProjection](https://github.com/bratter/us-map/blob/master/README.md#projection) to fit a 1024×576 viewport, and simplified. This topology is derived from the Census Bureau’s [cartographic nation boundary, 2019 edition](https://www2.census.gov/geo/tiger/GENZ2019/shp/).\n\n<a href=\"#outlines-albers-10m.json\" name=\"outlines-albers-10m.json\">#</a> <b>outlines-albers-10m.json</b> · [Download](https://cdn.jsdelivr.net/npm/@d3ts/us-atlas@1/outlines-albers-10m.json \"Source\")\n\n[TopoJSON file](https://github.com/topojson/topojson-specification/blob/master/README.md#21-topology-objects) containing the geometry collection <i>outlines</i>. The geometry is quantized and projected using [d3ts.usMapProjection](https://github.com/bratter/us-map/blob/master/README.md#projection) to fit a 1024×576 viewport. This collection provide convenient outlines for each of the five insets for AK, HI and the insular areas. There are five outline geometries with the following string ids:\n\n* `\"02\"` - Alaska\n* `\"15\"` - Hawaii\n* `\"60\"` - American Samoa\n* `\"66,69\"` - Guam and the Northern Mariana Islands\n* `\"72,78\"` - Puerto Rico and the US Virgin Islands\n\nNote that the last two insets cover two entities each PR/VI and GU/MP respectively. Geometries can be filtered using the id, or the four attached properties:\n\n* *outline*.properties.name - the name, shown above\n* *outline*.properties.fips - array of two-digit FIPS codes as strings, similar to the ids above, but split into an array\n* *outline*.properties.codes - array of two-digit state lstter codes, such as `[\"AK\"]`\n* *outline*.properties.type - the type of entity covered by the outline, can be `\"state\"`, or `\"insular area\"`\n\nThe suggested use for this file is to filter for the desired insets and mesh using [TopoJSON's mesh](https://github.com/topojson/topojson-client/blob/master/README.md#mesh):\n\n```js\nconst mesh = topojson.mesh(outlines, outlines.objects.outlines);\nconst path = d3.geoPath()(mesh);\n```\n\n<a href=\"#state-metadata.json\" name=\"state-metadata.json\">#</a> <b>state-metadata.json</b> · [Download](https://cdn.jsdelivr.net/npm/@d3ts/us-atlas@1/state-metadata.json \"Source\")\n\nA JSON file containing some simple metadata for US States and Insular Areas. One entry is provided for each of the 50 States, Washington DC, 6 Insular Areas, and 3 Freely Associated States. Note that the projections above do not include the Freely Associated States or the US Minor Outlying Islands, but they are included here. Keys provided are:\n\n* *entity*.id - the two-digit FIPS code for the entity, such as `\"06\"`\n* *entity*.name - the official name for the entity, such as `\"California\"`\n* *entity*.code - the two alphabetical code for the entity, such as `\"CA\"`\n* *entity*.abbrev - the AP abbreviation for the entity, such as `\"Calif.\"`\n* *entity*.type - the legal status of the entity, such as `\"state\"`\n\nThis data is used to generate properties in the TopoJSON files, but provided separately for convenience.\n\n<a href=\"#counties\" name=\"counties\">#</a> *us*.objects.<b>counties</b>\n\n<img src=\"https://raw.githubusercontent.com/bratter/us-atlas/master/img/counties.png\" width=\"512\" height=\"288\">\n\nEach county has three fields:\n\n* *county*.id - the five-digit [FIPS county code](https://en.wikipedia.org/wiki/FIPS_county_code), such as `\"06069\"`\n* *county*.properties.name - the county name, such as `\"San Benito\"`\n* *county*.properties.state - the two-letter state code, such as `\"CA\"`\n\nThe first two digits of the county FIPS code is the state FIPS code.\n\n<a href=\"#states\" name=\"states\">#</a> *us*.objects.<b>states</b>\n\n<img src=\"https://raw.githubusercontent.com/bratter/us-atlas/master/img/states.png\" width=\"512\" height=\"288\">\n\nEach state has five fields:\n\n* *state*.id - the two-digit [FIPS state code](https://en.wikipedia.org/wiki/Federal_Information_Processing_Standard_state_code), such as `\"06\"`\n* *state*.properties.name - the state name, such as `\"California\"`\n* *state*.properties.code - the state's two-letter identifier, such as `\"CA\"`\n* *state*.properties.abbrev - the state's AP abbreviation, such as `\"Calif.\"`\n* *state*.properties.type - the legal type of the entity, such as `\"state\"`, DC is noted as `\"federal district\"`, and `\"insular areas\"` are also provided\n\n<a href=\"#nation\" name=\"nation\">#</a> *us*.objects.<b>nation</b>\n\n<img src=\"https://raw.githubusercontent.com/bratter/us-atlas/master/img/nation.png\" width=\"512\" height=\"288\">\n\nThe nation has two fields:\n\n* *nation*.id - the string `\"US\"`\n* *nation*.properties.name - the string `\"United States\"`\n","readmeFilename":"README.md"}