# PROJ-DATA

The files in this package are in cloud-optimized GeoTIFF format and can be
unpacked in the PROJ data directory of PROJ 7 or later.
For an installed PROJ this may be /usr/local/share/proj or /usr/share/proj
on unix style operating systems.

## About the Data package

The datum grid package for PROJ is maintained on the OSGeo PROJ-data
repository on [GitHub](https://github.com/OSGeo/PROJ-data).

It contains shift grids for horizontal and vertical coordinate transformations.

All grids in the package are released under
permissive licenses. New grids are accepted into the package as long as
they are released under a license that is compatible with the [Open Source
Definition](https://opensource.org/osd-annotated) and the source of the grid
is clearly stated and verifiable. Suitable licenses include:

  * Public domain
  * X/MIT
  * BSD 2/3/4 clause
  * CC0
  * CC-BY (v3.0 or later)
  * CC-BY-SA (v3.0 or later)

Consult [CONTRIBUTING.md](https://github.com/OSGeo/PROJ-data/blob/master/CONTRIBUTING.md) to submit a new grid.

## Content Delivery Network

Those grids can be retrieved from cloud storage (AWS Public datasets) hosted at https://cdn.proj.org as
described in [PROJ network documentation](https://github.com/OSGeo/PROJ/blob/master/docs/source/usage/network.rst)

### CDN Access Log Policy

Implicit location sensitivity may happen because of the way PROJ remotely accesses data.
The PROJ CDN erases all access and activity logs after 24 hours. If this policy is not
sufficient, users are encourage to mirror a local copy of the grid files and access
them directly.

## Content

All grid files should be put in a flat way in the PROJ data directory. They
will be also organized in a flat way on cdn.proj.org.

However for clarity of this repository, we have organized them by producer / agency.
Each file is in a subdirectory whose name follows {country_code}_{agency_name}.
For example us_noaa for files originating from US NOAA.

* [ar_ign: Argentina IGN](https://github.com/OSGeo/PROJ-data/blob/master/ar_ign/)
* [at_bev: Austria BEV](https://github.com/OSGeo/PROJ-data/blob/master/at_bev/)
* [au_ga: Australia Geoscience Australia](https://github.com/OSGeo/PROJ-data/blob/master/au_ga/)
* [au_icsm: Australia ICSM](https://github.com/OSGeo/PROJ-data/blob/master/au_icsm/)
* [be_ign: Belgium IGN](https://github.com/OSGeo/PROJ-data/blob/master/be_ign/)
* [br_ibge: IBGE](https://github.com/OSGeo/PROJ-data/blob/master/br_ibge/)
* [ca_nrc: Canada NRC](https://github.com/OSGeo/PROJ-data/blob/master/ca_nrc/)
* [ca_que_mern: Canada Quebec MERN](https://github.com/OSGeo/PROJ-data/blob/master/ca_que_mern/)
* [ch_swisstopo: Switzerland Swissstopo](https://github.com/OSGeo/PROJ-data/blob/master/ch_swisstopo/)
* [de_adv: Germany AdV](https://github.com/OSGeo/PROJ-data/blob/master/de_adv/)
* [de_geosn: Germany GeoSN](https://github.com/OSGeo/PROJ-data/blob/master/de_geosn/)
* [de_lgl_bw: Germany LGL Baden-Württemberg](https://github.com/OSGeo/PROJ-data/blob/master/de_lgl_bw/)
* [de_lgvl_saarland: Germany LGVL Saarland](https://github.com/OSGeo/PROJ-data/blob/master/de_lgvl_saarland/)
* [dk_sdfe: Denmark SDFE](https://github.com/OSGeo/PROJ-data/blob/master/dk_sdfe/)
* [dk_sdfi: Denmark SDFI](https://github.com/OSGeo/PROJ-data/blob/master/dk_sdfi/)
* [es_ign: Spain IGN](https://github.com/OSGeo/PROJ-data/blob/master/es_ign/)
* [es_cat_icgc: Spain Catalonia ICGC](https://github.com/OSGeo/PROJ-data/blob/master/es_cat_icgc/)
* [eur_nkg: Nordic Geodetic Commission](https://github.com/OSGeo/PROJ-data/blob/master/eur_nkg/)
* [fi_nls: National Land Survey](https://github.com/OSGeo/PROJ-data/blob/master/fi_nls/)
* [fr_ign: France IGN](https://github.com/OSGeo/PROJ-data/blob/master/fr_ign/)
* [is_lmi: Iceland LMI](https://github.com/OSGeo/PROJ-data/blob/master/is_lmi/)
* [jp_gsi: Japan GSI](https://github.com/OSGeo/PROJ-data/blob/master/jp_gsi/)
* [nl_nsgi: Nederlandse Samenwerking Geodetische Infrastructuur (NSGI)](https://github.com/OSGeo/PROJ-data/blob/master/nl_nsgi/)
* [no_kv: Kartverket (SK)](https://github.com/OSGeo/PROJ-data/blob/master/no_kv/)
* [nz_linz: New Zealand LINZ](https://github.com/OSGeo/PROJ-data/blob/master/nz_linz/)
* [pl_gugik: Poland GUGiK](https://github.com/OSGeo/PROJ-data/blob/master/pl_gugik/)
* [pt_dgt: Portugal DGT](https://github.com/OSGeo/PROJ-data/blob/master/pt_dgt/)
* [se_lantmateriet: Sweden Lantmateriet](https://github.com/OSGeo/PROJ-data/blob/master/se_lantmateriet/)
* [uk_os: UK OS](https://github.com/OSGeo/PROJ-data/blob/master/uk_os/)
* [us_nga: USA NGA](https://github.com/OSGeo/PROJ-data/blob/master/us_nga/)
* [us_noaa: USA NOAA](https://github.com/OSGeo/PROJ-data/blob/master/us_noaa/)
* [za_cdngi: South Africa CD:NGI](https://github.com/OSGeo/PROJ-data/blob/master/za_cdngi/)

## Tools

The [grid_tools](https://github.com/OSGeo/PROJ-data/blob/master/grid_tools/) directory contains Python scripts to create and
validate files following the [Geodetic TIFF grids (GTG)](https://github.com/OSGeo/PROJ/blob/master/docs/source/specifications/geodetictiffgrids.rst),
specification.