Data Location
Provides a data location pathname for a HiRISE data product file.
Data_Location [-Group|-Number <orbits per directory>] [-Prefix <directory name prefix>] <ID>
Given an Observation <ID> text representation generate a relative directory pathname for the product file associated with the <ID>.
The <ID> argument may be an Observation ID, a CCD ID, a Channel ID or any of these as the prefix of a string separated from the remainder of the string by a '-', '_' or '.' delimiter as might occur in a filename. The <ID> is expected to be composed of a mission phase name field followed by a '_' delimiter and a date or orbit number field.
The first delimited field is the HiRISE mission phase name.
The second delimited field may be a date or orbit number.
A date field has the format:
YYYYMMDDThhmmss
Where:
YYYY is the year number
MM is the month of the year
DD is the day of the month
hh is the hour of the day
mm is the minute of the hour
ss is the second of the minute
Leading zeros are required, if necessary, to fill the field width.
An orbit number field is six digits followed, after another '_' delimiter, by a 4 digit target number field.
The pathname that is listed has the format:
<phase>/<prefix><group>/<ID>
Where the <phase> segment is the first field of the Observation ID and the <ID> segment is just the Observation ID.
If the second field is found to contain a date, then the <group> portion of the second segment is YYMM where YY is the last two digits of the year. In this case the <prefix> portion will be "YRM_".
If the second field is found to contain an orbit number, then the <group> is the range of orbits into which it falls. By default there are 100 orbits per directory; thus the first group of orbits is in the range 000000_000099 (N.B.: The '_' character is used instead of the '-' character to meet PDS restricted character set requirements), while the group for orbit 123456 is 123400-123499. For the "CRU" <phase> the default orbits per directory is 10. The number of orbits per directory may be specified with the -Group (or -Number) option. The <prefix> portion when the <group> is an orbit range depends on the value of the <phase> segment: For the "CRU" <phase> the orbit range values are really sequence numbers, so "SEQ_" is used for the <prefix>; otherwise "ORB_" is used.
The value of the <prefix> portion can be specified on the command line with the -Prefix option.
To obtain the software version specify -Version instead of an Observation ID string.
Bradford Castalia, UA/PIRL/HiROC
Copyright (C) 2004-2020 Arizona Board of Regents on behalf of the Lunar and Planetary Laboratory at the University of Arizona.
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.0Unless 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.
1.10 2020/04/28 17:36:11