summaryrefslogtreecommitdiff
path: root/README.DATUMGRID
blob: d2ccd4dde87572fc855398411d4897c349cbc2c8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# PROJ-DATUMGRID-GEOTIFF

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 Datum Grid package

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

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-datumgrid-geotiff/blob/master/CONTRIBUTING.md) to submit a new grid.

## Content Delivery Network

Those grids can be retrieved from cloud storage (AWS Public datasets) as
described in
https://github.com/rouault/PROJ/blob/rfc4_remote_and_geotiff_grid/docs/source/community/rfc/rfc-4.rst#network-access-to-grids at
https://cdn.proj.org

### 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.

* [at_bev: Austria BEV](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/at_bev/)
* [au_ga: Australia Geoscience Australia](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/au_ga/)
* [au_icsm: Australia ICSM](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/au_icsm/)
* [be_ign: Belgium IGN](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/be_ign/)
* [ca_nrc: Canada NRC](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/ca_nrc/)
* [ca_que_mern: Canada Quebec MERN](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/ca_que_mern/)
* [ch_swisstopo: Switzerland Swissstopo](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/ch_swisstopo/)
* [de_adv: Germany AdV](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/de_adv/)
* [de_geosn: Germany GeoSN](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/de_geosn/)
* [de_lgl_bw: Germany LGL Baden-Württemberg](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/de_lgl_bw/)
* [de_lgvl_saarland: Germany LGVL Saarland](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/de_lgvl_saarland/)
* [dk_sdfe: Denmark SDFE](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/dk_sdfe/)
* [es_cat_icgc: Spain Catalonia ICGC](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/es_cat_icgc/)
* [fr_ign: France IGN](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/fr_ign/)
* [is_lmi: Iceland LMI](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/is_lmi/)
* [nz_linz: New Zealand LINZ](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/nz_linz/)
* [pt_dgt: Portugal DGT](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/pt_dgt/)
* [se_lantmateriet: Sweden Lantmateriet](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/se_lantmateriet/)
* [uk_os: UK OS](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/uk_os/)
* [us_nga: USA NGA](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/us_nga/)
* [us_noaa: USA NOAA](https://github.com/OSGeo/proj-datumgrid-geotiff/blob/master/us_noaa/)