# ISIS3 Cube Format¶

## What Is A Cube?¶

A cube is a 3-dimensional image with axis: samples, lines, and bands. The physical dimensions of a cube are called the number of samples (NS), number of lines (NL), and number of bands (NB). Typically, the sample and line dimensions are used to represent spatial information while the band dimension represents spectral information. See the table below for examples of the line, sample, and band dimensions of a few data sets from planetary missions.

Illustration of an ISIS3 image cube, showing the three dimensions of an ISIS3 image: width (samples), height (lines), and depth (bands)

Instrument/Camera | # Lines | # Samples | # Bands | Bands |
---|---|---|---|---|

Mars Odyssey - Thermal Emission Imaging System, Infrared (THEMIS-IR) | 240 | 320 | 10 | All 10 are Infrared, ranging from 6.78 to 14.88 microns |

Mars Odyssey - Thermal Emission Imaging System, Visible Imaging Subsystem (THEMIS-VIS) | 1024 | 1024 | 5 | visible |

Viking Orbiter | 1056 | 1204 | 1 ? | blue, minus-blue, violet, green, red, clear |

Mars Global Surveyor - Mars Oribiter Camera Wide Angle (MOC-WA) | * | 3456 | 1 | bandwidth encompases visible and near-infrared |

Galileo Near-Infrared Mapping Spectrometer (NIMS) | * | 20 | 408 | visible to infrared |

### Interactive Cube Demonstration¶

## Cube Demo¶

## What Are Pixels?¶

The individual cells within a cube are called pixels. Each pixel in a cube has a location, which is similar to rectangular coordinates (i.e.., (samples, lines, bands)). A cube can be as small as one sample, by one line, by one band (1,1,1). If we had a cube of this size, it would contain only one pixel. A cube can be as large as thousands of samples, by thousands of lines, by thousands of bands. A cube with dimensions (1000, 1000, 1000) would contain one billion pixels.

Move your mouse cursor over the cube (above) and pay attention to the sample/line positions of each pixel shown below the cube:

Did you notice that sample 1 is on the left edge of the image and line 1 is on the top edge. Therefore, to figure out the coordinates of a pixel, count lines and samples staring with 1,1 in the upper left corner and move down and to the right.

How many samples and lines are in this cube?

# Bit Type Basics¶

Computers store values in base-2 or binary (see glossary below). Values are generally limited to 8, 16, or 32 binary digits, or bits. We refer to the number of bits per value as the bit type. Understanding the bit type and related attributes of an ISIS image cube is important for a variety of reasons. For instance, changing the bit type affects the file size, and a cube's bit type determines the range and number of values that can be stored in a cube.

There are three bit types utilized in ISIS:

Bit Type | Name | Number of Bytes | Range |
---|---|---|---|

8 | Unsigned Byte | 1 | 0 to 255 |

16 | Signed Word | 2 | -32768 to 32767 |

32 | Real | 4 | -3.40282E+38 to 3.04282E+38 |

As shown in the illustration below, there are 8 bits in 1 byte, and 16 bits in 2 bytes. A 16-bit value is called a word.

There are 8 bits in 1 byte, and 16 bits in 2 bytes. A 16-bit value is called a word.

There are 256 possible values (called digital numbers, or DNs) that can be represented in an 8-bit file. If all the bits above are set to 1, the output DN value would be 255. The values 0 to 255 are derived by setting different bit positions to 0 or 1. The example below shows the binary number stored by the computer, and the corresponding DN value the user would see on a computer monitor.

Binary Number | DN Value |
---|---|

00000000 | 0 |

00000001 | 1 |

00000010 | 2 |

... | ... |

11111110 | 254 |

11111111 | 255 |

As you increase the number of bits, the number of possible DN values that can be represented also increases.

### Glossary & Review¶

**Binary**: Refers to the base-2 numeral system. For an in depth discussion of the binary numeral system, see this Wikipedia encyclopedia entry for Binary numeral system.**Bit**: Is short for binary digit, which in a computer is the smallest unit of storage. Bits are either "0" or "1".**Byte**: Is short for binary term. A byte is a collection of computer bits. On many modern computers, a byte is a group of eight bits. Typically, computers handle and store information in binary (base-2), and a group of eight bits represents an eight digit binary number.**Bit type**: Refers to how many bits there are per single meaningful value in an image cube file.**DN**: An abbreviation of digital number. For images, particularly ISIS cubes, a DN is also referred to as a pixel.

## Pixel Values: Digital Numbers¶

Each pixel contains a numerical value, often referred to as the digital number (DN). Low DNs typically show up as black in the image and high DN as white. DNs represent real world values such as:

- Radiance - A measurement describing the amount of electromagnetic energy emitted from an area of a planet
- Reflectance - The ratio of reflected energy to incoming energy
- Elevation - The height above or below a fixed point on the surface of a body
- Emissivity - A measure describing a substances ability to absorb and radiate electromagnetic energy

## Core Base and Multiplier Basics¶

Recall that a [digital Number] is the content of a pixel. These numbers are used to represent real world values such as:

- Radiance - A measurement describing the amount of electromagnetic energy emitted from an area of a planet.
- Reflectance - The ratio of reflected energy to incoming energy
- Elevation - The height above or below a fixed point on the surface of a body
- Emissivity - A measure describing a substances ability to absorb and radiate electromagnetic energy.

Let's assume we have an 8-bit cube with values representing the elevation in meters. Unfortunately 8-bit pixels have a range of 0 to 255, which is very restrictive for elevation. ISIS3 deals with this problem by using a Core Base and Multiplier. Each DN is really treated as a floating point number in all ISIS3 programs.

In the example to the right, use mouse to examine the values in an 8-bit elevation cube, then change the multiplier and base notice how the values change.

Hold your mouse over the questions to see the answers

Change the multiplier to 100. Re-examine the image. Do the elevations range from 0 to 25500 meters?

## Sub-Pixel Definition¶

ISIS3 programs and users often need to interact at the sub-pixel level. That is, fractional pixel positions. The integral sample/line position is defined to be the center of a pixel.

In the example to the right, use mouse to examine the pixel positions in a cube. Hold your mouse over the question to see the answer.

- What is the sample position on the left edge of the cube?
- What is the sample position on the right edge of the first pixel?
- What is the line position on the bottom edge of the cube?

## Summary¶

Cubes are made up of individual pixels. Each pixel usually represents some area of a planet, moon, astroid or other body. Pixels hold a DN (digital number). That number can be one, two or four bytes long depending on the accuracy necessary to represent the data. DNs can be modified by a "Base" and "Multiplier". The columns of a cube are called samples, the rows are called lines and a plane of samples and lines is called a band.