NAME

Data Location

Provides a data location pathname for a HiRISE data product file.

SYNOPSIS

Data_Location [-Group|-Number <orbits per directory>] [-Prefix <directory name prefix>] <ID>

DESCRIPTION

Given an Observation <ID> text representation generate a relative directory pathname for the product file associated with the <ID>.

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.

Mission phase name

The first delimited field is the HiRISE mission phase name.

Date/Orbit number

The second delimited field may be a date or orbit number.

Date

A date field has the format:

YYYYMMDDThhmmss

Where:

Leading zeros are required, if necessary, to fill the field width.

Orbit number

An orbit number field is six digits followed, after another '_' delimiter, by a 4 digit target number field.

Pathname

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.

Software version

To obtain the software version specify -Version instead of an Observation ID string.

Exit status

0 - Success
1 - Missing command line argument
2 - Invalid Observation ID

Author

Bradford Castalia, UA/PIRL/HiROC

Copyright

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.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.

Version

1.10 2020/04/28 17:36:11