- Convert index to key value or the reverse
[DRMS Utilities]

Collaboration diagram for - Convert index to key value or the reverse:

Synopsis:

index_convert [-h] index_convert ds=<seriesname> [<pkey>=

] | [<pkey>_index=<indexvalue>] index_convert {same options as above}

Index_convert converts a prime key index value to a prime key value or the reverse. The series must be slotted.

The operation is to get the template record then if the <pkey>_index aregument is present convert that value to the equivalent prime key value. If the <pkey> argument is present, i.e. no "_index" in the keyname, then the equivalent index value is computed and printed.

Options:

Flags:

• -h: help - print usage information and exit

Parameters:

• ds= <seriesname> - required parameter specified the series to examine.
• <pkey>=

- optional prime key name and its test value.

• <pkey>_index=<indexvalue> - optional prime key slotted index name and its test index value.

JSOC flags:

DRMS common main program

Usage:

The program may be used to convert a single prime key value into its equivalent index value or the reverse. The keyname provided must be for a slotted prime key in the specified series. If the seriesname is not a valid series or if the keyname is not a prime key in that series an error code is returned. The direction of the conversion is determined by the presence or absence of the "_index" suffix on the single specified keyword argument.

Examples:

Example 1:

  index_convert ds=mdi.fd_V_lev18 T_REC=1996.05.01

reports: 1751040, the minute number for the given time using the proper epoch.

Example 2:

  index_convert ds=mdi.fd_V_lev18 T_REC_index=1751040

reports: 1996.05.01_00:00:00_TAI, the time of the center of the specified slot.

Bug:

See also:

time_convert time_index(SOI)