172 lines
9.9 KiB
Python
172 lines
9.9 KiB
Python
#!/usr/bin/env python3
|
|
|
|
|
|
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
# Copyright 2010 California Institute of Technology. ALL RIGHTS RESERVED.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
#
|
|
# United States Government Sponsorship acknowledged. This software is subject to
|
|
# U.S. export control laws and regulations and has been classified as 'EAR99 NLR'
|
|
# (No [Export] License Required except when exporting to an embargoed country,
|
|
# end user, or in support of a prohibited end use). By downloading this software,
|
|
# the user agrees to comply with all applicable U.S. export laws and regulations.
|
|
# The user has the responsibility to obtain export licenses, or other export
|
|
# authority as may be required before exporting this software to any 'EAR99'
|
|
# embargoed foreign country or citizen of those countries.
|
|
#
|
|
# Author: Giangi Sacco
|
|
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
import isce
|
|
import sys
|
|
import os
|
|
import argparse
|
|
from contrib.demUtils import createDemStitcher
|
|
|
|
|
|
def main():
|
|
#if not argument provided force the --help flag
|
|
if(len(sys.argv) == 1):
|
|
sys.argv.append('-h')
|
|
|
|
# Use the epilog to add usage examples
|
|
epilog = 'Usage examples:\n\n'
|
|
epilog += 'Stitch (-a stitch) 1 arcsec dems (-s 1) in the bounding region 31 33 -114 -112 using the url (-u) and the log in credentials provided (-n,-w).\n'
|
|
epilog += 'Create a rsc metadata file (-m) and report the download results (-r)\n'
|
|
epilog += 'dem.py -a stitch -b 31 33 -114 -112 -s 1 -m rsc -r -n your_username -w your_password -u https://aria-alt-dav.jpl.nasa.gov/repository/products/SRTM1_v3/ \n\n'
|
|
epilog += 'Download (-a download) the 3 arcsec (-s 3) whose lat/lon are 31 -114 and 31 -115 (-p)\n'
|
|
epilog += 'dem.py -a download -p 31 -114 31 -115 -s 3 \n\n'
|
|
epilog += 'Stitch the requested files and apply EGM96 -> WGS84 correction (-c)\n'
|
|
epilog += 'dem.py -a stitch -b 31 33 -114 -113 -r -s 1 -c\n\n'
|
|
epilog += 'Download from bounding boxes (-b)\n'
|
|
epilog += 'dem.py -a download -b 31 33 -114 -113 -r -s 1\n\n'
|
|
epilog += 'Stitch the files in the local directory (-l) in the bounding region provided keeping the\n'
|
|
epilog += 'zip files after stitching (-k)\n'
|
|
epilog += 'dem.py -a stitch -b 31 33 -114 -113 -k -r -l -s 1\n\n'
|
|
|
|
#set the formatter_class=argparse.RawDescriptionHelpFormatter otherwise it splits the epilog lines with its own default format
|
|
parser = argparse.ArgumentParser(formatter_class=argparse.RawDescriptionHelpFormatter,epilog=epilog)
|
|
|
|
parser.add_argument('-a', '--action', type = str, default = 'stitch', dest = 'action', help = 'Possible actions: stitch or download (default: %(default)s). ')
|
|
parser.add_argument('-c', '--correct', action = 'store_true', dest = 'correct', help = 'Apply correction EGM96 -> WGS84 (default: %(default)s). The output metadata is in xml format only')
|
|
parser.add_argument('-m', '--meta', type = str, default = 'xml', dest = 'meta', help = 'What type of metadata file is created. Possible values: \
|
|
xml or rsc (default: %(default)s)')
|
|
parser.add_argument('-s', '--source', type = int, default = 1, dest = 'source', help = 'Dem SRTM source. Possible values 1 or 3 (default: %(default)s)')
|
|
parser.add_argument('-f', '--filling', action = 'store_true', dest = 'filling', help = 'Flag to instruct to fill missing Dems with null values \
|
|
(default null value -32768. Use -v or --filling_value option to change it)')
|
|
parser.add_argument('-v', '--filling_value', type = int, default = -32768, dest = 'fillingValue', help = 'Value used to fill missing Dems (default: %(default)s)')
|
|
parser.add_argument('-b', '--bbox', type = int, default = None, nargs = '+', dest = 'bbox', help = 'Defines the spatial region in the format south north west east.\
|
|
The values should be integers from (-90,90) for latitudes and (0,360) or (-180,180) for longitudes.')
|
|
parser.add_argument('-p', '--pairs', type = int, default = None, nargs = '+', dest = 'pairs', help = 'Set of latitude and longitude pairs for which --action = download is performed.\
|
|
The values should be integers from (-90,90) for latitudes and (0,360) or (-180,180) for longitudes')
|
|
parser.add_argument('-k', '--keep', action = 'store_true', dest = 'keep', help = 'If the option is present then the single files used for stitching are kept. If -l or --local is specified than the flag is automatically set (default: %(default)s)')
|
|
parser.add_argument('-r', '--report', action = 'store_true', dest = 'report', help = 'If the option is present then failed and succeeded downloads are printed (default: %(default)s)')
|
|
parser.add_argument('-l', '--local', action = 'store_true', dest = 'local', help = 'If the option is present then use the files that are in the location \
|
|
specified by --dir. If not present --dir indicates the directory where the files are downloaded (default: %(default)s)')
|
|
parser.add_argument('-d', '--dir', type = str, dest = 'dir', default = './', help = 'If used in conjunction with --local it specifies the location where the DEMs are located \
|
|
otherwise it specifies the directory where the DEMs are downloaded and the stitched DEM is generated (default: %(default)s)')
|
|
|
|
parser.add_argument('-o', '--output', type = str, dest = 'output', default = None, help = 'Name of the output file to be created in --dir. If not provided the system generates one based on the bbox extremes')
|
|
parser.add_argument('-n', '--uname', type = str, dest = 'uname', default = None, help = 'User name if using a server that requires authentication')
|
|
parser.add_argument('-w', '--password', type = str, dest = 'password', default = None, help = 'Password if using a server that requires authentication')
|
|
parser.add_argument('-t', '--type', type = str, dest = 'type', default = 'version3', help = \
|
|
'Use version 3 or version 2 SRTM, or nasadem')
|
|
parser.add_argument('-x', '--noextras', action = 'store_true', dest = 'noextras', help = 'Use this flag if the filenames do not have extra part')
|
|
parser.add_argument('-u', '--url', type = str, dest = 'url', default = None, help = \
|
|
'If --type=version2 then this is part of the url where the DEM files are located. The actual location must be' + \
|
|
'the one specified by --url plus /srtm/version2_1/SRTM(1,3).' \
|
|
+'If --type=version3 then it represents the full path url')
|
|
args = parser.parse_args()
|
|
#first get the url,uname and password since are needed in the constructor
|
|
|
|
ds = createDemStitcher(args.type)
|
|
ds.configure()
|
|
|
|
#NASADEM only available in 1-arc sec resolution
|
|
if(args.type == 'nasadem'):
|
|
args.source == 1
|
|
|
|
if(args.url):
|
|
if(args.type == 'version3'):
|
|
if(args.source == 1):
|
|
ds._url1 = args.url
|
|
elif(args.source == 3):
|
|
ds._url3 = args.url
|
|
else:
|
|
print('Unrecognized source')
|
|
raise ValueError
|
|
|
|
else:
|
|
ds.setUrl(args.url)
|
|
ds.setUsername(args.uname)
|
|
ds.setPassword(args.password)
|
|
ds._keepAfterFailed = True
|
|
#avoid to accidentally remove local file if -k is forgotten
|
|
#if one wants can remove them manually
|
|
if(args.local):
|
|
args.keep = True
|
|
if(args.meta == 'xml'):
|
|
ds.setCreateXmlMetadata(True)
|
|
elif(args.meta == 'rsc'):
|
|
ds.setCreateRscMetadata(True)
|
|
if(args.noextras):
|
|
ds._hasExtras = False
|
|
ds.setUseLocalDirectory(args.local)
|
|
ds.setFillingValue(args.fillingValue)
|
|
ds.setFilling() if args.filling else ds.setNoFilling()
|
|
if(args.action == 'stitch'):
|
|
if(args.bbox):
|
|
lat = args.bbox[0:2]
|
|
lon = args.bbox[2:4]
|
|
if (args.output is None):
|
|
args.output = ds.defaultName(args.bbox)
|
|
|
|
if not(ds.stitchDems(lat,lon,args.source,args.output,args.dir,keep=args.keep)):
|
|
print('Could not create a stitched DEM. Some tiles are missing')
|
|
else:
|
|
if(args.correct):
|
|
#ds.correct(args.output,args.source,width,min(lat[0],lat[1]),min(lon[0],lon[1]))
|
|
demImg = ds.correct()
|
|
# replace filename with full path including dir in which file is located
|
|
demImg.filename = os.path.abspath(os.path.join(args.dir, demImg.filename))
|
|
demImg.setAccessMode('READ')
|
|
demImg.renderHdr()
|
|
else:
|
|
print('Error. The --bbox (or -b) option must be specified when --action stitch is used')
|
|
raise ValueError
|
|
elif(args.action == 'download'):
|
|
if(args.bbox):
|
|
lat = args.bbox[0:2]
|
|
lon = args.bbox[2:4]
|
|
ds.getDemsInBox(lat,lon,args.source,args.dir)
|
|
#can make the bbox and pairs mutually esclusive if replace the if below with elif
|
|
if(args.pairs):
|
|
ds.downloadFilesFromList(args.pairs[::2],args.pairs[1::2],args.source,args.dir)
|
|
if(not (args.bbox or args.pairs)):
|
|
print('Error. Either the --bbox (-b) or the --pairs (-p) options must be specified when --action download is used')
|
|
raise ValueError
|
|
|
|
else:
|
|
print('Unrecognized action -a or --action',args.action)
|
|
return
|
|
|
|
if(args.report):
|
|
for k,v in list(ds._downloadReport.items()):
|
|
print(k,'=',v)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
sys.exit(main())
|