https://github.com/juliaearth/geoartifacts.jl
Artifacts (e.g., datasets) for Geospatial Data Science
https://github.com/juliaearth/geoartifacts.jl
artifacts data geospatial
Last synced: 2 months ago
JSON representation
Artifacts (e.g., datasets) for Geospatial Data Science
- Host: GitHub
- URL: https://github.com/juliaearth/geoartifacts.jl
- Owner: JuliaEarth
- License: mit
- Created: 2023-10-06T16:46:50.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-04-09T01:02:34.000Z (3 months ago)
- Last Synced: 2026-04-09T02:35:21.779Z (2 months ago)
- Topics: artifacts, data, geospatial
- Language: Julia
- Homepage: https://github.com/JuliaEarth/GeoStats.jl
- Size: 113 KB
- Stars: 5
- Watchers: 1
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GeoArtifacts.jl
[![][build-img]][build-url] [![][codecov-img]][codecov-url]
GeoArtifacts.jl provides geospatial artifacts (e.g., datasets) from different sources
in a universal representation described in the book
[*Geospatial Data Science with Julia*](https://juliaearth.github.io/geospatial-data-science-with-julia).
## Usage
The package is organized in different submodules, which encapsulate the artifacts.
Downloads are performed in the host machine upon demand, during the first call to
functions of a submodule. Please check the docstring of each submodule for more
information.
### Artifacts
#### [GADM](https://gadm.org)
```
help?> GADM
Provides functions to (down)load data from the GADM database.
Please check the docstring of each function for more details:
• GADM.get
• GADM.codes
julia> GADM.get("BRA", depth=1)
27×12 GeoTable over 27 GeometrySet
┌─────────────┬─────────────┬─────────────┬────────────────────┬──────────────────────┬─────────────┬──────────────────┬──────────────────┬─────────────┬─────────────┬───────
│ GID_1 │ GID_0 │ COUNTRY │ NAME_1 │ VARNAME_1 │ NL_NAME_1 │ TYPE_1 │ ENGTYPE_1 │ CC_1 │ HASC_1 │ I ⋯
│ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Cate ⋯
│ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [No ⋯
├─────────────┼─────────────┼─────────────┼────────────────────┼──────────────────────┼─────────────┼──────────────────┼──────────────────┼─────────────┼─────────────┼───────
│ BRA.1_1 │ BRA │ Brazil │ Acre │ NA │ NA │ Estado │ State │ NA │ BR.AC │ B ⋯
│ BRA.2_1 │ BRA │ Brazil │ Alagoas │ NA │ NA │ Estado │ State │ NA │ BR.AL │ B ⋯
│ BRA.3_1 │ BRA │ Brazil │ Amapá │ NA │ NA │ Estado │ State │ NA │ BR.AP │ ⋯
│ BRA.4_1 │ BRA │ Brazil │ Amazonas │ Amazone │ NA │ Estado │ State │ NA │ BR.AM │ B ⋯
│ BRA.5_1 │ BRA │ Brazil │ Bahia │ Ba¡a │ NA │ Estado │ State │ NA │ BR.BA │ B ⋯
│ BRA.6_1 │ BRA │ Brazil │ Ceará │ NA │ NA │ Estado │ State │ NA │ BR.CE │ ⋯
│ BRA.7_1 │ BRA │ Brazil │ Distrito Federal │ NA │ NA │ Distrito Federal │ Federal District │ NA │ BR.DF │ B ⋯
│ BRA.8_1 │ BRA │ Brazil │ Espírito Santo │ Espiritu Santo │ NA │ Estado │ State │ NA │ BR.ES │ ⋯
│ BRA.9_1 │ BRA │ Brazil │ Goiás │ Goiáz|Goyáz │ NA │ Estado │ State │ NA │ BR.GO │ ⋯
│ BRA.10_1 │ BRA │ Brazil │ Maranhão │ São Luíz de Maranhão │ NA │ Estado │ State │ NA │ BR.MA │ ⋯
│ BRA.12_1 │ BRA │ Brazil │ Mato Grosso │ Matto Grosso │ NA │ Estado │ State │ NA │ BR.MT │ B ⋯
│ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋱
└─────────────┴─────────────┴─────────────┴────────────────────┴──────────────────────┴─────────────┴──────────────────┴──────────────────┴─────────────┴─────────────┴───────
2 columns and 16 rows omitted
```
#### [NaturalEarth](https://www.naturalearthdata.com)
```
help?> NaturalEarth
Provides functions to (down)load data from the Natural Earth database.
Please check the docstring of each function for more details:
• NaturalEarth.countries
• NaturalEarth.borders
• NaturalEarth.states
• NaturalEarth.counties
• NaturalEarth.populatedplaces
• NaturalEarth.roads
• NaturalEarth.railroads
• NaturalEarth.airports
• NaturalEarth.ports
• NaturalEarth.urbanareas
• NaturalEarth.usparks
• NaturalEarth.timezones
• NaturalEarth.coastlines
• NaturalEarth.lands
• NaturalEarth.minorislands
• NaturalEarth.reefs
• NaturalEarth.oceans
• NaturalEarth.rivers
• NaturalEarth.lakes
• NaturalEarth.physicallabels
• NaturalEarth.playas
• NaturalEarth.glaciatedareas
• NaturalEarth.iceshelves
• NaturalEarth.bathymetry
• NaturalEarth.geographiclines
• NaturalEarth.graticules
• NaturalEarth.hypsometrictints
• NaturalEarth.naturalearth1
• NaturalEarth.naturalearth2
• NaturalEarth.oceanbottom
• NaturalEarth.shadedrelief
• NaturalEarth.grayearth
• NaturalEarth.usmanualshadedrelief
• NaturalEarth.manualshadedrelief
• NaturalEarth.prismashadedrelief
julia> NaturalEarth.countries()
258×169 GeoTable over 258 GeometrySet
┌─────────────────┬─────────────┬─────────────┬────────────────┬─────────────┬─────────────┬─────────────┬───────────────────┬─────────────┬──────────────────────────────┬───
│ featurecla │ scalerank │ LABELRANK │ SOVEREIGNT │ SOV_A3 │ ADM0_DIF │ LEVEL │ TYPE │ TLC │ ADMIN │ ⋯
│ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ Categorical │ ⋯
│ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ ⋯
├─────────────────┼─────────────┼─────────────┼────────────────┼─────────────┼─────────────┼─────────────┼───────────────────┼─────────────┼──────────────────────────────┼───
│ Admin-0 country │ 0 │ 2 │ Indonesia │ IDN │ 0 │ 2 │ Sovereign country │ 1 │ Indonesia │ ⋯
│ Admin-0 country │ 0 │ 3 │ Malaysia │ MYS │ 0 │ 2 │ Sovereign country │ 1 │ Malaysia │ ⋯
│ Admin-0 country │ 0 │ 2 │ Chile │ CHL │ 0 │ 2 │ Sovereign country │ 1 │ Chile │ ⋯
│ Admin-0 country │ 0 │ 3 │ Bolivia │ BOL │ 0 │ 2 │ Sovereign country │ 1 │ Bolivia │ ⋯
│ Admin-0 country │ 0 │ 2 │ Peru │ PER │ 0 │ 2 │ Sovereign country │ 1 │ Peru │ ⋯
│ Admin-0 country │ 0 │ 2 │ Argentina │ ARG │ 0 │ 2 │ Sovereign country │ 1 │ Argentina │ ⋯
│ Admin-0 country │ 3 │ 3 │ United Kingdom │ GB1 │ 1 │ 2 │ Dependency │ 1 │ Dhekelia Sovereign Base Area │ ⋯
│ Admin-0 country │ 1 │ 5 │ Cyprus │ CYP │ 0 │ 2 │ Sovereign country │ 1 │ Cyprus │ ⋯
│ Admin-0 country │ 0 │ 2 │ India │ IND │ 0 │ 2 │ Sovereign country │ 1 │ India │ ⋯
│ Admin-0 country │ 0 │ 2 │ China │ CH1 │ 1 │ 2 │ Country │ 1 │ China │ ⋯
│ Admin-0 country │ 0 │ 4 │ Israel │ IS1 │ 1 │ 2 │ Disputed │ 1 │ Israel │ ⋯
│ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋮ │ ⋱
└─────────────────┴─────────────┴─────────────┴────────────────┴─────────────┴─────────────┴─────────────┴───────────────────┴─────────────┴──────────────────────────────┴───
159 columns and 247 rows omitted
julia> NaturalEarth.coastlines()
4133×4 GeoTable over 4133 GeometrySet
┌─────────────┬─────────────┬────────────┬───────────────────────────────┐
│ featurecla │ scalerank │ min_zoom │ geometry │
│ Categorical │ Categorical │ Continuous │ Multi │
│ [NoUnits] │ [NoUnits] │ [NoUnits] │ 🖈 GeodeticLatLon{WGS84Latest} │
├─────────────┼─────────────┼────────────┼───────────────────────────────┤
│ Coastline │ 0 │ 0.0 │ Multi(1×Rope) │
│ Coastline │ 0 │ 0.0 │ Multi(1×Rope) │
│ Coastline │ 6 │ 5.0 │ Multi(1×Ring) │
│ Coastline │ 0 │ 0.0 │ Multi(1×Rope) │
│ Coastline │ 0 │ 0.0 │ Multi(1×Rope) │
│ Coastline │ 6 │ 5.0 │ Multi(1×Ring) │
│ Coastline │ 5 │ 3.0 │ Multi(1×Ring) │
│ Coastline │ 5 │ 3.0 │ Multi(1×Ring) │
│ Coastline │ 6 │ 6.0 │ Multi(1×Ring) │
│ Coastline │ 6 │ 5.0 │ Multi(1×Ring) │
│ Coastline │ 6 │ 5.0 │ Multi(1×Ring) │
│ ⋮ │ ⋮ │ ⋮ │ ⋮ │
└─────────────┴─────────────┴────────────┴───────────────────────────────┘
4122 rows omitted
```
#### [GeoBR](https://ipeagit.github.io/geobr)
```
help?> GeoBR
Provides functions to (down)load data from the GeoBR database.
Please check the docstring of each function for more details:
• GeoBR.state
• GeoBR.municipality
• GeoBR.region
• GeoBR.country
• GeoBR.amazon
• GeoBR.biomes
• GeoBR.disasterriskarea
• GeoBR.healthfacilities
• GeoBR.indigenousland
• GeoBR.metroarea
• GeoBR.neighborhood
• GeoBR.urbanarea
• GeoBR.weightingarea
• GeoBR.mesoregion
• GeoBR.microregion
• GeoBR.intermediateregion
• GeoBR.immediateregion
• GeoBR.municipalseat
• GeoBR.censustract
• GeoBR.statisticalgrid
• GeoBR.conservationunits
• GeoBR.semiarid
• GeoBR.schools
• GeoBR.comparableareas
• GeoBR.urbanconcentrations
• GeoBR.poparrangements
• GeoBR.healthregion
julia> GeoBR.state()
29×2 GeoTable over 29 GeometrySet
┌───────────────────────────────────────────────┬──────────────────────────────┐
│ name_state │ geometry │
│ Categorical │ MultiPolygon │
│ [NoUnits] │ 🖈 GeodeticLatLon{SIRGAS2000} │
├───────────────────────────────────────────────┼──────────────────────────────┤
│ Acre │ Multi(1×PolyArea) │
│ Alagoas │ Multi(1×PolyArea) │
│ Amapá │ Multi(1×PolyArea) │
│ Amazonas │ Multi(1×PolyArea) │
│ Bahia │ Multi(10×PolyArea) │
│ Ceará │ Multi(1×PolyArea) │
│ Distrito estadual de Fernando de Noronha (PE) │ Multi(1×PolyArea) │
│ Distrito Federal │ Multi(1×PolyArea) │
│ Espírito Santo │ Multi(8×PolyArea) │
│ Goiás │ Multi(1×PolyArea) │
│ Litígio PI/CE │ Multi(3×PolyArea) │
│ Maranhão │ Multi(51×PolyArea) │
│ Mato Grosso │ Multi(1×PolyArea) │
│ Mato Grosso do Sul │ Multi(1×PolyArea) │
│ Minas Gerais │ Multi(1×PolyArea) │
│ Pará │ Multi(17×PolyArea) │
│ Paraíba │ Multi(2×PolyArea) │
│ Paraná │ Multi(1×PolyArea) │
│ Pernambuco │ Multi(1×PolyArea) │
│ Piauí │ Multi(1×PolyArea) │
│ Rio de Janeiro │ Multi(82×PolyArea) │
│ Rio Grande do Norte │ Multi(1×PolyArea) │
│ Rio Grande do Sul │ Multi(1×PolyArea) │
│ Rondônia │ Multi(1×PolyArea) │
│ Roraima │ Multi(1×PolyArea) │
│ Santa Catarina │ Multi(2×PolyArea) │
│ São Paulo │ Multi(37×PolyArea) │
│ Sergipe │ Multi(1×PolyArea) │
│ Tocantins │ Multi(1×PolyArea) │
└───────────────────────────────────────────────┴──────────────────────────────┘
julia> GeoBR.state("RJ")
1×6 GeoTable over 1 GeometrySet
┌────────────┬──────────────┬────────────────┬─────────────┬─────────────┬──────────────────────────────┐
│ code_state │ abbrev_state │ name_state │ code_region │ name_region │ geometry │
│ Continuous │ Categorical │ Categorical │ Continuous │ Categorical │ MultiPolygon │
│ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ [NoUnits] │ 🖈 GeodeticLatLon{SIRGAS2000} │
├────────────┼──────────────┼────────────────┼─────────────┼─────────────┼──────────────────────────────┤
│ 33.0 │ RJ │ Rio De Janeiro │ 3.0 │ Sudeste │ Multi(577×PolyArea) │
└────────────┴──────────────┴────────────────┴─────────────┴─────────────┴──────────────────────────────┘
```
## Asking for help
If you have any questions, please [contact our community](https://juliaearth.github.io/GeoStats.jl/stable/about/community.html).
[build-img]: https://img.shields.io/github/actions/workflow/status/JuliaEarth/GeoArtifacts.jl/CI.yml?branch=main&style=flat-square
[build-url]: https://github.com/JuliaEarth/GeoArtifacts.jl/actions
[codecov-img]: https://img.shields.io/codecov/c/github/JuliaEarth/GeoArtifacts.jl?style=flat-square
[codecov-url]: https://codecov.io/gh/JuliaEarth/GeoArtifacts.jl