Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search
USGS

Isis 3 Application Documentation

phocube

Printer Friendly View | TOC | Home

Creates a choice of multiple information bands for an image cube

Overview Parameters

Description

Phocube creates an output cube where each band represents a choice of information computed from SPICE for every pixel. The choices of information ranges from photometric angles (phase, emission, incidence) to various azimuth angles and resolution values.

The input cube is required to have had a successful 'spiceinit' applied previous to running phocube.

The BandBin group on the output image cube labels will be updated. The "Name" keyword within the BandBin will be popluated with the names of the selected information bands. These bands can be referenced by their names in applications such as mapmos and qview.

Phocube can be applied to a Level1 or Level2 image cube.

Categories

Related Applications in Previous Versions of Isis

This application replaces the following applications existing in previous versions of Isis, which have been deprecated from the current version of Isis:
  • lev1geoplane
  • levgeoplane
  • geoback

History

Unknown1999-02-11 Original version
Stuart Sides2003-06-04 Converted to Isis 3.0, and made it create a cube rather than adding backplanes.
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Stuart Sides2005-09-09 Fixed problem where the program through an error when it tried to propagate the pixel type from the input file.
Stuart Sides2005-09-09 Added the bandbin group to the cube labels.
Jeff Anderson2005-09-20 Fixed a bug with switched samples and lines
Elizabeth Miller2005-10-05 Moved into Photometry and Radiometry category
Elizabeth Miller2006-05-23 Modified to use ProcessByBrick instead of ProcessByLine to make faster
Brendan George2006-09-21 Documentation fixes
Steven Lambright2008-05-13 Removed references to CubeInfo
Steven Koechle2008-08-19 Added new parameters: PIXELRESOLUTION, LINERESOLUTION, SAMPLERESOLUTION, DETECTORRESOLUTION, NORTHAZIMUTH, SUNAZIMUTH, SPACECRAFTAZIMUTH, OFFNADIRANGLE
Steven Lambright2009-03-06 Fixed a bug that occurred when processing band-dependant cubes
Kris Becker2009-05-29 Added the propagation of the input cube labels, objects, blobs, etc..., so the pedigree of the input source is retained.
Sharmila Prasad2009-07-17 Set the defaults for PIXELRESOLUTION, LINERESOLUTION, SAMPLERESOLUTION, DETECTORRESOLUTION, NORTHAZIMUTH, SUNAZIMUTH, SPACECRAFTAZIMUTH, OFFNADIRANGLE to FALSE
Mackenzie Boyd2010-10-29 Added parameters/bands SUBSPACECRAFTGROUNDAZIMUTH and SUBSOLARGROUNDAZIMUTH.
Travis Addair2011-02-10 Added parameters LOCALINCIDENCE and LOCALEMISSION.
Kris Becker2011-08-08 Added the option to propagate the input pixel value (DN) as the first band (however, this, by default, will not be invoked as default so as to preserve pre-existing behavior). Ensure the Center, OriginalBand, Name, and Width BandBin keyword values are populated properly and propagated to the output label (should support camera models). Added MORPHOLOGY and ALBEDO backplane options for special mosaic options.

Parameter Groups

Files

Name Description
FROM Input cube
TO Output cube

Photometry

Name Description
DNPropagate the input pixel to the output file.
PHASECreate a phase angle band.
EMISSIONCreate an emission angle band.
INCIDENCECreate an incidience angle band.
LOCALEMISSIONCreate a local emission angle band.
LOCALINCIDENCECreate a local incidience angle band.
LATITUDECreate a latitude band.
LONGITUDECreate a longitude band.
PIXELRESOLUTIONCreate a pixel resolution band.
LINERESOLUTIONCreate a line resolution band.
SAMPLERESOLUTIONCreate a sample resolution band.
DETECTORRESOLUTIONCreate a detector resolution band.
NORTHAZIMUTHCreate a north azimuth band.
SUNAZIMUTHCreate a sun azimuth band.
SPACECRAFTAZIMUTHCreate a spacecraft azimuth band.
OFFNADIRANGLECreate a offNadir angle band.
SUBSPACECRAFTGROUNDAZIMUTHCreata a sub spacecraft ground azimuth band.
SUBSOLARGROUNDAZIMUTHCreate a sub solar ground azimuth band.
MORPHOLOGYCreate a morphology index band
ALBEDOCreate an albedo index band
X

Files: FROM

Description

Use this parameter to select the input filename. The application, spiceinit, must be successfully applied previously to running phocube. The input image cube can be a Level1 or Level2.

Type cube
File Mode input
Filter *.cub
Close Window
X

Files: TO

Description

This output cube file will contain the bands of the chosen information. The BandBin Group on the labels of the output cube will be updated with the Name keyword containing the output band names in the order that they are stacked within the cube.

Type cube
File Mode output
Pixel Type real
Close Window
X

Photometry: DN

Description

If this parameter is true then the input image pixel value (DN) will be propagated to the output file. This will help alleviate potential additional runs of cubeit when necessary. When this option is selected, the BandBin values are retained for this band so that geometry operations are preserved.

Type boolean
Default FALSE
Close Window
X

Photometry: PHASE

Description

If this parameter is true, then for every input pixel, a Phase Angle will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=PhaseAngle in the output band order. PhaseAngle is in degrees.

Type boolean
Default TRUE
Close Window
X

Photometry: EMISSION

Description

If this parameter is true, then for every input pixel, a Emission Angle will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=EmissionAngle in the output band order. EmissionAngle is in degrees.

Type boolean
Default TRUE
Close Window
X

Photometry: INCIDENCE

Description

If this parameter is true, then for every input pixel, a Incidence Angle will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=IncidenceAngle in the output band order. IncidenceAngle is in degrees.

Type boolean
Default TRUE
Close Window
X

Photometry: LOCALEMISSION

Description

If this parameter is true then a Local Emission Angle will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=LocalEmissionAngle in the output band order. LocalIncidenceAngle is in degrees.

Type boolean
Default FALSE
Close Window
X

Photometry: LOCALINCIDENCE

Description

If this parameter is true then a Local Incidence Angle will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=LocalIncidenceAngle in the output band order.

Type boolean
Default FALSE
Close Window
X

Photometry: LATITUDE

Description

If this parameter is true, then for every input pixel, a Latitude value will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=Latitude in the output band order. Latitude is in degrees.

Type boolean
Default TRUE
Close Window
X

Photometry: LONGITUDE

Description

If this parameter is true, then for every input pixel, a Longitude value will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=Longitude in the output band order. Longitude is in degrees.

Type boolean
Default TRUE
Close Window
X

Photometry: PIXELRESOLUTION

Description

If this parameter is true, then for every input pixel, a Pixel Resolution will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=PixelResolution in the output band order. PixelResolution is in meters.

Type boolean
Default FALSE
Close Window
X

Photometry: LINERESOLUTION

Description

If this parameter is true, then for every input pixel, a Line Resolution will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=LineResolution in the output band order. LineResolution is in meters.

Type boolean
Default FALSE
Close Window
X

Photometry: SAMPLERESOLUTION

Description

If this parameter is true, then for every input pixel, a Sample Resolution will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=SampleResolution in the output band order. SampleResolution is in meters.

Type boolean
Default FALSE
Close Window
X

Photometry: DETECTORRESOLUTION

Description

If this parameter is true, then for every input pixel, a Detector Resolution will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=DetectorResolution in the output band order. DetectorResolution is in millimeters.

Type boolean
Default FALSE
Close Window
X

Photometry: NORTHAZIMUTH

Description

If this parameter is true, then for every input pixel, a North Azimuth will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=NorthAzimuth in the output band order. NorthAzmith is in degree angles.

Type boolean
Default FALSE
Close Window
X

Photometry: SUNAZIMUTH

Description

If this parameter is true, then for every input pixel, a Sun Azimuth will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=SunAzimuth in the output band order. SunAzimuth is in degree angles.

Type boolean
Default FALSE
Close Window
X

Photometry: SPACECRAFTAZIMUTH

Description

If this parameter is true, then for every input pixel, a Spacecraft Azimuth will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=SpacecraftAzimuth in the output band order. SpacecraftAzimuth is in degree angles.

Type boolean
Default FALSE
Close Window
X

Photometry: OFFNADIRANGLE

Description

If this parameter is true, then for every input pixel, a Off Nadir Angle will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=OffNadirAngle in the output band order. OffNadirAngle is in degrees.

Type boolean
Default FALSE
Close Window
X

Photometry: SUBSPACECRAFTGROUNDAZIMUTH

Description

If this parameter is true, then for every input pixel, a Spacecraft Ground Azimuth will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=SubSpacecraftGroundAzimuth in the output band order. SubSpacecraftGroundAzimuth is in degree angles.

Type boolean
Default FALSE
Close Window
X

Photometry: SUBSOLARGROUNDAZIMUTH

Description

If this parameter is true, then for every input pixel, a SubSolar Ground Azimuth will be computed and placed in a band in the output cube. The output cube labels will contain Group=BandBin Name=SubSolarGroundAzimuth in the output band order. SubSolarGroundAzimuth is in degree angles.

Type boolean
Default FALSE
Close Window
X

Photometry: MORPHOLOGY

Description

This band is computed from the resolution and emission angle using the following formula: MORPHOLOGY = PIXELRESOLUTION / cos(EMISSION). The resulting output band can then be used by 'automos' to create a morphology-based mosaic product. This option will always use the local emission angle if the input file was initialized (spiceinit) with an elevation model (DEM). If not, it will use the default calculation (from the ellipsoid). All values are tested for zero values and set to a constant very close to zero so all pixels should have real values.

To utilize the this backplane in automos, add the parameters priority=band type=keyword keyname=Name keyvalue=morphology criteria=lesser. See automos documentation for further details.

Type boolean
Default FALSE
Close Window
X

Photometry: ALBEDO

Description

This band is computed from the resolution, incidence and emission angles using the following formula: ALBEDO = PIXELRESOLUTION * [ (1 / cos(EMISSION)) + (1 / cos(INCIDENCE)) ] . The resulting output band can then be used automos to create an albedo-based mosaic product. This option will always use the local emission and incidence angles if the input file was initialized (spiceinit) with an elevation model (DEM). If not, it will use the default calculation (from the ellipsoid). All values are tested for zero values and set to a constant very close to zero so all pixels should have real values.

To utilize the this backplane in automos, add the parameters priority=band type=keyword keyname=Name keyvalue=albedo criteria=lesser. See automos documentation for further details.

Type boolean
Default FALSE
Close Window