Isis Cube Format

From Isis Workshop

Jump to: navigation, search

Contents

[edit] What Is A Cube?

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

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.


Image Data Dimensions from Planetary Missions (*) means the number of lines per image is variable


Image Data Dimensions from Planetary Missions
(*) means the number of lines per image is variable
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 1-2 1056 1204 1 ? blue, minus-blue, violet, green, red, clear
Mars Global Surveyor - Mars Oribiter Camera Wide Angle (MOC-WA) * 3456 1 blue, red
Mars Global Surveyor - Mars Oribiter Camera Narrow Angle (MOC-NA) * 2048 1 bandwidth encompases visible and near-infrared
Galileo Near-Infrared Mapping Spectrometer (NIMS) * 20 408 visible to infrared


[edit] Interactive Cube Demonstration

User Defined Applet


[edit] What Are Pixels?

Counting Pixels: Lines and Samples


User Defined Applet

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 (right) 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?

[edit] 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

Click on the pixel at sample 8, line 6 and adjust the slider (above the Reset button) to see how the pixel changes in the image:

  • When the DN value is 163, how does pixel visually change? Does this make sense?


[edit] Bit Type Basics

Introduction to Bit Types

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.

uploaded image: 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.


[edit] Glossary & Review

  • Binary: Refers to the base-2 numeral system. For an indepth 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.

[edit] Bit Type and File Size

The bit type of a cube affects the physical size of a file. That is, 32-bit (real) cubes are four times bigger than 8-bit (unsigned byte) cubes, so long as they have the same dimensions. In general, the size of a file will be the product of the number of lines (NL), the number of samples (NS), and the number of bands (NB) for 8-bit cubes (i.e. NS*NL*NB), twice that amount for 16-bit and four times that amount for 32-bit.


Calculate image data size

Number of lines:

Number of samples:

select bit type:

select output units:


The data size is:



The bit type of a new cube is automatically set when an Isis application runs.


[edit] Core Base and Multiplier Basics

Recall that a digital Number (DN) 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. Isis deals with this problem by using a Core Base and Multiplier. Each DN is really treated as a floating point number in all Isis 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?

Change the base to -500. What is the range of pixel values?

User Defined Applet


[edit] Important Notes:

  • The equation applied to 8-bit and 16-bit cubes is DN = Base + (stored value * Multipler).
  • Base and Multiplier are not used for 32-bit cubes.
  • It is much easier to think of all Isis cubes as 32-bit even though they may be stored as 8-bit or 16-bit.


[edit] Sub-Pixel Definition

User Defined Applet


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



[edit] 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.

Personal tools
Work Shops