ISIS Documentation

Label Dictionary

Reference to the objects and groups in ISIS cube labels

Introduction

This document is a reference to the various objects and groups, which can be found in ISIS labels. The definition of each object/group, the parameter meanings, and an example will be given.

IsisCube Object

The IsisCube Object is simply a container. It is used to house the various elements (groups and objects) that make up an ISIS cube. The IsisCube object is comprised of the Core object, which defines the cube size and pixel attributes and many optional groups that are described elsewhere in this document including Archive, BandBin, Instrument, Kernels, and Mapping Groups. While we present a whole IsisCube object we will save of the individual elements in their own sections.

Object = IsisCube
  Object = Core
    ^Core       = filename.dat
    StartByte   = 65537
    Format      = Tile
    TileSamples = 128
    TileLines   = 128

    Group = Dimensions
      Samples = 320
      Lines   = 5392
      Bands   = 1
    EndGroup

    Group = Pixels
      Type       = Real
      ByteOrder  = Lsb
      Base       = 0.0
      Multiplier = 1.0
    EndGroup
  EndObject

  Group = BandBin
    OriginalBand = 10
    Center       = 14.88 <microns>
    Width        = 0.87 <microns>
    FilterNumber = 10
  EndGroup
EndObject

Core Object

The core object is used to house the groups (Dimensions and Pixels) that describe the size and pixel attributes of the cube, as well as the storage type of the data.

Object = Core
  ^Core       = filename.dat
  StartByte   = 65537
  Format      = Tile
  TileSamples = 128
  TileLines   = 128

  Group = Dimensions
    Samples = 320
    Lines   = 5392
    Bands   = 1
  EndGroup

  Group = Pixels
    Type       = Real
    ByteOrder  = Lsb
    Base       = 0.0
    Multiplier = 1.0
  EndGroup
EndObject

Keyword	Type	Description
^Core	String	This optional keyword is used to point to an extra binary file containing the cube data. The cube is designated detached (labels and cube data in separate files) if this keyword exists. If the keyword does not exist it indicates the labels and cube data are attached (in the same file).
StartByte	Integer	This keyword points to the starting byte (one-based) of the cube data. For detached cubes this value is often equal to one. For attached cubes it often 65537 as there is typically 64k bytes reserved for label space. On occasions it may be larger if the labels have grown beyond this boundary.
Format	String (Tile or BandSequential)	This keyword indicates how the cube data is arranged. BandSequential indicates the pixels are stored first by sample, then by line, and finally by band. Tile indicates the pixels are stored in tiles which is the preferred storage mechanism in as it facilities the fastest “universal access”. The tiles are stored in row major format. That is, all the tiles for band 1 ordered from left-to-right, then top-to-bottom, followed by all the tiles for band 2, etc.
TileSamples, TileLines	Integer	Optional keywords which must exist when Format=Tile in a cube. These define the size of the tiles in the cube and do not have to be the same. They are typically 128 x 128 in size.

Dimensions Group

This group contains keywords which define the physical dimensions of the cube. The group is always found inside the Core object.

Group = Dimensions
  Samples = 320
  Lines   = 5392
  Bands   = 1
EndGroup

Keyword	Type	Description
Samples, Lines, Bands	Integer	These three keywords are in the Dimensions group and define the size of the cube.

Pixel Group

This group describes information about the pixels in a cube. The group is always found inside the Core object.

Group = Pixels
  Type       = Real
  ByteOrder  = Lsb
  Base       = 0.0
  Multiplier = 1.0
EndGroup

Keyword	Type	Description
Type	String (UnsignedByte, SignedWord, Real)	Currently there are three type of pixels in ISIS which represent unsigned 8-bit vaues (0 to 255), signed 16-bit values (-32768 to 32767) and 32-bit IEEE floating point pixel values. [Future option] Support alternative pixel types.
ByteOrder	String (Lsb, Msb)	This defines the byte order or endianess of the pixels. The order must either be least significant byte (Lsb) or most significant byte (Msb).
Base, Multiplier	Double	These values are used to scale UnsignedByte and SignedWord pixels so they appear to be Real (32-bit floating) pixels. That is, realDn = diskDN * Multiplier + Base. These values are always 0.0 and 1.0 when Type=Real.

AlphaCube Group

This group is used to map pixel locations in a child cube (beta) back to its parent cube (alpha). It is necessary in order to determine which detector a pixel represents in ISIS camera models. The group is created by ISIS ingestion programs (e.g., thm2isis, moc2isis, ciss2isis, etc) and automatically updated by programs such as crop, pad, reduce, or enlarge. The keywords found in this group can occur in one of two places. Either inside of the AlphaCube group or inside of the Instrument group and therefore they can occur twice. Once if a crop occurred in Instrument (level 1) space and again if a crop occurred in Mapping (level 2) space.

Group = AlphaCube
    AlphaSamples          = 320
    AlphaLines            = 5392
    AlphaStartingSample   = 0.5
    AlphaStartingLine     = 0.5
    AlphaEndingSample     = 320.5
    AlphaEndingLine       = 5392.5
    BetaSamples           = 320
    BetaLines             = 5392
EndGroup

Keyword	Type	Description
AlphaSamples, AlphaLines	Integer	The number of lines and samples in the original parent/alpha cube.
AlphaStartingSample, AlphaStartingLine	Double	The starting sample and line in the alpha cube which maps to (0.5,0.5) in the beta cube.
AlphaEndingSample, AlphaEndingLine	Double	The ending sample and line in the alpha cube which maps to (BetaSamples+0.5,BetaLines+0.5) in the beta cube.

Archive Group

This group is used to store keywords that identify archival information. That is, information which uniquely identifies the data. There is not a “required” set of keywords for this group. Generally, the keywords found in this group represent PDS specific information as indicated in the example given below.

Group = Archive
  ImageNumber         = "7102002401"
  ProductId           = “AB-1-024/01”
  DataSetId           = "MGS-M-MOC-NA/WA-2-DSDP-L0-V1.0"
  ProducerId          = "MGS_MOC_TEAM"
  ProductCreationTime = "1999-01-15T20:40:59.000Z"
  UploadId            = "moc_p024_v1.sasf"
  ImageKeyId          = "5618102401"
  RationalDescription = “OLYMPUS MONS SPECIAL RED WA"
EndGroup

BandBin Group

This group is used to stored information regarding each band in the cube. This implies that every keyword in the group be an array with a dimension equal to the number of bands in the cube. This group is not required nor if it exists are any particular keywords required. That is, the names of keywords are irrelevant although some instrument- specific programs may expect certain keywords to be available (e.g., OriginalBand). The keywords in this group will be automatically pruned if any program uses the input cube attribute option (e.g., from=input.cub+1,3-4).

Group = BandBin
  OriginalBand = (1, 2, 3, 4, 5)
  Center       = (6.78, 6.78, 7.93, 8.56, 9.35) <microns>
  Width        = (1.01, 1.01, 1.09, 1.16, 1.20) <microns>
  FilterNumber = (1, 2, 3, 4, 5)
EndGroup

Keyword	Type	Description
OriginalBand	Integer	This keyword indicates the original band number at the current band location. Hence, extracting bands 2 and 5 from a cube via the input cube attribute option would yield OriginalBand = (2,5)
Center, Width	Double	Often these keywords are used to describe the center wavelength and width of each band.

ImportLabel Object

Object = ImportLabel
  Lblsize  = 536
  Format   = HALF
  Type     = IMAGE
  Bufsiz   = 24576
  Dim      = 3
  Eol      = 1
  Recsize  = 536
  Org      = BSQ
  Nl       = 256
  Ns       = 256
  Nb       = 1
  N1       = 256
  N2       = 256
  N3       = 1
  N4       = 0
  Nbb      = 24
  Nlb      = 1
  Host     = SUN-SOLR
  Intfmt   = HIGH
EndObject

Instrument Group

This group stores specific information regarding the mission and instrument. This information is typically used to perform radiometric calibration as well as in camera models in order to accurately compute ground positions in a raw camera cube. Obviously, the keywords in the group will vary from instrument to instrument. However, there are three required keywords (Name, SpaceCraft, and Target). Definitions for Instrument specific keywords can be found in the appropriate documentation for that instrument.

Group = Instrument
  SpacecraftName  = "Galileo Orbiter"
  InstrumentId    = "Solid State Imaging System"
  TargetName      = Io
  StartTime       = "1996-06-25T17:36:56.858"
  FrameModeId     = Full
EndGroup

Keyword	Type	Description
SpacecraftName	String	Name of the mission/spacecraft
InstrumentId	String	The name of the instrument
TargetName	String	The name of target/body which the instrument is viewing

Kernels Group

The Kernels group is created when the program “spiceinit” is run on a raw camera cube (e.g., Moc or Themis raw geometry). The program determines which NAIF SPICE kernels are needed for proper operation of the camera model. These kernels are written to this group.

Group = Kernels
  LeapSecond          = mk98264a.tls
  SpaceCraftClock     = mk00062b.tsc
  TargetPosition      = s980326b.bsp
  TargetAttitudeShape = pck00005.tpc
  Instrument          = ""
  InstrumentAddendum  = ssiAddendum.ti
  SpaceCraftPosition  = s980326b.bsp
  SpaceCraftPointing  = galssi_io_010806.baa.bck
  Frame               = ""
  ElevationModel      = iodem.cub
EndGroup

Keyword	Type	Description
LeapSecond	Filename	The name of the NAIF leapsecond kernel. See NAIF required reading document time.req for more information.
SpaceCraftClock	Filename	The name of the NAIF spacecraft clock kernel. See NAIF required reading document sclk.req for more information.
TargetPosition	Filename	The name of the NAIF planetary ephemeris kernel. Note that this may be the same as the spacecraft position kernel. See NAIF required reading document spk.req for more information.
TargetAttitudeShape	Filename	The name of the NAIF planetary constants kernel. It contains the target radii and definitions for prime merdian and the pole. See NAIF required reading document pck.req for more information.
Instrument	Filename	The name of the NAIF instrument kernel for the particular mission/instrument. It contains specifics regarding the instruement (e.g., focal length, boresight, etc).
InstrumentAddendum	Filename	The name of the ISIS addendum to the instrument kernel for the particular mission/instrument. This often contains information that is lacking from the NAIF instrument kernel in order to have a properly functioning sensor model.
SpacecraftPosition	Filename	The name of the NAIF spacecraft ephemeris (position) kernel. Note that this may be the same as the target position kernel. See NAIF required reading document spk.req for more information.
SpacecraftPointing	Filename	The name of the NAIF spacecraft pointing (c-matrix) kernel. See NAIF required reading document ck.req for more information.
Frame	Filename	The name of the NAIF frame kernel. See NAIF required reading document frames.req for more information.
ElevationModel	Filename	The name of an ISIS cube containing the local (or global) radii covering the cube’s latitude/longitude ground range. The elevation model will utilized by the camera model to remove topographic effects. If one is not available the local radii is computed from the ellipsoid defined in the TargetAttitudeShape kernel.

Mapping Group

The Mapping Group is used to define map projections. Recommending reading includes the ISIS Map Projection Guide and Map Projections – A Working Manual, Snyder, J.P., U.S. Geological Survey, Bulletin 1532.

Group = Mapping
  ProjectionName         = Sinusoidal
  TargetName             = MARS
  EquatorialRadius       = 3396190.0 <meters>
  PolarRadius            = 3376200.0 <meters>
  LatitudeType           = Planetocentric
  LongitudeDirection     = PositiveEast
  LongitudeDomain        = 360
  MinimumLatitude        = -5.5707102
  MaximumLatitude        = 13.8285999
  MinimumLongitude       = 351.4547729
  MaximumLongitude       = 355.6184082
  PixelResolution        = 100.0 <meters/pixel>
  Scale                  = 592.74697523306 <pixels/degree>
  TrueScaleLatitude      = 0.0
  CenterLongitude        = 354.0
  LineProjectionOffset   = -8196.5
  SampleProjectionOffset = -1508.5
  UpperLeftCornerX       = -150900.0 <meters>
  UpperLeftCornerY       = 819700.0 <meters>
EndGroup

Keyword	Type	Description
ProjectionName	String	This indicates the name of the map projection (Sinusoidal, SimpleCylindrical, PolarStereographic, etc)
EquatorialRadius, PolarRadius	Double	The distance in meters from the center of the body to any point on the equator or to either pole, respectively.
LongitudeDirection	String	The direction of positive longitude, PositiveEast or PostiveWest. The term PositiveEast implies that longitudes increase to the right on a map.
LatitudeType	String	Indicates the coordinate type for the latitude values, Planetocentric or Planetographic
LongitudeDomain	String	Indicates the preferred representation, 180 or 360 domain, of longitudes when reporting values or constructing new map. The value 360 implies 0 to 360 while 180 implies -180 to 180.
MinimumLatitude, MaximumLatitude, MinimumLongitude, MaximumLongitude	Double	The values indicate the ground range of the projection (in coordinates of LatitudeType and LongitudeDirection). Because cubes/images are discrete by nature (integral number of pixels), the latitude and longitude boundaries will rarely if every match perfectly. Therefore these values are used only when a map-projected cube is constructed and should only be used as reference from that point forward. For example, do not use these values to import data into another image processing package; instead use UpperLeftCornerX and UpperLeftCornerY.
PixelResolution	Double	This indicates size of each pixel in meters relative to the map projection. Beware that this does not imply each pixel has true scale. That is completely dependent upon the type of map projection utilized (Sinusoidal, Mercator, etc). The resolution often only holds at the latitude of true scale.
Scale	Double	This indicates the number of pixels per degree relative to the map projection. Beware that this does not imply each pixel has true scale. That is completely dependent upon the type of map projection utilized (Sinusoidal, Mercator, etc). The scale often only holds at the latitude of true scale.
TrueScaleLatitude	Double	This indicates the latitude at which the Scale or PixelResolution holds true.
UpperLeftCornerX, UpperLeftCornerY	Double	These values indicate the projection X/Y in meters at sample 0.5, line 0.5. This base X/Y along with the PixelResolution can be used to compute the projection X/Y at any pixel location in the cube. For example, X = (Sample – 0.5) * PixelResolution + UpperLeftCornerX and Y = UpperLeftCornerY – (Line – 0.5) * PixelResolution. With the proper equations for the projection the computed X/Y could be converted to a latitude/longitude.
LineProjectionOffset,SampleProjectionOffset	Double	These values are listed solely for compatibility with PDS labels and are equivalent to the UpperLeftCorner values in pixel units.

Document History

Jeff Anderson	2003-06-11	Original
Deborah Lee Soltesz	2003-06-11	Converted Jeff Anderson's documentation to HTML and added to this file
Jeff Anderson	2004-03-08	Total rewrite

ISIS

ISIS 2