Isis 3 Application Documentation
phocube | Standard View | TOC | Home |
Creates a choice of multiple information bands for an image cube
Description
Categories
Groups
History
Things To Do
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.
Name | Description |
---|---|
FROM | Input cube |
TO | Output cube |
Name | Description |
---|---|
DN | Propagate the input pixel to the output file. |
PHASE | Create a phase angle band. |
EMISSION | Create an emission angle band. |
INCIDENCE | Create an incidience angle band. |
LOCALEMISSION | Create a local emission angle band. |
LOCALINCIDENCE | Create a local incidience angle band. |
LATITUDE | Create a latitude band. |
LONGITUDE | Create a longitude band. |
PIXELRESOLUTION | Create a pixel resolution band. |
LINERESOLUTION | Create a line resolution band. |
SAMPLERESOLUTION | Create a sample resolution band. |
DETECTORRESOLUTION | Create a detector resolution band. |
NORTHAZIMUTH | Create a north azimuth band. |
SUNAZIMUTH | Create a sun azimuth band. |
SPACECRAFTAZIMUTH | Create a spacecraft azimuth band. |
OFFNADIRANGLE | Create a offNadir angle band. |
SUBSPACECRAFTGROUNDAZIMUTH | Creata a sub spacecraft ground azimuth band. |
SUBSOLARGROUNDAZIMUTH | Create a sub solar ground azimuth band. |
MORPHOLOGY | Create a morphology index band |
ALBEDO | Create an albedo index band |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Unknown | 1999-02-11 | Original version |
Stuart Sides | 2003-06-04 | Converted to Isis 3.0, and made it create a cube rather than adding backplanes. |
Stuart Sides | 2003-07-29 | Modified filename parameters to be cube parameters where necessary |
Stuart Sides | 2005-09-09 | Fixed problem where the program through an error when it tried to propagate the pixel type from the input file. |
Stuart Sides | 2005-09-09 | Added the bandbin group to the cube labels. |
Jeff Anderson | 2005-09-20 | Fixed a bug with switched samples and lines |
Elizabeth Miller | 2005-10-05 | Moved into Photometry and Radiometry category |
Elizabeth Miller | 2006-05-23 | Modified to use ProcessByBrick instead of ProcessByLine to make faster |
Brendan George | 2006-09-21 | Documentation fixes |
Steven Lambright | 2008-05-13 | Removed references to CubeInfo |
Steven Koechle | 2008-08-19 | Added new parameters: PIXELRESOLUTION, LINERESOLUTION, SAMPLERESOLUTION, DETECTORRESOLUTION, NORTHAZIMUTH, SUNAZIMUTH, SPACECRAFTAZIMUTH, OFFNADIRANGLE |
Steven Lambright | 2009-03-06 | Fixed a bug that occurred when processing band-dependant cubes |
Kris Becker | 2009-05-29 | Added the propagation of the input cube labels, objects, blobs, etc..., so the pedigree of the input source is retained. |
Sharmila Prasad | 2009-07-17 | Set the defaults for PIXELRESOLUTION, LINERESOLUTION, SAMPLERESOLUTION, DETECTORRESOLUTION, NORTHAZIMUTH, SUNAZIMUTH, SPACECRAFTAZIMUTH, OFFNADIRANGLE to FALSE |
Mackenzie Boyd | 2010-10-29 | Added parameters/bands SUBSPACECRAFTGROUNDAZIMUTH and SUBSOLARGROUNDAZIMUTH. |
Travis Addair | 2011-02-10 | Added parameters LOCALINCIDENCE and LOCALEMISSION. |
Kris Becker | 2011-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. |