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:

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.

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, 2005 Arizona Board of Regents on behalf of the Planetary Image Research Laboratory, Lunar and Planetary Laboratory at the University of Arizona.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


Version

1.7 2005/11/19 01:03:57