summaryrefslogtreecommitdiff
path: root/README.DATA
diff options
context:
space:
mode:
authorEven Rouault <even.rouault@spatialys.com>2020-01-28 15:03:36 +0100
committerEven Rouault <even.rouault@spatialys.com>2020-01-28 15:05:16 +0100
commitb00e25a717ab95a46e8dfb6a60651c2dcc9a2409 (patch)
tree71e6ecc5c2bb162844c9a2ce2ad912dace85ccdd /README.DATA
parent59ad4993367080f0a75de20058b43c9c4acfa6be (diff)
downloadPROJ-data-b00e25a717ab95a46e8dfb6a60651c2dcc9a2409.tar.gz
PROJ-data-b00e25a717ab95a46e8dfb6a60651c2dcc9a2409.zip
Take into account repo renaming and README.DATUMGRID -> README.DATA
Diffstat (limited to 'README.DATA')
-rw-r--r--README.DATA75
1 files changed, 75 insertions, 0 deletions
diff --git a/README.DATA b/README.DATA
new file mode 100644
index 0000000..f9efdca
--- /dev/null
+++ b/README.DATA
@@ -0,0 +1,75 @@
+# 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) 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-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/)
+* [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/)
+* [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/)
+* [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/)
+* [nl_nsgi: Nederlandse Samenwerking Geodetische Infrastructuur (NSGI)](https://github.com/OSGeo/PROJ-data/blob/master/nl_nsgi/)
+* [nz_linz: New Zealand LINZ](https://github.com/OSGeo/PROJ-data/blob/master/nz_linz/)
+* [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/)