Script to relocate the space-time bounding box of one or more existing (‘template’) IDV bundles and then execute runIDV to fetch the data and write ouputs.
Outputs (3): Thumbnail image; Animation; and Zipped .zidv file containing all data and displays. All are called CASE_NAME.xxx with appropriate xxx suffixes.
Arguments are used to specify -bbox in lat-lon space, and one or a list of temporal ranges. Time ranges are specified as a middle time of the desired time sequence (-t) plus a half-width of the sequence (-td). The temporal stride must be set in the template BUNDLE.xidv, and can only be changed in the IDV GUI.
Requirements: Version 5.3u1 from May 2016 or later IDV, and any Python.
Usage:
idv_teleport.py [-h] -t TIME -b BUNDLE [BUNDLE ...] [-td TIMEDELTA]
[-bbox NORTH WEST SOUTH EAST]
[-case CASE_NAME [CASE_NAME ...]]
[-outdir OUTPUT_DIRECTORY] [-d {True,False}]
[-purl PUBLISH_URL]
Optional arguments:
-h, --help show this help message and exit
-b BUNDLE.xidv [BUNDLE2.xidv ...], --bundle BUNDLE.xidv [BUNDLE2.xidv ...]
IDV Bundle template file (local file or remote URL).
Can also be .zidv file.
-bbox NORTH WEST SOUTH EAST, --boundingbox NORTH WEST SOUTH EAST
Set the bounding box of the bundle with boundaries
north, west, south, east
-t TIME, --time TIME Input central time as YYYY-MM-DD (optionally with hh:mm:ss),
or as a text file with times as above, one per line.
-td TIMEDELTA, --timedelta TIMEDELTA
Time delta as Nseconds, Nhours, Ndays, Nweeks…
Output bundle will be centered (TIME +- TIMEDELTA).
Default is 0seconds.
-case CASE_NAME [CASE_NAME2 ...], --case_name CASE_NAME [CASE_NAME ...]
Case name to prefix the bundle; by default, the case name
will be selected from template bundle file
-outdir OUTPUT_DIRECTORY, --output_directory OUTPUT_DIRECTORY
Set the output path to place the output;default is
current directory from where the script is run
-pubid PUBLISH_ID, --publish_id PUBLISH_ID
Publish bundle and image at a RAMADDA server;argument
shoud be ramadda entryid wherethe user from
environment variable RAMADDA_USER and password from
RAMADDA_PASSWORD has permissionsto write files.
-nohead {True,False}, --headless {True,False}
Option to use headless display environment or not to
use headless environment `Xvfb` needs to be
installed and be present in the PATH. Default is set to True for convinience,
When True and Xvfb is not on path it tries to run IDV with default local display.
-d {True,False}, --debug {True,False}
Debug option; for each time in timefile, IDV session
will remain open and MUST be closed manually
Simplest use case:
python idv_teleport.py -b templatebundlefile.xidv -t YYYY-MM-DD_hh:mm:ss