USGS

Isis 3.0 Developer's Reference (API)

Home

Isis::ProcessExport Class Reference

Process class for exporting cubes. More...

#include <ProcessExport.h>

Inherits Isis::Process.

Inherited by Isis::ProcessExportPds.

Public Types

enum  ExportFormat { BSQ, BIL, BIP, JP2 }
 Storage order enumeration. More...
 

Public Member Functions

 ProcessExport ()
 Constructs an Export object.
 
virtual ~ProcessExport ()
 Destructor.
 
virtual void StartProcess (void funct(Isis::Buffer &in))
 This method invokes the process operation over a single input cube.
 
virtual void StartProcess (void funct(std::vector< Isis::Buffer * > &in))
 
virtual void StartProcess (std::ofstream &fout)
 Write an entire cube to an output file stream.
 
void SetOutputRange (const double minimum, const double maximum)
 Set output pixel range in Buffer.
 
void SetOutputNull (const double value)
 Set output special pixel value for NULL.
 
void SetOutputLis (const double value)
 Set output special pixel value for LIS.
 
void SetOutputLrs (const double value)
 Set output special pixel value for LRS.
 
void SetOutputHis (const double value)
 Set output special pixel value for HIS.
 
void SetOutputHrs (const double value)
 Set output special pixel value for HRS.
 
double OutputNull ()
 Return the output special pixel value for NULL.
 
double OutputLis ()
 Return the output special pixel value for LIS.
 
double OutputLrs ()
 Return the output special pixel value for LRS.
 
double OutputHis ()
 Return the output special pixel value for HIS.
 
double OutputHrs ()
 Return the output special pixel value for HRS.
 
bool HasInputRange () const
 
void SetInputRange ()
 Set input pixel range from user.
 
void SetInputRange (const double minimum, const double maximum)
 Set input pixel range from to a linear stretch.
 
void SetInputRange (const double minimum, const double maximum, const int index)
 Set input pixel range from to a linear stretch.
 
void SetInputRange (const double minimum, const double middle, const double maximum)
 Set input pixel range from to a piecewise linear stretch.
 
void SetInputRange (const double minimum, const double middle, const double maximum, const int index)
 Set input pixel range from to a piecewise linear stretch.
 
void CreateWorldFile (const QString &worldFile)
 Create a standard world file for the input cube.
 
void SetOutputEndian (enum ByteOrder endianness)
 Set byte endianness of the output cube.
 
void SetOutputType (Isis::PixelType pixelIn)
 Set output pixel bit type in Buffer.
 
double GetInputMinimum (unsigned int n=0) const
 Get the valid minimum pixel value for the Nth input cube.
 
double GetInputMaximum (unsigned int n=0) const
 Get the valid maximum pixel value for the Nth input cube.
 
double GetOutputMinimum ()
 Get the valid minimum pixel value to be written to the output file.
 
double GetOutputMaximum ()
 Get the valid maximum pixel value to be written to the output file.
 
void setFormat (ExportFormat format)
 Sets the storage order of the output file.
 
template<typename Functor >
void ProcessCubes (const Functor &functor)
 
virtual void StartProcess (void funct())
 In the base class, this method will invoked a user-specified function exactly one time.
 
virtual void EndProcess ()
 End the processing sequence and cleans up by closing cubes, freeing memory, etc.
 
virtual void Finalize ()
 Cleans up by closing cubes and freeing memory for owned cubes.
 
virtual Isis::CubeSetInputCube (const QString &parameter, const int requirements=0)
 Opens an input cube specified by the user and verifies requirements are met.
 
virtual Isis::CubeSetInputCube (const QString &fname, const Isis::CubeAttributeInput &att, int requirements=0)
 Opens an input cube specified by the programmer and verifies requirements are met.
 
virtual void SetInputCube (Isis::Cube *inCube)
 Set the InputCube vector to an opened Cube which was dynamically allocated.
 
virtual Isis::CubeSetOutputCube (const QString &parameter)
 Allocates a user-specified output cube whose size matches the first input cube.
 
virtual Isis::CubeSetOutputCube (const QString &parameter, const int nsamps, const int nlines, const int nbands=1)
 Allocates a user specified output cube whose size is specified by the programmer.
 
virtual Isis::CubeSetOutputCube (const QString &fname, const Isis::CubeAttributeOutput &att, const int nsamps, const int nlines, const int nbands=1)
 Allocates a output cube whose name and size is specified by the programmer.
 
void AddInputCube (Cube *cube, bool owned=true)
 
void AddOutputCube (Cube *cube, bool owned=true)
 
void ClearCubes ()
 Close owned cubes from the list and clear the list.
 
void ClearInputCubes ()
 Close owned input cubes from the list and clear the list.
 
void ClearOutputCubes ()
 Close owned output cubes from the list and clear the list.
 
void PropagateLabels (const bool prop)
 This method allows the programmer to turn on/off the propagation of labels from the 1st input cube to any of the output cubes.
 
void PropagateLabels (const QString &cube)
 This method allows the programmer to propagate labels from a specific secondary cube.
 
void PropagateTables (const bool prop)
 This method allows the programmer to propagate input tables to the output cube (default is true)
 
void PropagateTables (const QString &fromName)
 Propagate the tables from the cube with the given filename to the output cube.
 
void PropagatePolygons (const bool prop)
 This method allows the programmer to propagate input blobs to the output cube (default is true)
 
void PropagateHistory (const bool prop)
 This method allows the programmer to propagate history to the output cube (default is true)
 
void PropagateOriginalLabel (const bool prop)
 This method allows the programmer to propagate original labels to the output cube (default is true)
 
Isis::ProgressProgress ()
 This method returns a pointer to a Progress object.
 
QString MissionData (const QString &mission, const QString &file, bool highestVersion=false)
 This method reads the mission specific data directory from the user preference file, makes sure that mission is available in the Isis installation, and the attaches the provided input file to the directory in order to create a full file specification.
 
void WriteHistory (Cube &cube)
 Writes out the History blob to the cube.
 
void CalculateStatistics ()
 Calculates and stores off statistics on every band of every cube added to this process via the SetInputCube method.
 
std::vector< Isis::Statistics * > BandStatistics (const unsigned index)
 Get the vector of Statistics objects for each band separately of a specified input cube.
 
Isis::StatisticsCubeStatistics (const unsigned index)
 Get the Statistics object for all bands of a specified input cube.
 

Protected Member Functions

std::vector< BufferManager * > GetBuffers ()
 
std::vector< BufferManager * > GetBuffersBSQ ()
 A single line of input data from each input cube will be passed to the line processing function.
 
std::vector< BufferManager * > GetBuffersBIL ()
 A single line of input data from each input cube will be passed to the line processing function.
 
std::vector< BufferManager * > GetBuffersBIP ()
 A single band of input data from each input cube will be passed to the band processing function.
 

Protected Attributes

ExportFormat p_format
 Current storage order.
 
double p_outputMinimum
 Desired minimum pixel value in the Buffer.
 
double p_outputMiddle
 
  Middle pixel value (minimum+maximun)/2.0 in

the Buffer

 
double p_outputMaximum
 Desired maximum pixel value in the Buffer.
 
std::vector< double > p_inputMinimum
 Minimum pixel value in the input cube to be mapped to the minimum value in the Buffer.
 
std::vector< double > p_inputMiddle
 Middle pixel value in the input cube to be mapped to the (minimum+maximum)/2.0 value in the Buffer.
 
std::vector< double > p_inputMaximum
 Maximum pixel value in the input cube to be mapped to the maximum value in the Buffer.
 
EndianSwapperp_endianSwap
 
Object to swap the endianness of the

raw output to either MSB or LSB

 
ByteOrder p_endianType
 The byte order of the output file.
 
PixelType p_pixelType
 The bits per pixel of the output image.
 
std::vector< Stretch * > p_str
 Stretch object to ensure a reasonable range of pixel values in the output data.
 
double p_Null
 The output value for pixels whose input DNs are Null values.
 
double p_Lis
 
  The output value for pixels whose input DNs are 

Low Instrument Saturation values.

 
double p_Lrs
 
  The output value for pixels whose input DNs are 

Low Representation Saturation values.

 
double p_His
 
  The output value for pixels whose input DNs are 

High Instrument Saturation values.

 
double p_Hrs
 
  The output value for pixels whose input DNs are 

High Representation Saturation values.

 
bool p_Null_Set
 
 Indicates whether p_Null has been set 

(i.e.

 
bool p_Lis_Set
 
  Indicates whether p_Lis has been set 

(i.e.

 
bool p_Lrs_Set
 
  Indicates whether p_Lrs has been set 

(i.e.

 
bool p_His_Set
 
  Indicates whether p_His has been set 

(i.e.

 
bool p_Hrs_Set
 
  Indicates whether p_Hrs has been set 

(i.e.

 
Isis::Progressp_progress
 Pointer to a Progress object.
 
bool p_propagateLabels
 Flag indicating if labels are be propagated to output cubes.
 
bool p_propagateTables
 Flag indicating if tables are be propagated to output cubes.
 
bool p_propagatePolygons
 Flag indicating if blobs are be propagated to output cubes.
 
bool p_propagateHistory
 Flag indicating if history is to be propagated to output cubes.
 
bool p_propagateOriginalLabel
 Flag indicating if original lable is to be propagated to output cubes.
 
std::vector< std::vector
< Isis::Statistics * > > 
p_bandStats
 Holds the calculated statistics for each band separately of every input cubei after the CalculateStatistics method is called.
 
std::vector< Isis::Statistics * > p_cubeStats
 Holds the calculated statistics for every band together of every input cubei after the CalculateStatistics method is called.
 
std::vector< Isis::Cube * > InputCubes
 A vector of pointers to opened Cube objects.
 
std::vector< Isis::Cube * > OutputCubes
 A vector of pointers to allocated Cube objects.
 
QSet< Isis::Cube * > * m_ownedCubes
 A list of cubes owned by this instant.
 

Detailed Description

Process class for exporting cubes.

This class allows a programmer to develop applications which export Isis cubes into another format. For example, isis2jpg or isis2tif. It is highly recommended that this object be utilized when developing export applications to ensure a consistent look-and-feel for Isis users. The class operates by passing the programmer a line of cube data at a time. It is up to the programmer to write this data to the foreign output format. An ability exists to stretch the data supplied to the programmer in one of three ways. Either an automatic linear stretch, an automatic piecewise stretch, or an manual linear stretch. There are various methods which specify how the input pixels are to be stretched to an output range. You can examine the isis2jpg application code as a guide for writing an export program. Currently this class only allows for one band of a cube to be exported.

If you would like to see ProcessExport being used in implementation, see isis2jpg.cpp

Author
2003-03-31 Jeff Anderson

Member Enumeration Documentation

Storage order enumeration.

Enumerator
BSQ 

Band sequential.

BIL 

Band interleaved by line.

BIP 

Band interleaved by pixel.

JP2 

Compressed JPEG2000.

Constructor & Destructor Documentation

Isis::ProcessExport::~ProcessExport ( )
virtual

Destructor.

References p_endianSwap, and p_str.

Member Function Documentation

void Isis::Process::AddInputCube ( Cube cube,
bool  owned = true 
)
inherited
void Isis::Process::AddOutputCube ( Cube cube,
bool  owned = true 
)
inherited
std::vector<Isis::Statistics *> Isis::Process::BandStatistics ( const unsigned  index)
inlineinherited

Get the vector of Statistics objects for each band separately of a specified input cube.

Parameters
indexThe index of the input cube in InputCubes
Returns
vector<Statistics*> A list of statistics ordered by band

References Isis::Process::p_bandStats.

void Isis::Process::CalculateStatistics ( )
inherited

Calculates and stores off statistics on every band of every cube added to this process via the SetInputCube method.

The newly calculated statistics are stored in two ways: as a vector where each entry is a single Statistics object for every band of a particular input cube, and as a vector where each entry is a vector of Statistics objects, for each band separately, of a particular input cube.

References Isis::Statistics::AddData(), Isis::Cube::bandCount(), Isis::Progress::CheckStatus(), Isis::Buffer::DoubleBuffer(), Isis::Cube::lineCount(), Isis::Cube::read(), Isis::LineManager::SetLine(), Isis::Progress::SetMaximumSteps(), Isis::Progress::SetText(), Isis::Buffer::size(), and Isis::toString().

void Isis::Process::ClearCubes ( )
inherited

Close owned cubes from the list and clear the list.

void Isis::Process::ClearInputCubes ( )
inherited

Close owned input cubes from the list and clear the list.

Referenced by Isis::ProcessMapMosaic::RingsSetOutputCube(), and Isis::ProcessMapMosaic::SetOutputCube().

void Isis::Process::ClearOutputCubes ( )
inherited

Close owned output cubes from the list and clear the list.

void Isis::ProcessExport::CreateWorldFile ( const QString &  worldFile)

Create a standard world file for the input cube.

This method creates a standard world file from the mapping group of the input cube.

Parameters
worldFile[in] Reference to a string containing the name of a file to write the world information to.

References Isis::Process::InputCubes, Isis::Projection::Resolution(), Isis::Projection::SetWorld(), Isis::Projection::XCoord(), and Isis::Projection::YCoord().

Isis::Statistics* Isis::Process::CubeStatistics ( const unsigned  index)
inlineinherited

Get the Statistics object for all bands of a specified input cube.

Parameters
indexThe index of the input cube in InputCubes
Returns
Statistics* Collections of statistics gathered on all bands

References Isis::Process::p_cubeStats.

void Isis::Process::EndProcess ( )
virtualinherited

End the processing sequence and cleans up by closing cubes, freeing memory, etc.

Deprecated:
Please use Finalize()

Reimplemented in Isis::ProcessImportPds, Isis::ProcessByBrick, Isis::ProcessByBoxcar, Isis::ProcessByTile, Isis::ProcessGroundPolygons, and Isis::ProcessPolygons.

Referenced by Isis::ProcessByBoxcar::EndProcess().

void Isis::Process::Finalize ( )
virtualinherited

Cleans up by closing cubes and freeing memory for owned cubes.

Clears the lists for all cubes.

Reimplemented in Isis::ProcessImportPds, Isis::ProcessByBrick, Isis::ProcessByBoxcar, Isis::ProcessByTile, Isis::ProcessGroundPolygons, and Isis::ProcessPolygons.

Referenced by Isis::ProcessByBoxcar::Finalize().

vector< BufferManager * > Isis::ProcessExport::GetBuffers ( )
protected
vector< BufferManager * > Isis::ProcessExport::GetBuffersBIL ( )
protected

A single line of input data from each input cube will be passed to the line processing function.

Note the data will be stretched based on the invocations of the SetInputRange and SetOutputRange methods.

Parameters
funct(Isis::Buffer &b) Name of your line processing function. The buffer in will contain stretched input cube pixels for an entire line of each input cube. These pixels must be written to the foreign output file (e.g, jpg, tif, etc).

References _FILEINFO_, Isis::BufferManager::begin(), Isis::Process::InputCubes, and Isis::IException::Programmer.

Referenced by GetBuffers().

vector< BufferManager * > Isis::ProcessExport::GetBuffersBIP ( )
protected

A single band of input data from each input cube will be passed to the band processing function.

Note the data will be stretched based on the invocations of the SetInputRange and SetOutputRange methods.

Parameters
funct(Isis::Buffer &b) Name of your band processing function. The buffer in will contain stretched input cube pixels for an entire line of each input cube. These pixels must be written to the foreign output file (e.g, jpg, tif, etc).

References _FILEINFO_, Isis::BufferManager::begin(), Isis::Process::InputCubes, and Isis::IException::Programmer.

Referenced by GetBuffers().

vector< BufferManager * > Isis::ProcessExport::GetBuffersBSQ ( )
protected

A single line of input data from each input cube will be passed to the line processing function.

Note the data will be stretched based on the invocations of the SetInputRange and SetOutputRange methods.

Parameters
funct(Isis::Buffer &b) Name of your line processing function. The buffer in will contain stretched input cube pixels for an entire line of each input cube. These pixels must be written to the foreign output file (e.g, jpg, tif, etc).

References _FILEINFO_, Isis::BufferManager::begin(), Isis::Process::InputCubes, and Isis::IException::Programmer.

Referenced by GetBuffers().

double Isis::ProcessExport::GetInputMaximum ( unsigned int  n = 0) const

Get the valid maximum pixel value for the Nth input cube.

References _FILEINFO_, p_inputMaximum, and Isis::IException::Programmer.

double Isis::ProcessExport::GetInputMinimum ( unsigned int  n = 0) const

Get the valid minimum pixel value for the Nth input cube.

References _FILEINFO_, p_inputMinimum, and Isis::IException::Programmer.

double Isis::ProcessExport::GetOutputMaximum ( )
inline

Get the valid maximum pixel value to be written to the output file.

References p_outputMaximum.

double Isis::ProcessExport::GetOutputMinimum ( )
inline

Get the valid minimum pixel value to be written to the output file.

References p_outputMinimum.

bool Isis::ProcessExport::HasInputRange ( ) const

References p_inputMinimum.

Referenced by Isis::ImageExporter::write().

QString Isis::Process::MissionData ( const QString &  mission,
const QString &  file,
bool  highestVersion = false 
)
inherited

This method reads the mission specific data directory from the user preference file, makes sure that mission is available in the Isis installation, and the attaches the provided input file to the directory in order to create a full file specification.

Parameters
missionName of the mission data directory
fileName of the file to attach to the end of the directory
highestVersionIf set to true the method will return the highest version number of the given file. Therefore, file must contain question marks such as "file???.dat". See the FileName class for more information on versioned files. Defaults to false.

References _FILEINFO_, Isis::FileName::expanded(), Isis::FileName::fileExists(), Isis::PvlObject::findGroup(), Isis::FileName::highestVersion(), and Isis::Preference::Preferences().

double Isis::ProcessExport::OutputHis ( )

Return the output special pixel value for HIS.

References p_His, p_His_Set, and p_outputMaximum.

double Isis::ProcessExport::OutputHrs ( )

Return the output special pixel value for HRS.

References p_Hrs, p_Hrs_Set, and p_outputMaximum.

double Isis::ProcessExport::OutputLis ( )

Return the output special pixel value for LIS.

References p_Lis, p_Lis_Set, and p_outputMinimum.

double Isis::ProcessExport::OutputLrs ( )

Return the output special pixel value for LRS.

References p_Lrs, p_Lrs_Set, and p_outputMinimum.

double Isis::ProcessExport::OutputNull ( )

Return the output special pixel value for NULL.

References p_Null, p_Null_Set, and p_outputMinimum.

template<typename Functor >
void Isis::ProcessExport::ProcessCubes ( const Functor &  functor)
inline
void Isis::Process::PropagateHistory ( const bool  prop)
inherited

This method allows the programmer to propagate history to the output cube (default is true)

Parameters
propFlag indicating if history is to be propagated to output cubes.

Referenced by Isis::ProcessMapMosaic::RingsSetOutputCube(), and Isis::ProcessMapMosaic::SetOutputCube().

void Isis::Process::PropagateLabels ( const bool  prop)
inherited

This method allows the programmer to turn on/off the propagation of labels from the 1st input cube to any of the output cubes.

By default, propagation occurs automatically in the Process class when a call to either of the SetOutputCube methods is invoked. If the program * requires no propagation then utilize this method. This method can be invoked between successive calls of SetOutputCube so that some cube will have labels propagated while others will not.

Parameters
propFlag indicating if labels are be propagated to output cubes.

Referenced by Isis::ProcessMapMosaic::RingsSetOutputCube(), and Isis::ProcessMapMosaic::SetOutputCube().

void Isis::Process::PropagateLabels ( const QString &  cube)
inherited

This method allows the programmer to propagate labels from a specific secondary cube.

Parameters
cubeIString containing the name of the cube containing the labels to propagate.

References Isis::PvlObject::addGroup(), Isis::PvlObject::addObject(), Isis::PvlObject::findObject(), Isis::PvlObject::group(), Isis::PvlObject::groups(), and Isis::PvlObject::hasObject().

void Isis::Process::PropagateOriginalLabel ( const bool  prop)
inherited

This method allows the programmer to propagate original labels to the output cube (default is true)

Parameters
propFlag indicating if original labels is to be propagated to output cubes.

Referenced by Isis::ProcessMapMosaic::RingsSetOutputCube(), and Isis::ProcessMapMosaic::SetOutputCube().

void Isis::Process::PropagatePolygons ( const bool  prop)
inherited

This method allows the programmer to propagate input blobs to the output cube (default is true)

Parameters
propFlag indicating if input blobs are to be propagated to output cubes.

Referenced by Isis::ProcessMapMosaic::RingsSetOutputCube(), and Isis::ProcessMapMosaic::SetOutputCube().

void Isis::Process::PropagateTables ( const bool  prop)
inherited

This method allows the programmer to propagate input tables to the output cube (default is true)

Parameters
propFlag indicating if input tables are to be propagated to output cubes.

Referenced by Isis::ProcessMapMosaic::RingsSetOutputCube(), and Isis::ProcessMapMosaic::SetOutputCube().

void Isis::Process::PropagateTables ( const QString &  fromName)
inherited

Propagate the tables from the cube with the given filename to the output cube.

This is done at the time this method is called, not during normal processing.

References Isis::Cube::label(), Isis::PvlObject::object(), Isis::PvlObject::objects(), Isis::Cube::open(), and Isis::Cube::read().

void Isis::ProcessExport::setFormat ( ExportFormat  format)
inline

Sets the storage order of the output file.

References p_format.

Referenced by Isis::ImageExporter::initializeProcess(), and ProcessExport().

Isis::Cube * Isis::Process::SetInputCube ( const QString &  parameter,
const int  requirements = 0 
)
virtualinherited

Opens an input cube specified by the user and verifies requirements are met.

Returns
Cube*
Parameters
parameterUser parameter to obtain file to open. Typically, the value is "FROM". For example, the user can specify on the command line FROM=myfile.cub and this method will attempt to open the cube "myfile.cub" if the parameter was set to "FROM".
requirementsUse to specify requirements for the input file. The following are requirments are checked against 1) ic_base::SizeMatch checks to make sure the input cube has the same bands, samples, and lines as the first input cube open using this method, 2) ic_base::SpatialMatch checks to make sure the input cube has the same samples and lines as the first input cube, 3) ic_base::Georeferenced checks to make sure latitude/longitudes can be obtained from the input cube, 4) ic_base::FullyGeoreferenced checks to make sure latitude/longitude, phase/incidence/emission, and other geometric parameters can be obtained from the input cube, 5) ic_base::OneBand checks to make sure the input cube has exactly one band. Note, that these requirements can be logically or'ed. For example, ic_base::SpatialMatch | ic_base::georeferenced. Defaults to 0
Exceptions
Isis::iException::Message

Reimplemented in Isis::ProcessByBrick, Isis::ProcessByLine, Isis::ProcessBySpectra, and Isis::ProcessBySample.

Referenced by Isis::ProcessGroundPolygons::SetStatCubes().

Isis::Cube * Isis::Process::SetInputCube ( const QString &  fname,
const Isis::CubeAttributeInput att,
int  requirements = 0 
)
virtualinherited

Opens an input cube specified by the programmer and verifies requirements are met.

Parameters
fnameProgrammer specified work file. For example, "myfile.cub".
attThe cube attributes to use when opening the input cube.
requirementsSame as requirements on SetInputCube. See that method for more details. Defaults to 0
Returns
Cube*
Exceptions
Isis::iException::Message

Reimplemented in Isis::ProcessByBrick.

References _FILEINFO_, Isis::AllMatchOrOne, Isis::Cube::bandCount(), Isis::BandMatchOrOne, Isis::CubeAttributeInput::bands(), Isis::Cube::lineCount(), Isis::OneBand, Isis::Cube::open(), Isis::ReadWrite, Isis::Cube::sampleCount(), Isis::Cube::setVirtualBands(), Isis::SizeMatch, and Isis::SpatialMatch.

void Isis::Process::SetInputCube ( Isis::Cube inCube)
virtualinherited

Set the InputCube vector to an opened Cube which was dynamically allocated.

This is used if there already exists a valid opened cube

Author
Sharmila Prasad (5/7/2011)
Parameters
inCube- Pointer to input Cube

Reimplemented in Isis::ProcessByLine.

References _FILEINFO_, and Isis::Cube::isOpen().

void Isis::ProcessExport::SetInputRange ( )

Set input pixel range from user.

This method performs the same function as SetInputRange(min,max) and SetInputRange(min,mid,max). However, the information for min/mid/max is obtained from the user via the command line. Therefore you must include the following parameter group in your application XML file:

<group name="Stretch Options">
<parameter name="STRETCH">
<type>string</type>
<default>
<item>LINEAR</item>
</default>
<brief>Type of stretch</brief>
<description>
This parameter is used to select one of three ways to stretch
(or map) output pixels. They are LINEAR, PIECEWISE, or MANUAL.
</description>
<list>
<option value="LINEAR">
<brief> Linear stretch </brief>
<description>
A minimum and maximum are automatically computed based on
the statistics of the selected band. A histogram of the
band is used to pick the minimum at 0.5% of the data and
the maximum at 99.5% of the data. Input pixels less than
or equal to the minimum are stretched to black while
pixels greater than the or equal to the maximum are
stretched to white. A linear mapping occurs between the
minimum and maximum.
</description>
<inclusions>
<item>MINPERCENT</item>
<item>MAXPERCENT</item>
</inclusions>
<exclusions>
<item>MINIMUM</item>
<item>MAXIMUM</item>
</exclusions>
</option>
<option value="PIECEWISE">
<brief> Piecewise-linear stretch </brief>
<description>
This option is similar to the LINEAR option. A minimum and
maximum are automatically computed. Additionally, the
median is computed and it is mapped to the middle gray
value (halfway between white and black). Therefore, it is
a piecewise-linear stretch with input pixels mapped
linearly between either 1) the minimum/median or 2) the
median/maximum. This option is useful for contrast
stretching cubes with skewed histograms to ensure a
balanced contrast.
</description>
<inclusions>
<item>MINPERCENT</item>
<item>MAXPERCENT</item>
</inclusions>
<exclusions>
<item>MINIMUM</item>
<item>MAXIMUM</item>
</exclusions>
</option>
<option value="MANUAL">
<brief> Manual stretch </brief>
<description>
This option allows you to pick your own stretch. You must
enter a value for MINIMUM and MAXIMUM
</description>
<inclusions>
<item>MINIMUM</item>
<item>MAXIMUM</item>
</inclusions>
<exclusions>
<item>MINPERCENT</item>
<item>MAXPERCENT</item>
</exclusions>
</option>
</list>
</parameter>
<parameter name="MINIMUM">
<type>double</type>
<brief>Minimum pixel value</brief>
<description>
The minimum input pixel value which will be mapped to black.
</description>
<lessThan>
<item>MAXIMUM</item>
</lessThan>
</parameter>
<parameter name="MAXIMUM">
<type>double</type>
<brief>Maximum pixel value</brief>
<description>
The maximum input pixel value which will be mapped to white.
</description>
<greaterThan>
<item>MINIMUM</item>
</greaterThan>
</parameter>
<parameter name="MINPERCENT">
<type>double</type>
<brief>Minimum Percent</brief>
<description>
The percentage of data in the histogram used to compute
the minimum pixel value in the stretch.
</description>
<default><item>0.5</item></default>
<lessThan>
<item>MAXPERCENT</item>
</lessThan>
</parameter>
<parameter name="MAXPERCENT">
<type>double</type>
<brief>Maximum Percent</brief>
<description>
The percentage of data in the histogram used to compute
the maximum pixel value in the stretch.
</description>
<default><item>99.5</item></default>
<greaterThan>
<item>MINPERCENT</item>
</greaterThan>
</parameter>
</group>

References IsisAml::Clear(), IsisAml::GetDouble(), IsisAml::GetString(), Isis::Application::GetUserInterface(), Isis::Process::InputCubes, Isis::Histogram::Median(), Isis::NULL8, p_inputMaximum, p_inputMiddle, p_inputMinimum, Isis::Histogram::Percent(), and IsisAml::PutDouble().

Referenced by SetInputRange(), and Isis::ImageExporter::write().

void Isis::ProcessExport::SetInputRange ( const double  minimum,
const double  maximum 
)

Set input pixel range from to a linear stretch.

This method allows the programmer to define what range of input pixels in the input cube get mapped to the output range in the Buffer. By default the output range is 0.0 to 1.0 (can be overridden using the SetOutputRange method). This version of SetInputRange allows the programmer to perform a simple linear stretch. That is, "minimum:0.0 maximum:1.0" or minimum is mapped to 0.0, maximum is mapped to 1.0 everything inbetween is mapped linearly (e.g., (minimum+maximum)/2.0:0.5). Also, everything less than the minimum is mapped to 0.0 and everything more than the maximum is mapped to 1.0. If you are uncertain about how stretches operate see the Stretch object. If the input range is never set, no stretch will occur.

Parameters
minimumMinimum pixel value in the input cube to be mapped to the minimum value in the Buffer
maximumMaximum pixel value in the input cube to be mapped to the maximum value in the Buffer
Exceptions
Isis::iException::Message

References SetInputRange().

void Isis::ProcessExport::SetInputRange ( const double  minimum,
const double  maximum,
const int  index 
)

Set input pixel range from to a linear stretch.

This method allows the programmer to define what range of input pixels in the input cube get mapped to the output range in the Buffer. By default the output range is 0.0 to 1.0 (can be overridden using the SetOutputRange method). This version of SetInputRange allows the programmer to perform a simple linear stretch. That is, "minimum:0.0 maximum:1.0" or minimum is mapped to 0.0, maximum is mapped to 1.0 everything inbetween is mapped linearly (e.g., (minimum+maximum)/2.0:0.5). Also, everything less than the minimum is mapped to 0.0 and everything more than the maximum is mapped to 1.0. If you are uncertain about how stretches operate see the Stretch object. If the input range is never set, no stretch will occur.

Parameters
minimumMinimum pixel value in the input cube to be mapped to the minimum value in the Buffer
maximumMaximum pixel value in the input cube to be mapped to the maximum value in the Buffer
indexThe index of the channel you are setting
Exceptions
Isis::iException::Message

References SetInputRange().

void Isis::ProcessExport::SetInputRange ( const double  minimum,
const double  middle,
const double  maximum 
)

Set input pixel range from to a piecewise linear stretch.

This method allows the programmer to define what range of input pixels in the input cube get mapped to the output range in the Buffer. By default the output range is 0.0 to 1.0 (can be overridden using the SetOutputRange method). This version of SetInputRange allows the programmer to perform a piecewise linear stretch. That is,"minimum:0.0 middle:0.5 maximum:1.0". The pixels from the input cube between minimum and middle are mapped to 0.0 and 0.5 linearly, while pixels between middle and maximum are mapped to 0.5 and 1.0 linearly. Those outside the range of minimum and maximum are mapped to 0.0 and 1.0 respectively. If you are uncertain about how stretches operate see the Stretch object. If the input range is never set, no stretch will occur.

Parameters
minimumMinimum pixel value in the input cube to be mapped to the minimum value in the Buffer
middleMiddle pixel value in the input cube to be mapped to the (minimum+maximum)/2.0 value in the Buffer
maximumMaximum pixel value in the input cube to be mapped to the maximum value in the Buffer
Exceptions
Isis::IException::Message

References _FILEINFO_, Isis::Process::InputCubes, p_inputMaximum, p_inputMiddle, p_inputMinimum, and Isis::IException::Programmer.

void Isis::ProcessExport::SetInputRange ( const double  minimum,
const double  middle,
const double  maximum,
const int  index 
)

Set input pixel range from to a piecewise linear stretch.

This method allows the programmer to define what range of input pixels in the input cube get mapped to the output range in the Buffer. By default the output range is 0.0 to 1.0 (can be overridden using the SetOutputRange method). This version of SetInputRange allows the programmer to perform a piecewise linear stretch. That is,"minimum:0.0 middle:0.5 maximum:1.0". The pixels from the input cube between minimum and middle are mapped to 0.0 and 0.5 linearly, while pixels between middle and maximum are mapped to 0.5 and 1.0 linearly. Those outside the range of minimum and maximum are mapped to 0.0 and 1.0 respectively. If you are uncertain about how stretches operate see the Stretch object. If the input range is never set, no stretch will occur.

Parameters
minimumMinimum pixel value in the input cube to be mapped to the minimum value in the Buffer
middleMiddle pixel value in the input cube to be mapped to the (minimum+maximum)/2.0 value in the Buffer
maximumMaximum pixel value in the input cube to be mapped to the maximum value in the Buffer
indexThe index of the channel you are setting
Exceptions
Isis::iException::Message

References _FILEINFO_, Isis::Process::InputCubes, p_inputMaximum, p_inputMiddle, p_inputMinimum, and Isis::IException::Programmer.

Isis::Cube * Isis::Process::SetOutputCube ( const QString &  parameter)
virtualinherited

Allocates a user-specified output cube whose size matches the first input cube.

Returns
Cube*
Parameters
parameterUser specified output file. For example, "TO" is a popular user parameter. If the user specified TO=output.cub, then this routine would allocate the file output.cub with size specified by the first opened input cube. The output pixel type will be propagated from the first loaded input cube or will use the value in the application XML file for pixelType.
Exceptions
Isis::iException::Message

Reimplemented in Isis::ProcessMosaic, Isis::ProcessImport, and Isis::ProcessMapMosaic.

References _FILEINFO_.

Referenced by Isis::ProcessImport::SetOutputCube().

Isis::Cube * Isis::Process::SetOutputCube ( const QString &  parameter,
const int  ns,
const int  nl,
const int  nb = 1 
)
virtualinherited

Allocates a user specified output cube whose size is specified by the programmer.

Returns
Cube*
Parameters
parameterUser specified output file. For example, "TO" is a popular user parameter. If the user specified TO=output.cub, then this routine would allocate the file output.cub with size specified by the first opened input cube. The output pixel type will be propagated from the first loaded input cube or will use the value in the application XML file for pixelType.
nsNumber of samples to allocate
nlNumber of lines to allocate
nbNumber of bands to allocate
Exceptions
Isis::iException::Message

References _FILEINFO_.

Isis::Cube * Isis::Process::SetOutputCube ( const QString &  fname,
const Isis::CubeAttributeOutput att,
const int  ns,
const int  nl,
const int  nb = 1 
)
virtualinherited
void Isis::ProcessExport::SetOutputEndian ( enum ByteOrder  byteOrderIn)

Set byte endianness of the output cube.

This method allows the programmer to specify whether the first byte of data output from the ProcessExport will be the most significant byte or the least significant byte. If the user does not explicitly set the endianness, it will default to that of the current system architecture

Parameters
byteOrderInenumeration of the endianness (MSB or LSB)

References Isis::Lsb, Isis::Msb, Isis::NoByteOrder, p_endianSwap, and p_endianType.

Referenced by ProcessExport().

void Isis::ProcessExport::SetOutputHis ( const double  value)

Set output special pixel value for HIS.

Sets the value for output special pixel HISs. HIS pixels values from the input cube will be set to this value. Be default this value will be set to the maximum out value set with SetOutputRange

Parameters
valueThe output pixel value for all HIS pixels

References p_His, and p_His_Set.

void Isis::ProcessExport::SetOutputHrs ( const double  value)

Set output special pixel value for HRS.

Sets the value for output special pixel HRSs. HRS pixels values from the input cube will be set to this value. Be default this value will be set to the maximum out value set with SetOutputRange

Parameters
valueThe output pixel value for all HRS pixels

References p_Hrs, and p_Hrs_Set.

void Isis::ProcessExport::SetOutputLis ( const double  value)

Set output special pixel value for LIS.

Sets the value for output special pixel LISs. LIS pixels values from the input cube will be set to this value. Be default this value will be set to the minimum out value set with SetOutputRange

Parameters
valueThe output pixel value for all LIS pixels

References p_Lis, and p_Lis_Set.

void Isis::ProcessExport::SetOutputLrs ( const double  value)

Set output special pixel value for LRS.

Sets the value for output special pixel LRSs. LRS8 pixels values from the input cube will be set to this value. Be default this value will be set to the minimum out value set with SetOutputRange

Parameters
valueThe output pixel value for all LRS pixels

References p_Lrs, and p_Lrs_Set.

void Isis::ProcessExport::SetOutputNull ( const double  value)

Set output special pixel value for NULL.

Sets the value for output special pixel NULLs. NULL pixels values from the input cube will be set to this value. Be default this value will be set to the minimum out value set with SetOutputRange

Parameters
valueThe output pixel value for all NULL pixels

References p_Null, and p_Null_Set.

Referenced by Isis::ImageExporter::initializeProcess().

void Isis::ProcessExport::SetOutputRange ( const double  minimum,
const double  maximum 
)

Set output pixel range in Buffer.

This method allows the programmer to specify the acceptable range of values contained in the Buffer. If this method is never invoked, all pixel values received in the Buffer of the export function will be in the range of 0.0 to 1.0. However, this can be overridden, for example, to 0.0 and 255.0, by invoking this method.

Parameters
minimumDesired minimum pixel value in the Buffer
maximumDesired maximum pixel value in the Buffer
Exceptions
Isis::iException::Message

References _FILEINFO_, p_outputMaximum, p_outputMiddle, p_outputMinimum, and Isis::IException::Programmer.

Referenced by Isis::ImageExporter::initializeProcess(), and SetOutputType().

void Isis::ProcessExport::SetOutputType ( Isis::PixelType  pixelIn)

Set output pixel bit type in Buffer.

This method specifies the type of pixel data that is going to be output. Essentially, it is a convenience method that will automatically calculate the necessary output range based on the minimum and maximum values of the bit type that is specified. Currently, the method only supported data types are Isis::UnsignedByte (Range of 0 to 255), Isis::SignedWord (Range of -32768 to 32767), Isis::UnsignedWord (Range of 0 to 65535), and Isis::Real (Range from the minimum floating-point value to the maximum floating-point value supported in C++; -FLT_MAX to FLT_MAX), since these are the only formats that can be output by ProcessExport. If neither this method nor the SetOutputRange method is invoked, all pixel values received in the Buffer of the export function will be in the range of 0.0 to 1.0.

NOTE: You must set the format type of the output data with SetFormat before calling this method. Otherwise, you will get an error.

Parameters
pixelInthis is an enumeration of the different pixel types. The only values that are recognized as valid are Isis::UnsignedByte, Isis::SignedWord, Isis::UnsignedWord, and Isis::Real.
Exceptions
Isis::iException::Message

References _FILEINFO_, JP2, p_format, p_pixelType, Isis::IException::Programmer, Isis::Real, SetOutputRange(), Isis::SignedWord, Isis::UnsignedByte, Isis::UnsignedWord, Isis::VALID_MAX1, Isis::VALID_MAX2, Isis::VALID_MAXU2, Isis::VALID_MIN1, Isis::VALID_MIN2, and Isis::VALID_MINU2.

Referenced by Isis::ImageExporter::initializeProcess(), and ProcessExport().

void Isis::ProcessExport::StartProcess ( void   functIsis::Buffer &in)
virtual

This method invokes the process operation over a single input cube.

In the cases of BSQ and BIL this is a process by line. In the case of BIP, this is a process by band. A single buffer of input data will be padd to the buffer processing function. Note the data will be stretched based on the invocations of the SetInputRange and SetpOutputRange methods.

Parameters
funct(Isis::Buffer &b) Name of your buffer processing function. The buffer in will contain stretched input cube pixels for an entire buffer. These pixels must be written to the foreign output file (e.g, jpg, tif, etc).

References _FILEINFO_, Isis::BufferManager::begin(), BIL, BIP, BSQ, Isis::Progress::CheckStatus(), Isis::BufferManager::end(), Isis::Process::InputCubes, JP2, Isis::BufferManager::next(), p_format, Isis::Process::p_progress, p_str, Isis::IException::Programmer, and Isis::Buffer::size().

virtual void Isis::ProcessExport::StartProcess ( void   functstd::vector< Isis::Buffer * > &in)
virtual
void Isis::ProcessExport::StartProcess ( std::ofstream &  fout)
virtual

Write an entire cube to an output file stream.

Just as with the other invocation of the StartProcess method, this will process an input cube buffer by buffer. Unlike the other invocation, this method takes care of writing the input data to an output file stream specified by the user instead of relying on an external function.

Parameters
&foutAn open stream to which the pixel data will be written. After calling this method once, the stream will contain all of the pixel data from the input cube.

Reimplemented in Isis::ProcessExportPds.

References _FILEINFO_, Isis::BufferManager::begin(), BIL, BIP, BSQ, Isis::Progress::CheckStatus(), Isis::BufferManager::end(), Isis::Process::InputCubes, Isis::BufferManager::next(), p_format, p_pixelType, Isis::Process::p_progress, p_str, Isis::IException::Programmer, Isis::Real, Isis::SignedWord, Isis::Buffer::size(), Isis::UnsignedByte, and Isis::UnsignedWord.

virtual void Isis::Process::StartProcess ( void   funct())
inlinevirtualinherited

In the base class, this method will invoked a user-specified function exactly one time.

In derived classes such as ProcessByLine, the StartProcess will invoke a user-specified function for every line in a cube.

Parameters
funct()Name of your processing function
void Isis::Process::WriteHistory ( Cube cube)
inherited

Member Data Documentation

std::vector<Isis::Cube *> Isis::Process::InputCubes
protectedinherited

A vector of pointers to opened Cube objects.

The pointers are established in the SetInputCube/SetInputWorkCube methods.

Referenced by CreateWorldFile(), GetBuffersBIL(), GetBuffersBIP(), GetBuffersBSQ(), Isis::ProcessByBrick::ProcessCube(), ProcessCubes(), Isis::ProcessByBrick::ProcessCubes(), SetInputRange(), Isis::ProcessByQuickFilter::StartProcess(), and StartProcess().

QSet<Isis::Cube *>* Isis::Process::m_ownedCubes
protectedinherited

A list of cubes owned by this instant.

These cubes will be deleted on finalization. Process will not take ownership of cubes allocated outside of Process. It is the caller's responsibility to delete such cubes.

std::vector<Isis::Cube *> Isis::Process::OutputCubes
protectedinherited

A vector of pointers to allocated Cube objects.

The pointers are established in the SetOutputCube method.

Referenced by Isis::ProcessByBrick::ProcessCube(), Isis::ProcessByBrick::ProcessCubes(), and Isis::ProcessByQuickFilter::StartProcess().

std::vector< std::vector< Isis::Statistics * > > Isis::Process::p_bandStats
protectedinherited

Holds the calculated statistics for each band separately of every input cubei after the CalculateStatistics method is called.

Referenced by Isis::Process::BandStatistics().

std::vector< Isis::Statistics * > Isis::Process::p_cubeStats
protectedinherited

Holds the calculated statistics for every band together of every input cubei after the CalculateStatistics method is called.

Referenced by Isis::Process::CubeStatistics().

EndianSwapper* Isis::ProcessExport::p_endianSwap
protected

Object to swap the endianness of the

raw output to either MSB or LSB

Referenced by ProcessExport(), SetOutputEndian(), and ~ProcessExport().

ByteOrder Isis::ProcessExport::p_endianType
protected

The byte order of the output file.

Referenced by SetOutputEndian().

ExportFormat Isis::ProcessExport::p_format
protected

Current storage order.

Referenced by GetBuffers(), ProcessCubes(), setFormat(), SetOutputType(), and StartProcess().

double Isis::ProcessExport::p_His
protected

  The output value for pixels whose input DNs are 

High Instrument Saturation values.

Referenced by OutputHis(), and SetOutputHis().

bool Isis::ProcessExport::p_His_Set
protected

  Indicates whether p_His has been set 

(i.e.

if setHis() has been called).

Referenced by OutputHis(), ProcessExport(), and SetOutputHis().

double Isis::ProcessExport::p_Hrs
protected

  The output value for pixels whose input DNs are 

High Representation Saturation values.

Referenced by OutputHrs(), and SetOutputHrs().

bool Isis::ProcessExport::p_Hrs_Set
protected

  Indicates whether p_Hrs has been set 

(i.e.

if setHrs() has been called).

Referenced by OutputHrs(), ProcessExport(), and SetOutputHrs().

std::vector<double> Isis::ProcessExport::p_inputMaximum
protected

Maximum pixel value in the input cube to be mapped to the maximum value in the Buffer.

Referenced by GetInputMaximum(), ProcessExport(), and SetInputRange().

std::vector<double> Isis::ProcessExport::p_inputMiddle
protected

Middle pixel value in the input cube to be mapped to the (minimum+maximum)/2.0 value in the Buffer.

Referenced by ProcessExport(), and SetInputRange().

std::vector<double> Isis::ProcessExport::p_inputMinimum
protected

Minimum pixel value in the input cube to be mapped to the minimum value in the Buffer.

Referenced by GetInputMinimum(), HasInputRange(), ProcessExport(), and SetInputRange().

double Isis::ProcessExport::p_Lis
protected

  The output value for pixels whose input DNs are 

Low Instrument Saturation values.

Referenced by OutputLis(), and SetOutputLis().

bool Isis::ProcessExport::p_Lis_Set
protected

  Indicates whether p_Lis has been set 

(i.e.

if setLis() has been called).

Referenced by OutputLis(), ProcessExport(), and SetOutputLis().

double Isis::ProcessExport::p_Lrs
protected

  The output value for pixels whose input DNs are 

Low Representation Saturation values.

Referenced by OutputLrs(), and SetOutputLrs().

bool Isis::ProcessExport::p_Lrs_Set
protected

  Indicates whether p_Lrs has been set 

(i.e.

if setLrs() has been called).

Referenced by OutputLrs(), ProcessExport(), and SetOutputLrs().

double Isis::ProcessExport::p_Null
protected

The output value for pixels whose input DNs are Null values.

Referenced by OutputNull(), and SetOutputNull().

bool Isis::ProcessExport::p_Null_Set
protected

 Indicates whether p_Null has been set 

(i.e.

if setNull() has been called).

Referenced by OutputNull(), ProcessExport(), and SetOutputNull().

double Isis::ProcessExport::p_outputMaximum
protected

Desired maximum pixel value in the Buffer.

Referenced by GetOutputMaximum(), OutputHis(), OutputHrs(), ProcessExport(), and SetOutputRange().

double Isis::ProcessExport::p_outputMiddle
protected

  Middle pixel value (minimum+maximun)/2.0 in

the Buffer

Referenced by ProcessExport(), and SetOutputRange().

double Isis::ProcessExport::p_outputMinimum
protected

Desired minimum pixel value in the Buffer.

Referenced by GetOutputMinimum(), OutputLis(), OutputLrs(), OutputNull(), ProcessExport(), and SetOutputRange().

PixelType Isis::ProcessExport::p_pixelType
protected

The bits per pixel of the output image.

Referenced by SetOutputType(), and StartProcess().

bool Isis::Process::p_propagateHistory
protectedinherited

Flag indicating if history is to be propagated to output cubes.

bool Isis::Process::p_propagateLabels
protectedinherited

Flag indicating if labels are be propagated to output cubes.

bool Isis::Process::p_propagateOriginalLabel
protectedinherited

Flag indicating if original lable is to be propagated to output cubes.

bool Isis::Process::p_propagatePolygons
protectedinherited

Flag indicating if blobs are be propagated to output cubes.

bool Isis::Process::p_propagateTables
protectedinherited

Flag indicating if tables are be propagated to output cubes.

std::vector<Stretch *> Isis::ProcessExport::p_str
protected

Stretch object to ensure a reasonable range of pixel values in the output data.

Referenced by ProcessCubes(), StartProcess(), and ~ProcessExport().


The documentation for this class was generated from the following files: