projsync¶
New in version 7.0.0.
Tool for synchronizing PROJ datum and transformation support data.
Synopsis¶
projsync[–endpoint URL][–local-geojson-file FILENAME]([–user-writable-directory] | [–system-directory] | [–target-dir DIRNAME])[–bbox west_long,south_lat,east_long,north_lat][–spatial-test contains|intersects][–source-id ID] [–area-of-use NAME][–file NAME][–all] [–exclude-world-coverage][–quiet] [–dry-run] [–list-files]
Description¶
projsync is a program that downloads remote resource files into a local directory. This is an alternative to downloading a proj-data-X.Y.Z archive file, or using the on-demand networking capabilities of PROJ.
The following control parameters can appear in any order:
-
--endpoint
URL
¶ Defines the URL where to download the master
files.geojson
file and then the resource files. Defaults to the value set in proj.ini
-
--local-geojson-file
FILENAME
¶ Defines the filename for the master GeoJSON files that references resources. Defaults to ${endpoint}/files.geojson
-
--user-writable-directory
¶
Specifies that resource files must be downloaded in the user writable directory. This is the default.
-
--system-directory
¶
Specifies that resource files must be downloaded in the ${installation_prefix}/share/proj directory. The user launching projsync should make sure it has writing rights in that directory.
-
--target-dir
DIRNAME
¶ Directory into which resource files must be downloaded.
-
--bbox
west_long,south_lat,east_long,north_lat
¶ Specify an area of interest to restrict the resources to download. The area of interest is specified as a bounding box with geographic coordinates, expressed in degrees in a unspecified geographic CRS. west_long and east_long should be in the [-180,180] range, and south_lat and north_lat in the [-90,90]. west_long is generally lower than east_long, except in the case where the area of interest crosses the antimeridian.
-
--spatial-test
contains|intersects
¶ Specify how the extent of the resource files are compared to the area of use specified explicitly with
--bbox
. By default, any resource files whose extent intersects the value specified by--bbox
will be selected. If using thecontains
strategy, only resource files whose extent is contained in the value specified by--bbox
will be selected.
-
--source-id
ID
¶ Restrict resource files to be downloaded to those whose source_id property contains the ID value. Specifying
?
as ID will list all possible values.
-
--area-of-use
NAME
¶ Restrict resource files to be downloaded to those whose area_of_use property contains the NAME value. Specifying
?
as NAME will list all possible values.
-
--file
NAME
¶ Restrict resource files to be downloaded to those whose name property contains the NAME value. Specifying
?
as NAME will list all possible values.
-
--all
¶
Ask to download all files.
-
--exclude-world-coverage
¶
Exclude files which have world coverage.
-
-q
/ --quiet
¶ Quiet mode
-
--dry-run
¶
Simulate the behavior of the tool without downloading resource files.
-
--list-files
¶
List file names, with the source_id and area_of_use properties.
At least one of --list-files
, --file
, --source-id
,
--area-of-use
, --bbox
or --all
must be specified.
Options --file
, --source-id
, --area-of-use
and
--bbox
are combined with a AND logic.
Examples¶
Download all resource files
projsync --all
Download resource files covering specified point and attributing to an agency
projsync --source-id fr_ign --bbox 2,49,2,49