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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
|
"""
This is the main entry point for pyproj CLI
e.g. python -m pyproj
"""
import argparse
import os
from pyproj import __proj_version__, __version__, _show_versions
from pyproj.aoi import BBox
from pyproj.datadir import get_data_dir, get_user_data_dir
from pyproj.sync import (
_download_resource_file,
get_proj_endpoint,
get_transform_grid_list,
)
parser = argparse.ArgumentParser(
description=f"pyproj version: {__version__} [PROJ version: {__proj_version__}]"
)
parser.add_argument(
"-v",
"--verbose",
help="Show verbose debugging version information.",
action="store_true",
)
subparsers = parser.add_subparsers(title="commands")
sync_parser = subparsers.add_parser(
name="sync",
description="Tool for synchronizing PROJ datum and transformation support data.",
)
sync_parser.add_argument(
"--bbox",
help=(
"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 an "
"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."
),
)
sync_parser.add_argument(
"--spatial-test",
help=(
"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 the ``contains`` strategy, "
"only resource files whose extent is contained in the value specified by "
"`--bbox` will be selected."
),
choices=["intersects", "contains"],
default="intersects",
)
sync_parser.add_argument(
"--source-id",
help=(
"Restrict resource files to be downloaded to those whose source_id property "
"contains the ID value. Default is all possible values."
),
)
sync_parser.add_argument(
"--area-of-use",
help=(
"Restrict resource files to be downloaded to those whose area_of_use property "
"contains the AREA_OF_USE value. Default is all possible values."
),
)
sync_parser.add_argument(
"--file",
help=(
"Restrict resource files to be downloaded to those whose name property "
" (file name) contains the FILE value. Default is all possible values."
),
)
sync_parser.add_argument(
"--exclude-world-coverage",
help="Exclude files which have world coverage.",
action="store_true",
)
sync_parser.add_argument(
"--include-already-downloaded",
help="Include grids that are already downloaded.",
action="store_true",
)
sync_parser.add_argument(
"--list-files", help="List the files without downloading.", action="store_true"
)
sync_parser.add_argument(
"--all", help="Download all missing transform grids.", action="store_true"
)
sync_parser.add_argument(
"--system-directory",
help=(
"If enabled, it will sync grids to the main PROJ data directory "
"instead of the user writable directory."
),
action="store_true",
)
sync_parser.add_argument(
"--target-directory",
help="The directory to sync grids to instead of the user writable directory.",
)
sync_parser.add_argument(
"-v", "--verbose", help="Print download information.", action="store_true"
)
def _parse_sync_command(args):
"""
Handle sync command arguments
"""
if not any(
(
args.bbox,
args.list_files,
args.all,
args.source_id,
args.area_of_use,
args.file,
)
):
sync_parser.print_help()
return
if args.all and any(
(
args.bbox,
args.list_files,
args.source_id,
args.area_of_use,
args.file,
)
):
raise RuntimeError(
"Cannot use '--all' with '--list-files', '--source-id',"
"'--area-of-use', '--bbox', or '--file'."
)
bbox = None
if args.bbox is not None:
west, south, east, north = args.bbox.split(",")
bbox = BBox(
west=float(west),
south=float(south),
east=float(east),
north=float(north),
)
if args.target_directory and args.system_directory:
raise RuntimeError("Cannot set both --target-directory and --system-directory.")
target_directory = args.target_directory
if args.system_directory:
target_directory = get_data_dir().split(os.path.sep)[0]
elif not target_directory:
target_directory = get_user_data_dir(True)
grids = get_transform_grid_list(
source_id=args.source_id,
area_of_use=args.area_of_use,
filename=args.file,
bbox=bbox,
spatial_test=args.spatial_test,
include_world_coverage=not args.exclude_world_coverage,
include_already_downloaded=args.include_already_downloaded,
target_directory=target_directory,
)
if args.list_files:
print("filename | source_id | area_of_use")
print("----------------------------------")
else:
endpoint = get_proj_endpoint()
for grid in grids:
if args.list_files:
print(
grid["properties"]["name"],
grid["properties"]["source_id"],
grid["properties"].get("area_of_use"),
sep=" | ",
)
else:
filename = grid["properties"]["name"]
_download_resource_file(
file_url=f"{endpoint}/{filename}",
short_name=filename,
directory=target_directory,
verbose=args.verbose,
sha256=grid["properties"]["sha256sum"],
)
def main():
"""
Main entrypoint into the command line interface.
"""
args = parser.parse_args()
if hasattr(args, "bbox"):
_parse_sync_command(args)
elif args.verbose:
_show_versions.show_versions()
else:
parser.print_help()
if __name__ == "__main__":
main()
|
