Isis 3 Programmer Reference
Isis::ProcessExportPds Class Reference

Process class for exporting cubes to PDS standards. More...

#include <ProcessExportPds.h>

Inheritance diagram for Isis::ProcessExportPds:
Inheritance graph
Collaboration diagram for Isis::ProcessExportPds:
Collaboration graph

Public Types

enum  PdsFileType { Image, Qube, SpectralQube, JP2Image }
 File type to be exported. More...
 
enum  PdsResolution { Meter, Kilometer }
 Resolution units per pixel of the exported PDS file. More...
 
enum  PdsExportType { Stream, Fixed }
 Record format type of exported PDS file. More...
 
enum  ExportFormat { BSQ, BIL, BIP, JP2 }
 Storage order enumeration. More...
 

Public Member Functions

 ProcessExportPds ()
 Default Constructor - Set to default the data members. More...
 
 ~ProcessExportPds ()
 Destructor. More...
 
void StandardAllMapping (Pvl &mainPvl)
 Create the standard keywords for the IMAGE_MAP_PROJECTION group in a PDS label. More...
 
void StreamImageRoot (Pvl &mainPvl)
 Create the standard keywords for the ROOT object in a PDS IMAGE file. More...
 
void FixedImageRoot (Pvl &mainPvl)
 Create the fixed keywords for the ROOT object in a PDS IMAGE file. More...
 
void StreamJP2ImageRoot (Pvl &mainPvl)
 Create the standard keywords for the ROOT object in a PDS JP2 IMAGE file. More...
 
void FixedJP2ImageRoot (Pvl &mainPvl)
 Create the fixed keywords for the ROOT object in a PDS JP2 IMAGE file. More...
 
void StandardImageImage (Pvl &mainPvl)
 Create the standard keywords for an IMAGE object in a PDS IMAGE file. More...
 
void StandardJP2Image (Pvl &mainPvl)
 Create the standard keywords for an IMAGE object in a PDS JP2 IMAGE file. More...
 
void SetPdsResolution (PdsResolution resolutionUnits)
 Mutator method to set the output PDS image resolution to meters per pixel or kilometers per pixel. More...
 
void SetExportType (PdsExportType recordFormat)
 Mutator method to set the output PDS image record type to stream or fixed. More...
 
virtual PvlStandardPdsLabel (ProcessExportPds::PdsFileType type)
 Create a standard PDS label of the type specified. More...
 
void OutputLabel (std::ofstream &pdsFileStream)
 Write the PDS label to the supplied stream. More...
 
void updateChecksumInLabel (std::ofstream &pdsFileStream)
 Updates the CHECKSUM value on the label and rewrites to the output file. More...
 
void OutputDetachedLabel ()
 Write the PDS label to the a detached file. More...
 
void ExportTable (Isis::Table isisTable, QString detachedPdsTableFileName="")
 This method will add a table to be exported to PDS. More...
 
void StartProcess (std::ofstream &fout)
 This method fills the image data of the PDS file using the parent class ProcessExport::StartProcess, then appends any attached tables. More...
 
bool Detached ()
 Accessor function returns true if the output PDS file is set to detached. More...
 
bool Attached ()
 Accessor function returns true if the output PDS file is set to attached. More...
 
void SetDetached (QString detachedLabelFile)
 Mutator method to set the output PDS file to detached. More...
 
void SetAttached ()
 Mutator method to set the output PDS file to attached. More...
 
void ForceBands (bool force)
 Mutator method to set how the the BANDS keyword will be handled. More...
 
void ForceBandName (bool force)
 Mutator method to set how the BAND_NAME keyword will be handled. More...
 
void ForceCenterFilterWavelength (bool force)
 Mutator method to set how the CENTER_FILTER_WAVELENGTH keyword will be handled. More...
 
void ForceBandwidth (bool force)
 Mutator method to set how the BANDWIDTH keyword will be handled. More...
 
void ForceBandStorageType (bool force)
 Mutator method to set how the BAND_STORAGE_TYPE keyword will be handled. More...
 
void ForceOffset (bool force)
 Mutator method to set how the OFFSET keyword will be handled. More...
 
void ForceScalingFactor (bool force)
 Mutator method to set how the SCALING_FACTOR keyword will be handled. More...
 
void ForceSampleBits (bool force)
 Mutator method to set how the SAMPLE_BITS keyword will be handled. More...
 
void ForceSampleBitMask (bool force)
 Mutator method to set how the SAMPLE_BIT_MASK keyword will be handled. More...
 
void ForceSampleType (bool force)
 Mutator method to set how the SAMPLE_TYPE keyword will be handled. More...
 
void ForceCoreNull (bool force)
 Mutator method to set how the CORE_NULL keyword will be handled. More...
 
void ForceCoreLrs (bool force)
 Mutator method to set how the CORE_LOW_REPR_SATURATION keyword will be handled. More...
 
void ForceCoreLis (bool force)
 Mutator method to set how the CORE_LOW_INSTR_SATURATION keyword will be handled. More...
 
void ForceCoreHrs (bool force)
 Mutator method to set how the CORE_HIGH_REPR_SATURATION keyword will be handled. More...
 
void ForceCoreHis (bool force)
 Mutator method to set how the CORE_HIGH_INSTR_SATURATION keyword will be handled. More...
 
virtual void StartProcess (void funct(Isis::Buffer &in))
 This method invokes the process operation over a single input cube. More...
 
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. More...
 
virtual void StartProcess (void funct(Isis::Buffer &in))
 This method invokes the process operation over a single input cube. More...
 
virtual void StartProcess (void funct(std::vector< Isis::Buffer *> &in))
 
virtual void StartProcess (void funct())
 In the base class, this method will invoked a user-specified function exactly one time. More...
 
void SetOutputRange (const double minimum, const double maximum)
 Set output pixel range in Buffer. More...
 
void SetOutputNull (const double value)
 Set output special pixel value for NULL. More...
 
void SetOutputLis (const double value)
 Set output special pixel value for LIS. More...
 
void SetOutputLrs (const double value)
 Set output special pixel value for LRS. More...
 
void SetOutputHis (const double value)
 Set output special pixel value for HIS. More...
 
void SetOutputHrs (const double value)
 Set output special pixel value for HRS. More...
 
double OutputNull ()
 Return the output special pixel value for NULL. More...
 
double OutputLis ()
 Return the output special pixel value for LIS. More...
 
double OutputLrs ()
 Return the output special pixel value for LRS. More...
 
double OutputHis ()
 Return the output special pixel value for HIS. More...
 
double OutputHrs ()
 Return the output special pixel value for HRS. More...
 
bool HasInputRange () const
 
void SetInputRange ()
 Set input pixel range from user. More...
 
void SetInputRange (const double minimum, const double maximum)
 Set input pixel range from to a linear stretch. More...
 
void SetInputRange (const double minimum, const double maximum, const int index)
 Set input pixel range from to a linear stretch. More...
 
void SetInputRange (const double minimum, const double middle, const double maximum)
 Set input pixel range from to a piecewise linear stretch. More...
 
void SetInputRange (const double minimum, const double middle, const double maximum, const int index)
 Set input pixel range from to a piecewise linear stretch. More...
 
void CreateWorldFile (const QString &worldFile)
 Create a standard world file for the input cube. More...
 
void SetOutputEndian (enum ByteOrder endianness)
 Set byte endianness of the output cube. More...
 
void SetOutputType (Isis::PixelType pixelIn)
 Set output pixel bit type in Buffer. More...
 
void setCanGenerateChecksum (bool flag)
 Set m_canGenerateChecksum which determines if we can generate a MD5 checksum on the image data. More...
 
bool canGenerateChecksum ()
 Return if we can generate a checksum More...
 
QString checksum ()
 Generates a file checksum. More...
 
double GetInputMinimum (unsigned int n=0) const
 Get the valid minimum pixel value for the Nth input cube. More...
 
double GetInputMaximum (unsigned int n=0) const
 Get the valid maximum pixel value for the Nth input cube. More...
 
double GetOutputMinimum ()
 Get the valid minimum pixel value to be written to the output file. More...
 
double GetOutputMaximum ()
 Get the valid maximum pixel value to be written to the output file. More...
 
void setFormat (ExportFormat format)
 Sets the storage order of the output file. More...
 
template<typename Functor >
void ProcessCubes (const Functor &functor)
 
virtual void EndProcess ()
 End the processing sequence and cleans up by closing cubes, freeing memory, etc. More...
 
virtual void Finalize ()
 Cleans up by closing cubes and freeing memory for owned cubes. More...
 
virtual Isis::CubeSetInputCube (const QString &parameter, const int requirements=0)
 Opens an input cube specified by the user and verifies requirements are met. More...
 
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. More...
 
virtual void SetInputCube (Isis::Cube *inCube)
 Set the InputCube vector to an opened Cube which was dynamically allocated. More...
 
virtual Isis::CubeSetOutputCube (const QString &parameter)
 Allocates a user-specified output cube whose size matches the first input cube. More...
 
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. More...
 
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. More...
 
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. More...
 
void ClearInputCubes ()
 Close owned input cubes from the list and clear the list. More...
 
void ClearOutputCubes ()
 Close owned output cubes from the list and clear the list. More...
 
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. More...
 
void PropagateLabels (const QString &cube)
 This method allows the programmer to propagate labels from a specific secondary cube. More...
 
void PropagateTables (const bool prop)
 This method allows the programmer to propagate input tables to the output cube (default is true) More...
 
void PropagateTables (const QString &fromName, const QList< QString > &tableNames=QList< QString >())
 Propagate the tables from the cube with the given filename to the output cube. More...
 
void PropagatePolygons (const bool prop)
 This method allows the programmer to propagate input blobs to the output cube (default is true) More...
 
void PropagateHistory (const bool prop)
 This method allows the programmer to propagate history to the output cube (default is true) More...
 
void PropagateOriginalLabel (const bool prop)
 This method allows the programmer to propagate original labels to the output cube (default is true) More...
 
Isis::ProgressProgress ()
 This method returns a pointer to a Progress object. More...
 
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. More...
 
void WriteHistory (Cube &cube)
 Writes out the History blob to the cube. More...
 
void CalculateStatistics ()
 Calculates and stores off statistics on every band of every cube added to this process via the SetInputCube method. More...
 
std::vector< Isis::Statistics * > BandStatistics (const unsigned index)
 Get the vector of Statistics objects for each band separately of a specified input cube. More...
 
Isis::StatisticsCubeStatistics (const unsigned index)
 Get the Statistics object for all bands of a specified input cube. More...
 

Protected Member Functions

int LineBytes ()
 Return the line bytes (record size) for the input cube, at present this is based on the number of samples and the bytes per pixel. More...
 
int LabelSize ()
 Return the size of the output PDS label. More...
 
virtual void CreateImageLabel ()
 Create a standard PDS label for type IMAGE. More...
 
void CreateQubeLabel ()
 Create a standard PDS label for type QUBE. More...
 
void CreateSpectralQubeLabel ()
 Create a standard PDS label for type SPECTRAL_QUBE. More...
 
QString ProjectionName (Pvl &inputLabel)
 Return a projection name. More...
 
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. More...
 
std::vector< BufferManager * > GetBuffersBIL ()
 A single line of input data from each input cube will be passed to the line processing function. More...
 
std::vector< BufferManager * > GetBuffersBIP ()
 A single band of input data from each input cube will be passed to the band processing function. More...
 

Protected Attributes

PvlFormatPdsm_formatter
 Used to determine how to format the keyword values in the PDS file. More...
 
Pvlm_label
 Exported PDS label. More...
 
PdsExportType m_exportType
 Stream or Fixed. More...
 
ExportFormat p_format
 Current storage order. More...
 
double p_outputMinimum
 Desired minimum pixel value in the Buffer. More...
 
double p_outputMiddle
 Middle pixel value (minimum+maximun)/2.0 in the Buffer. More...
 
double p_outputMaximum
 Desired maximum pixel value in the Buffer. More...
 
std::vector< double > p_inputMinimum
 Minimum pixel value in the input cube to be mapped to the minimum value in the Buffer. More...
 
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. More...
 
std::vector< double > p_inputMaximum
 Maximum pixel value in the input cube to be mapped to the maximum value in the Buffer. More...
 
EndianSwapperp_endianSwap
 Object to swap the endianness of the raw output to either MSB or LSB. More...
 
ByteOrder p_endianType
 The byte order of the output file. More...
 
PixelType p_pixelType
 The bits per pixel of the output image. More...
 
std::vector< Stretch * > p_str
 Stretch object to ensure a reasonable range of pixel values in the output data. More...
 
double p_Null
 The output value for pixels whose input DNs are Null values. More...
 
double p_Lis
 The output value for pixels whose input DNs are Low Instrument Saturation values. More...
 
double p_Lrs
 The output value for pixels whose input DNs are Low Representation Saturation values. More...
 
double p_His
 The output value for pixels whose input DNs are High Instrument Saturation values. More...
 
double p_Hrs
 The output value for pixels whose input DNs are High Representation Saturation values. More...
 
bool p_Null_Set
 Indicates whether p_Null has been set (i.e. More...
 
bool p_Lis_Set
 Indicates whether p_Lis has been set (i.e. More...
 
bool p_Lrs_Set
 Indicates whether p_Lrs has been set (i.e. More...
 
bool p_His_Set
 Indicates whether p_His has been set (i.e. More...
 
bool p_Hrs_Set
 Indicates whether p_Hrs has been set (i.e. More...
 
QCryptographicHash * m_cryptographicHash
 A cryptographic hash that will generate an MD5 checksum of the image data. More...
 
bool m_canGenerateChecksum
 Flag to determine if a file checksum will be generated. More...
 
Isis::Progressp_progress
 Pointer to a Progress object. More...
 
bool p_propagateLabels
 Flag indicating if labels are be propagated to output cubes. More...
 
bool p_propagateTables
 Flag indicating if tables are be propagated to output cubes. More...
 
bool p_propagatePolygons
 Flag indicating if blobs are be propagated to output cubes. More...
 
bool p_propagateHistory
 Flag indicating if history is to be propagated to output cubes. More...
 
bool p_propagateOriginalLabel
 Flag indicating if original lable is to be propagated to output cubes. More...
 
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. More...
 
std::vector< Isis::Statistics *> p_cubeStats
 Holds the calculated statistics for every band together of every input cubei after the CalculateStatistics method is called. More...
 
std::vector< Isis::Cube * > InputCubes
 A vector of pointers to opened Cube objects. More...
 
std::vector< Isis::Cube * > OutputCubes
 A vector of pointers to allocated Cube objects. More...
 
QSet< Isis::Cube * > * m_ownedCubes
 A list of cubes owned by this instant. More...
 

Private Attributes

PdsResolution m_exportResolution
 Meters or kilometers. More...
 
bool m_forceBands
 Indicates whether to keep the BANDS keyword in the PDS labels. More...
 
bool m_forceBandName
 Indicates whether to keep the BAND_NAME keyword in the PDS labels. More...
 
bool m_forceCenterFilterWavelength
 Indicates whether to keep the CENTER_FILTER_WAVELENGTH keyword in the PDS labels. More...
 
bool m_forceBandwidth
 Indicates whether to keep the BANDWIDTH keyword in the PDS labels. More...
 
bool m_forceBandStorageType
 Indicates whether to add the BAND_STORAGE_TYPE keyword in the PDS labels. More...
 
bool m_forceOffset
 Indicates whether to add the OFFSET keyword in the PDS labels. More...
 
bool m_forceScalingFactor
 Indicates whether to add the SCALING_FACTOR keyword in the PDS labels. More...
 
bool m_forceSampleBits
 Indicates whether to add the SAMPLE_BITS keyword in the PDS labels. More...
 
bool m_forceSampleBitMask
 Indicates whether to add the SAMPLE_BIT_MASK keyword in the PDS labels. More...
 
bool m_forceSampleType
 Indicates whether to add the SAMPLE_TYPE keyword in the PDS labels. More...
 
bool m_forceCoreNull
 Indicates whether to add the CORE_NULL keyword in the PDS labels. More...
 
bool m_forceCoreLrs
 Indicates whether to add the CORE_LOW_REPR_SATURATION keyword in the PDS labels. More...
 
bool m_forceCoreLis
 Indicates whether to add the CORE_LOW_INSTR_SATURATION keyword in the PDS labels. More...
 
bool m_forceCoreHrs
 Indicates whether to add the CORE_HIGH_REPR_SATURATION keyword in the PDS labels. More...
 
bool m_forceCoreHis
 Indicates whether to add the CORE_HIGH_INSTR_SATURATION keyword in the PDS labels. More...
 
bool m_detachedLabel
 Indicates whether the PDS file will be detached. More...
 
QString m_detachedPdsLabelFile
 The name of the detached PDS label file. More...
 
PdsFileType m_pdsFileType
 Image, Qube, Spectral Qube, or JP2 Image. More...
 
std::vector< int > m_tableStartRecord
 Record number where the added table data begins. More...
 
std::vector< int > m_tableRecords
 Number of records in each added table. More...
 
std::vector< char * > m_tableBuffers
 Vector containing the binary table data for each of the added tables. More...
 

Detailed Description

Process class for exporting cubes to PDS standards.

This class extends the ProcessExport class to allow the user to export cubes to PDS format.

Tables from the cube may also be exported. These exported PDS tables may be attached or detached. This should correspond to whether the labels of the exported PDS file are attached or detached. NOTE: If attached, the labels of the table should not be altered in the export program unless functionality is added to deal with the new start byte values for the tables.

Author
2006-09-05 Stuart Sides
History:

2006-09-05 Stuart Sides - Original version

2006-12-14 Stuart Sides - Modified keword units to be PDS compliant

2008-05-20 Steven Lambright - Fixed documentation

2008-08-07 Christopher Austin - Added fixed label export capability

2008-10-02 Christopher Austin - Fixed LabelSize() and OutputLabel() in accordace to the pds end of line sequence requirement

2008-12-17 Steven Lambright - Added calculations for OFFSET and SCALEFACTOR keywords

2009-05-31 Kris Becker - Included the number of bands in the computation of the number of FILE_RECORDS for fixed PDS type products. It assumed only 1 band.

2010-02-24 Janet Barrett - Added code to support JPEG2000.

2010-07-21 Sharmila Prasad - Fixed error while converting resolution from Meters to Kilometers

2012-04-06 Kris Becker - Correct label padding whereby spaces are used as the fill character instead of '\0'. This makes it compliant with PDS specifications.

2012-11-21 Jeannie Backer - Added functionality to allow export of Isis3 Table objects to binary PDS tables. The PDS tables may be attached or detached. If attached, the labels of the table should not be altered in the export program unless functionality is added to deal with the new start byte values. References #678.

2014-06-06 Kristin Berry - Added default units to assume if there are no units on certain values in the input Isis cube. Unlabeled radii are assumed to be in meters; map scales to be in meters/pixel, and map resolutions to be in pixels/degree.

2017-05-17 Makayla Shepherd & Ian Humphrey - Added updateChecksumInLabel() to convert the placeholder value to the actual generated checksum value. Modified StreamImageRoot() and FixedImageRoot() to create CHECKSUM placeholder in the labels if we are generating a checksum. Fixes #1013.

2017-10-18 Makayla Shepard - Removed code associated with completely empty unused file pdsExportAllMapping.trn. References #5202.

Definition at line 90 of file ProcessExportPds.h.

Member Enumeration Documentation

◆ ExportFormat

Storage order enumeration.

Enumerator
BSQ 

Band sequential.

BIL 

Band interleaved by line.

BIP 

Band interleaved by pixel.

JP2 

Compressed JPEG2000.

Definition at line 130 of file ProcessExport.h.

◆ PdsExportType

Record format type of exported PDS file.

See also
http://pds.nasa.gov/documents/sr/Chapter15.pdf
Enumerator
Stream 

Stream Records. This type is generally used for ASCII files.

Fixed 

Fixed length records.

PDS recommends that FIXED_LENGTH records are used whenever possible.

Definition at line 122 of file ProcessExportPds.h.

◆ PdsFileType

File type to be exported.

See also
http://pds.nasa.gov/documents/sr/AppendixA.pdf
Enumerator
Image 

Two dimensional array of line/sample values.

These files generallly have the extension *.img or *.imq

Qube 

Multi-dimensional array (1-3 dimensional) whose axes may be interpreted as line/sample/band.

These files generally have the extension *.qub

SpectralQube 

Three dimensional objects with two spatial dimensions and one spectral dimension.

These files generally have the extension *.qub

JP2Image 

Image coding system JPEG 2000 formatted image.

These files generally have the extension *.jp2

Definition at line 96 of file ProcessExportPds.h.

◆ PdsResolution

Resolution units per pixel of the exported PDS file.

Enumerator
Meter 

Meters per pixel.

Kilometer 

Kilometers per pixel.

Definition at line 112 of file ProcessExportPds.h.

Constructor & Destructor Documentation

◆ ProcessExportPds()

Isis::ProcessExportPds::ProcessExportPds ( )

Default Constructor - Set to default the data members.

Definition at line 48 of file ProcessExportPds.cpp.

◆ ~ProcessExportPds()

Isis::ProcessExportPds::~ProcessExportPds ( )

Destructor.

Definition at line 80 of file ProcessExportPds.cpp.

Member Function Documentation

◆ Attached()

bool Isis::ProcessExportPds::Attached ( )

Accessor function returns true if the output PDS file is set to attached.

Returns
bool Indicates whether the PDS file is attached.

Definition at line 1103 of file ProcessExportPds.cpp.

◆ BandStatistics()

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

Definition at line 290 of file Process.h.

References Isis::Process::p_bandStats.

◆ CalculateStatistics()

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.

Definition at line 737 of file Process.cpp.

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().

◆ canGenerateChecksum()

bool Isis::ProcessExport::canGenerateChecksum ( )
inherited

Return if we can generate a checksum

Returns
Boolean to generate the checksum or not

Definition at line 694 of file ProcessExport.cpp.

References Isis::ProcessExport::m_canGenerateChecksum.

◆ checksum()

QString Isis::ProcessExport::checksum ( )
inherited

Generates a file checksum.

This must be called after StartProcess.

Returns
QString Returns a QString of the checksum.

Definition at line 704 of file ProcessExport.cpp.

References _FILEINFO_, Isis::ProcessExport::m_canGenerateChecksum, Isis::ProcessExport::m_cryptographicHash, and Isis::IException::Programmer.

◆ ClearCubes()

void Isis::Process::ClearCubes ( )
inherited

Close owned cubes from the list and clear the list.

Definition at line 509 of file Process.cpp.

◆ ClearInputCubes()

void Isis::Process::ClearInputCubes ( )
inherited

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

Definition at line 519 of file Process.cpp.

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

◆ ClearOutputCubes()

void Isis::Process::ClearOutputCubes ( )
inherited

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

Definition at line 533 of file Process.cpp.

◆ CreateImageLabel()

void Isis::ProcessExportPds::CreateImageLabel ( )
protectedvirtual

Create a standard PDS label for type IMAGE.

Definition at line 131 of file ProcessExportPds.cpp.

References _FILEINFO_.

◆ CreateQubeLabel()

void Isis::ProcessExportPds::CreateQubeLabel ( )
protected

Create a standard PDS label for type QUBE.

Definition at line 173 of file ProcessExportPds.cpp.

References Isis::PvlObject::findObject(), and Isis::PvlObject::hasObject().

◆ CreateSpectralQubeLabel()

void Isis::ProcessExportPds::CreateSpectralQubeLabel ( )
protected

Create a standard PDS label for type SPECTRAL_QUBE.

Definition at line 194 of file ProcessExportPds.cpp.

References Isis::PvlObject::findObject(), and Isis::PvlObject::hasObject().

◆ CreateWorldFile()

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

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.

Definition at line 1265 of file ProcessExport.cpp.

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

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

◆ CubeStatistics()

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

Definition at line 304 of file Process.h.

References Isis::Process::p_cubeStats.

◆ Detached()

bool Isis::ProcessExportPds::Detached ( )

Accessor function returns true if the output PDS file is set to detached.

Returns
bool Indicates whether the PDS file is detached.

Definition at line 1094 of file ProcessExportPds.cpp.

◆ EndProcess()

void Isis::Process::EndProcess ( )
virtualinherited

◆ ExportTable()

void Isis::ProcessExportPds::ExportTable ( Isis::Table  isisTable,
QString  detachedPdsTableFileName = "" 
)

This method will add a table to be exported to PDS.

If the output PDS labels are set to detached, the PDS table will be written to a detached file in this method. If the output PDS product is set to attached, the table will be added to a buffer and written to the PDS file when the StartProcess() method is called. Attached tables are written to the file after the image data.

Warning: If attached tables are exported and the labels of these tables are modified, the start byte value of the labels will need to be updated. There is no existing method (UpdateAttachedTableLabels) to do this in ProcessExportPds. If this functionality is needed, this class will need to be modified accordingly.

Exceptions
IException::Unknown- "The output PDS file has been set to attached and a detached PDS table file name has been given. If detached is preferred, set the process to detached SetDetached() and call StandardPdsLabel() before calling ExportTable()." @throw IException::Unknown - "The output PDS file has been set to detached. A file name for the detached ouput PDS table file is required. If an attached output file is prefered, use the method ProcessExportPds::SetAttached() before calling ExportTable()."
Parameters
isisTableThe Isis3 Table object to be exported to PDS.
detachedPdsTableFileNameThe name of the exported PDS table file, if detached. This value should not include a path. The path from the label file will be used.

Definition at line 1008 of file ProcessExportPds.cpp.

References _FILEINFO_, Isis::ExportPdsTable::exportTable(), and Isis::Table::Records().

◆ Finalize()

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.

Definition at line 491 of file Process.cpp.

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

◆ FixedImageRoot()

void Isis::ProcessExportPds::FixedImageRoot ( Pvl mainPvl)

Create the fixed keywords for the ROOT object in a PDS IMAGE file.

Parameters
mainPvl

Definition at line 307 of file ProcessExportPds.cpp.

References Isis::FileName::name().

◆ FixedJP2ImageRoot()

void Isis::ProcessExportPds::FixedJP2ImageRoot ( Pvl mainPvl)

Create the fixed keywords for the ROOT object in a PDS JP2 IMAGE file.

Parameters
mainPvl

Definition at line 342 of file ProcessExportPds.cpp.

References _FILEINFO_, Isis::PvlObject::addObject(), Isis::FileName::name(), and Isis::toString().

◆ ForceBandName()

void Isis::ProcessExportPds::ForceBandName ( bool  force)

Mutator method to set how the BAND_NAME keyword will be handled.

If false and the BAND_NAME keyword exists in the IMAGE object of the PDS labels, the keyword will be removed. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to keep the BAND_NAME keyword in the PDS image labels.

Definition at line 1149 of file ProcessExportPds.cpp.

◆ ForceBands()

void Isis::ProcessExportPds::ForceBands ( bool  force)

Mutator method to set how the the BANDS keyword will be handled.

If false, the BANDS keyword will be removed from the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to keep the BANDS keyword in the PDS image labels.

Definition at line 1136 of file ProcessExportPds.cpp.

◆ ForceBandStorageType()

void Isis::ProcessExportPds::ForceBandStorageType ( bool  force)

Mutator method to set how the BAND_STORAGE_TYPE keyword will be handled.

If true, the BAND_STORAGE_TYPE keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the BAND_STORAGE_TYPE keyword in the PDS image labels.

Definition at line 1188 of file ProcessExportPds.cpp.

◆ ForceBandwidth()

void Isis::ProcessExportPds::ForceBandwidth ( bool  force)

Mutator method to set how the BANDWIDTH keyword will be handled.

If false and the BANDWIDTH keyword exists in the IMAGE object of the PDS labels, the keyword will be removed. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to keep the BANDWIDTH keyword in the PDS image labels.

Definition at line 1175 of file ProcessExportPds.cpp.

◆ ForceCenterFilterWavelength()

void Isis::ProcessExportPds::ForceCenterFilterWavelength ( bool  force)

Mutator method to set how the CENTER_FILTER_WAVELENGTH keyword will be handled.

If false and the CENTER_FILTER_WAVELENGTH keyword exists in the IMAGE object of the PDS labels, the keyword will be removed. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to keep the CENTER_FILTER_WAVELENGTH keyword in the PDS image labels.

Definition at line 1162 of file ProcessExportPds.cpp.

◆ ForceCoreHis()

void Isis::ProcessExportPds::ForceCoreHis ( bool  force)

Mutator method to set how the CORE_HIGH_INSTR_SATURATION keyword will be handled.

If true, the CORE_HIGH_INSTR_SATURATION keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the CORE_HIGH_INSTR_SATURATION keyword in the PDS image labels.

Definition at line 1321 of file ProcessExportPds.cpp.

◆ ForceCoreHrs()

void Isis::ProcessExportPds::ForceCoreHrs ( bool  force)

Mutator method to set how the CORE_HIGH_REPR_SATURATION keyword will be handled.

If true, the CORE_HIGH_REPR_SATURATION keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the CORE_HIGH_REPR_SATURATION keyword in the PDS image labels.

Definition at line 1307 of file ProcessExportPds.cpp.

◆ ForceCoreLis()

void Isis::ProcessExportPds::ForceCoreLis ( bool  force)

Mutator method to set how the CORE_LOW_INSTR_SATURATION keyword will be handled.

If true, the CORE_LOW_INSTR_SATURATION keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the CORE_LOW_INSTR_SATURATION keyword in the PDS image labels.

Definition at line 1293 of file ProcessExportPds.cpp.

◆ ForceCoreLrs()

void Isis::ProcessExportPds::ForceCoreLrs ( bool  force)

Mutator method to set how the CORE_LOW_REPR_SATURATION keyword will be handled.

If true, the CORE_LOW_REPR_SATURATION keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the CORE_LOW_REPR_SATURATION keyword in the PDS image labels.

Definition at line 1279 of file ProcessExportPds.cpp.

◆ ForceCoreNull()

void Isis::ProcessExportPds::ForceCoreNull ( bool  force)

Mutator method to set how the CORE_NULL keyword will be handled.

If true, the CORE_NULL keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the CORE_NULL keyword in the PDS image labels.

Definition at line 1266 of file ProcessExportPds.cpp.

◆ ForceOffset()

void Isis::ProcessExportPds::ForceOffset ( bool  force)

Mutator method to set how the OFFSET keyword will be handled.

If true, the OFFSET keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the OFFSET keyword in the PDS image labels.

Definition at line 1201 of file ProcessExportPds.cpp.

◆ ForceSampleBitMask()

void Isis::ProcessExportPds::ForceSampleBitMask ( bool  force)

Mutator method to set how the SAMPLE_BIT_MASK keyword will be handled.

If true, the SAMPLE_BIT_MASK keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the SAMPLE_BIT_MASK keyword in the PDS image labels.

Definition at line 1240 of file ProcessExportPds.cpp.

◆ ForceSampleBits()

void Isis::ProcessExportPds::ForceSampleBits ( bool  force)

Mutator method to set how the SAMPLE_BITS keyword will be handled.

If true, the SAMPLE_BITS keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the SAMPLE_BITS keyword in the PDS image labels.

Definition at line 1227 of file ProcessExportPds.cpp.

◆ ForceSampleType()

void Isis::ProcessExportPds::ForceSampleType ( bool  force)

Mutator method to set how the SAMPLE_TYPE keyword will be handled.

If true, the SAMPLE_TYPE keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the SAMPLE_TYPE keyword in the PDS image labels.

Definition at line 1253 of file ProcessExportPds.cpp.

◆ ForceScalingFactor()

void Isis::ProcessExportPds::ForceScalingFactor ( bool  force)

Mutator method to set how the SCALING_FACTOR keyword will be handled.

If true, the SCALING_FACTOR keyword will be added to the IMAGE object of the PDS labels. This member variable defaults to true in the ProcessExportPds constructor.

Parameters
forceIndicates whether to force the process to add the SCALING_FACTOR keyword in the PDS image labels.

Definition at line 1214 of file ProcessExportPds.cpp.

◆ GetBuffersBIL()

vector< BufferManager * > Isis::ProcessExport::GetBuffersBIL ( )
protectedinherited

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

Definition at line 954 of file ProcessExport.cpp.

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

◆ GetBuffersBIP()

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

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

Definition at line 992 of file ProcessExport.cpp.

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

◆ GetBuffersBSQ()

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

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

Definition at line 915 of file ProcessExport.cpp.

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

◆ GetInputMaximum()

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

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

Definition at line 439 of file ProcessExport.cpp.

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

◆ GetInputMinimum()

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

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

Definition at line 428 of file ProcessExport.cpp.

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

◆ GetOutputMaximum()

double Isis::ProcessExport::GetOutputMaximum ( )
inlineinherited

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

Definition at line 178 of file ProcessExport.h.

References Isis::ProcessExport::p_outputMaximum.

◆ GetOutputMinimum()

double Isis::ProcessExport::GetOutputMinimum ( )
inlineinherited

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

Definition at line 174 of file ProcessExport.h.

References Isis::ProcessExport::p_outputMinimum.

◆ LabelSize()

int Isis::ProcessExportPds::LabelSize ( )
protected

Return the size of the output PDS label.

Returns
Number of bytes in the label.

Definition at line 862 of file ProcessExportPds.cpp.

◆ LineBytes()

int Isis::ProcessExportPds::LineBytes ( )
protected

Return the line bytes (record size) for the input cube, at present this is based on the number of samples and the bytes per pixel.

Returns
Total number of bytes per line.

Definition at line 849 of file ProcessExportPds.cpp.

References Isis::Cube::sampleCount(), and Isis::SizeOf().

◆ MissionData()

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.

Definition at line 682 of file Process.cpp.

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

◆ OutputDetachedLabel()

void Isis::ProcessExportPds::OutputDetachedLabel ( )

Write the PDS label to the a detached file.

The PDS keywords that have place holder "?" for their values (such as LABEL_RECORDS and ^IMAGE) will be updated to their correct values before they are written.

Definition at line 878 of file ProcessExportPds.cpp.

References _FILEINFO_.

◆ OutputHis()

double Isis::ProcessExport::OutputHis ( )
inherited

Return the output special pixel value for HIS.

Definition at line 579 of file ProcessExport.cpp.

References Isis::ProcessExport::p_His, Isis::ProcessExport::p_His_Set, and Isis::ProcessExport::p_outputMaximum.

Referenced by Isis::ProcessExport::InitProcess().

◆ OutputHrs()

double Isis::ProcessExport::OutputHrs ( )
inherited

Return the output special pixel value for HRS.

Definition at line 587 of file ProcessExport.cpp.

References Isis::ProcessExport::p_Hrs, Isis::ProcessExport::p_Hrs_Set, and Isis::ProcessExport::p_outputMaximum.

Referenced by Isis::ProcessExport::InitProcess().

◆ OutputLabel()

void Isis::ProcessExportPds::OutputLabel ( std::ofstream &  os)

Write the PDS label to the supplied stream.

The PDS keywords that have place holder "?" for their values (such as LABEL_RECORDS and ^IMAGE) will be updated to their correct values before they are written.

Parameters
Outputfile stream to which the pds label will be written.

Definition at line 897 of file ProcessExportPds.cpp.

References Isis::toString().

◆ OutputLis()

double Isis::ProcessExport::OutputLis ( )
inherited

Return the output special pixel value for LIS.

Definition at line 563 of file ProcessExport.cpp.

References Isis::ProcessExport::p_Lis, Isis::ProcessExport::p_Lis_Set, and Isis::ProcessExport::p_outputMinimum.

Referenced by Isis::ProcessExport::InitProcess().

◆ OutputLrs()

double Isis::ProcessExport::OutputLrs ( )
inherited

Return the output special pixel value for LRS.

Definition at line 571 of file ProcessExport.cpp.

References Isis::ProcessExport::p_Lrs, Isis::ProcessExport::p_Lrs_Set, and Isis::ProcessExport::p_outputMinimum.

Referenced by Isis::ProcessExport::InitProcess().

◆ OutputNull()

double Isis::ProcessExport::OutputNull ( )
inherited

Return the output special pixel value for NULL.

Definition at line 555 of file ProcessExport.cpp.

References Isis::ProcessExport::p_Null, Isis::ProcessExport::p_Null_Set, and Isis::ProcessExport::p_outputMinimum.

Referenced by Isis::ProcessExport::InitProcess().

◆ Progress()

◆ ProjectionName()

QString Isis::ProcessExportPds::ProjectionName ( Pvl inputLabel)
protected

Return a projection name.

Parameters
inputLabel
Returns
String containing the name of the projection

Definition at line 835 of file ProcessExportPds.cpp.

References Isis::Projection::Name().

◆ PropagateHistory()

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.

Definition at line 651 of file Process.cpp.

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

◆ PropagateLabels() [1/2]

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.

Definition at line 555 of file Process.cpp.

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

◆ PropagateLabels() [2/2]

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.

Definition at line 566 of file Process.cpp.

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

◆ PropagateOriginalLabel()

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.

Definition at line 662 of file Process.cpp.

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

◆ PropagatePolygons()

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.

Definition at line 641 of file Process.cpp.

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

◆ PropagateTables() [1/2]

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.

Definition at line 594 of file Process.cpp.

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

◆ PropagateTables() [2/2]

void Isis::Process::PropagateTables ( const QString &  fromName,
const QList< QString > &  tableNames = QList<QString>() 
)
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. The names of the tables to propagate can be provided through the second paramter, by specifing a list of table names. Not providing any list (or providing an empty list) will propagate all tables.

Parameters
fromNameQString of the name of the cube containing the tables to propagate.
tableNamesList of QStrings of the names of the tables to propagate; default is empty, which indicates that all tables will be propagated.
History:
2016-11-30 Ian Humphrey - Added tableNames parameter so that only specified tables will be propagated when calling this method. Note that a default of an empty QList is used to propagate all tables. References #4433.

Definition at line 614 of file Process.cpp.

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

◆ SetAttached()

void Isis::ProcessExportPds::SetAttached ( )

Mutator method to set the output PDS file to attached.

In this case, there will be a single output file containing the PDS label, image data, and any PDS tables that are added.

Definition at line 1084 of file ProcessExportPds.cpp.

◆ setCanGenerateChecksum()

void Isis::ProcessExport::setCanGenerateChecksum ( bool  flag)
inherited

Set m_canGenerateChecksum which determines if we can generate a MD5 checksum on the image data.

Parameters
flagboolean to generate the checksum or not

Definition at line 683 of file ProcessExport.cpp.

References Isis::ProcessExport::m_canGenerateChecksum.

◆ SetDetached()

void Isis::ProcessExportPds::SetDetached ( QString  detachedLabelFile)

Mutator method to set the output PDS file to detached.

In this case, there will be separate output files containing the PDS label, image data, and any PDS tables that are added.

Parameters
detachedLabelFileA string containing the name of the detached PDS label file

Definition at line 1073 of file ProcessExportPds.cpp.

◆ SetExportType()

void Isis::ProcessExportPds::SetExportType ( PdsExportType  recordFormat)

Mutator method to set the output PDS image record type to stream or fixed.

Parameters
recordFormatEnumerated value for the record type of the exported PDS file.

Definition at line 1124 of file ProcessExportPds.cpp.

◆ setFormat()

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

Sets the storage order of the output file.

Definition at line 183 of file ProcessExport.h.

References Isis::ProcessExport::p_format.

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

◆ SetInputCube() [1/3]

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::ProcessByLine, Isis::ProcessByBrick, Isis::ProcessBySpectra, and Isis::ProcessBySample.

Definition at line 243 of file Process.cpp.

Referenced by Isis::ImageExporter::addChannel(), Isis::JigsawRunWidget::on_JigsawAcceptButton_clicked(), Isis::FileTool::saveAsEnlargedCube(), and Isis::ProcessGroundPolygons::SetStatCubes().

◆ SetInputCube() [2/3]

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.

Definition at line 82 of file Process.cpp.

References _FILEINFO_, Isis::Cube::bandCount(), Isis::CubeAttributeInput::bands(), Isis::Cube::lineCount(), Isis::Cube::open(), Isis::Cube::sampleCount(), and Isis::Cube::setVirtualBands().

◆ SetInputCube() [3/3]

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.

Definition at line 201 of file Process.cpp.

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

◆ SetInputRange() [1/5]

void Isis::ProcessExport::SetInputRange ( )
inherited

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>

Definition at line 374 of file ProcessExport.cpp.

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

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

◆ SetInputRange() [2/5]

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

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

Definition at line 108 of file ProcessExport.cpp.

References Isis::ProcessExport::SetInputRange().

◆ SetInputRange() [3/5]

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

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

Definition at line 137 of file ProcessExport.cpp.

References Isis::ProcessExport::SetInputRange().

◆ SetInputRange() [4/5]

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

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

Definition at line 168 of file ProcessExport.cpp.

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

◆ SetInputRange() [5/5]

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

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

Definition at line 216 of file ProcessExport.cpp.

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

◆ SetOutputCube() [1/3]

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.

Definition at line 266 of file Process.cpp.

References _FILEINFO_.

Referenced by Isis::FileTool::saveAsEnlargedCube(), and Isis::ProcessImport::SetOutputCube().

◆ SetOutputCube() [2/3]

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

Definition at line 302 of file Process.cpp.

References _FILEINFO_.

◆ SetOutputCube() [3/3]

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

◆ SetOutputEndian()

void Isis::ProcessExport::SetOutputEndian ( enum ByteOrder  byteOrderIn)
inherited

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)

Definition at line 659 of file ProcessExport.cpp.

References Isis::ProcessExport::p_endianSwap, and Isis::ProcessExport::p_endianType.

Referenced by Isis::ProcessExport::ProcessExport().

◆ SetOutputHis()

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

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

Definition at line 531 of file ProcessExport.cpp.

References Isis::ProcessExport::p_His, and Isis::ProcessExport::p_His_Set.

◆ SetOutputHrs()

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

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

Definition at line 546 of file ProcessExport.cpp.

References Isis::ProcessExport::p_Hrs, and Isis::ProcessExport::p_Hrs_Set.

◆ SetOutputLis()

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

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

Definition at line 501 of file ProcessExport.cpp.

References Isis::ProcessExport::p_Lis, and Isis::ProcessExport::p_Lis_Set.

◆ SetOutputLrs()

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

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

Definition at line 516 of file ProcessExport.cpp.

References Isis::ProcessExport::p_Lrs, and Isis::ProcessExport::p_Lrs_Set.

◆ SetOutputNull()

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

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

Definition at line 486 of file ProcessExport.cpp.

References Isis::ProcessExport::p_Null, and Isis::ProcessExport::p_Null_Set.

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

◆ SetOutputRange()

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

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

Definition at line 464 of file ProcessExport.cpp.

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

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

◆ SetOutputType()

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

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

Definition at line 618 of file ProcessExport.cpp.

References _FILEINFO_, Isis::ProcessExport::JP2, Isis::ProcessExport::p_format, Isis::ProcessExport::p_pixelType, Isis::IException::Programmer, and Isis::ProcessExport::SetOutputRange().

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

◆ SetPdsResolution()

void Isis::ProcessExportPds::SetPdsResolution ( PdsResolution  resolutionUnits)

Mutator method to set the output PDS image resolution to meters per pixel or kilometers per pixel.

Parameters
resolutionUnitsEnumerated value for the units type to be set.

Definition at line 1113 of file ProcessExportPds.cpp.

◆ StandardAllMapping()

void Isis::ProcessExportPds::StandardAllMapping ( Pvl outputPvl)

◆ StandardImageImage()

void Isis::ProcessExportPds::StandardImageImage ( Pvl mainPvl)

Create the standard keywords for an IMAGE object in a PDS IMAGE file.

This should not be called until after all settings have been made. The labels may contain the wrong data if it is.

Parameters
mainPvl
Exceptions
Isis::IException::Message

Definition at line 402 of file ProcessExportPds.cpp.

References _FILEINFO_, Isis::PvlToPvlTranslationManager::Auto(), Isis::PvlContainer::deleteKeyword(), Isis::FileName::expanded(), Isis::PvlObject::findObject(), Isis::PvlObject::hasKeyword(), and Isis::toString().

◆ StandardJP2Image()

void Isis::ProcessExportPds::StandardJP2Image ( Pvl mainPvl)

Create the standard keywords for an IMAGE object in a PDS JP2 IMAGE file.

This should not be called until after all settings have been made. The labels may contain the wrong data if it is.

Parameters
mainPvl
Exceptions
Isis::IException::Message

Definition at line 543 of file ProcessExportPds.cpp.

References _FILEINFO_, Isis::PvlToPvlTranslationManager::Auto(), Isis::PvlContainer::deleteKeyword(), Isis::FileName::expanded(), Isis::PvlObject::findObject(), Isis::PvlObject::hasKeyword(), and Isis::toString().

◆ StandardPdsLabel()

Pvl & Isis::ProcessExportPds::StandardPdsLabel ( ProcessExportPds::PdsFileType  type)
virtual

Create a standard PDS label of the type specified.

Create a standard PDS label of the type specified. The type must be Image. Qube and SpectralQube are not supported.

NOTE: This method should not be called until all setting have been finished. For example ProcessExport::SetOutputEndian

Parameters
typeThe type of PDS label to be created.
Returns
Pvl containing label information
Exceptions
Isis::iException::Message

Definition at line 104 of file ProcessExportPds.cpp.

References _FILEINFO_.

◆ StartProcess() [1/5]

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

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

Definition at line 800 of file ProcessExport.cpp.

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

◆ StartProcess() [2/5]

void Isis::ProcessExport::StartProcess

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

Definition at line 800 of file ProcessExport.cpp.

◆ StartProcess() [3/5]

void Isis::ProcessExport::StartProcess

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.

Definition at line 1027 of file ProcessExport.cpp.

◆ StartProcess() [4/5]

void Isis::ProcessExportPds::StartProcess ( std::ofstream &  fout)
virtual

This method fills the image data of the PDS file using the parent class ProcessExport::StartProcess, then appends any attached tables.

Parameters
foutOutput file stream to be filled with the PDS data.

Reimplemented from Isis::ProcessExport.

Definition at line 1332 of file ProcessExportPds.cpp.

References _FILEINFO_.

◆ StartProcess() [5/5]

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

Definition at line 228 of file Process.h.

◆ StreamImageRoot()

void Isis::ProcessExportPds::StreamImageRoot ( Pvl mainPvl)

Create the standard keywords for the ROOT object in a PDS IMAGE file.

Parameters
mainPvl

Definition at line 217 of file ProcessExportPds.cpp.

References Isis::FileName::name().

◆ StreamJP2ImageRoot()

void Isis::ProcessExportPds::StreamJP2ImageRoot ( Pvl mainPvl)

Create the standard keywords for the ROOT object in a PDS JP2 IMAGE file.

Parameters
mainPvl

Definition at line 251 of file ProcessExportPds.cpp.

References _FILEINFO_, Isis::PvlObject::addObject(), Isis::FileName::name(), and Isis::toString().

◆ updateChecksumInLabel()

void Isis::ProcessExportPds::updateChecksumInLabel ( std::ofstream &  pdsFileStream)

Updates the CHECKSUM value on the label and rewrites to the output file.

Parameters
std::ofstream&pdsFileStream Output file to write the label to.

Definition at line 965 of file ProcessExportPds.cpp.

◆ WriteHistory()

void Isis::Process::WriteHistory ( Cube cube)
inherited

Member Data Documentation

◆ InputCubes

◆ m_canGenerateChecksum

bool Isis::ProcessExport::m_canGenerateChecksum
protectedinherited

◆ m_cryptographicHash

QCryptographicHash* Isis::ProcessExport::m_cryptographicHash
protectedinherited

A cryptographic hash that will generate an MD5 checksum of the image data.

Definition at line 281 of file ProcessExport.h.

Referenced by Isis::ProcessExport::checksum(), Isis::ProcessExport::ProcessExport(), Isis::ProcessExport::StartProcess(), and Isis::ProcessExport::~ProcessExport().

◆ m_detachedLabel

bool Isis::ProcessExportPds::m_detachedLabel
private

Indicates whether the PDS file will be detached.

Definition at line 237 of file ProcessExportPds.h.

◆ m_detachedPdsLabelFile

QString Isis::ProcessExportPds::m_detachedPdsLabelFile
private

The name of the detached PDS label file.

Definition at line 239 of file ProcessExportPds.h.

◆ m_exportResolution

PdsResolution Isis::ProcessExportPds::m_exportResolution
private

Meters or kilometers.

Definition at line 197 of file ProcessExportPds.h.

◆ m_exportType

PdsExportType Isis::ProcessExportPds::m_exportType
protected

Stream or Fixed.

Definition at line 194 of file ProcessExportPds.h.

◆ m_forceBandName

bool Isis::ProcessExportPds::m_forceBandName
private

Indicates whether to keep the BAND_NAME keyword in the PDS labels.

Definition at line 200 of file ProcessExportPds.h.

◆ m_forceBands

bool Isis::ProcessExportPds::m_forceBands
private

Indicates whether to keep the BANDS keyword in the PDS labels.

Definition at line 198 of file ProcessExportPds.h.

◆ m_forceBandStorageType

bool Isis::ProcessExportPds::m_forceBandStorageType
private

Indicates whether to add the BAND_STORAGE_TYPE keyword in the PDS labels.

Definition at line 207 of file ProcessExportPds.h.

◆ m_forceBandwidth

bool Isis::ProcessExportPds::m_forceBandwidth
private

Indicates whether to keep the BANDWIDTH keyword in the PDS labels.

Definition at line 205 of file ProcessExportPds.h.

◆ m_forceCenterFilterWavelength

bool Isis::ProcessExportPds::m_forceCenterFilterWavelength
private

Indicates whether to keep the CENTER_FILTER_WAVELENGTH keyword in the PDS labels.

Definition at line 202 of file ProcessExportPds.h.

◆ m_forceCoreHis

bool Isis::ProcessExportPds::m_forceCoreHis
private

Indicates whether to add the CORE_HIGH_INSTR_SATURATION keyword in the PDS labels.

Definition at line 234 of file ProcessExportPds.h.

◆ m_forceCoreHrs

bool Isis::ProcessExportPds::m_forceCoreHrs
private

Indicates whether to add the CORE_HIGH_REPR_SATURATION keyword in the PDS labels.

Definition at line 231 of file ProcessExportPds.h.

◆ m_forceCoreLis

bool Isis::ProcessExportPds::m_forceCoreLis
private

Indicates whether to add the CORE_LOW_INSTR_SATURATION keyword in the PDS labels.

Definition at line 228 of file ProcessExportPds.h.

◆ m_forceCoreLrs

bool Isis::ProcessExportPds::m_forceCoreLrs
private

Indicates whether to add the CORE_LOW_REPR_SATURATION keyword in the PDS labels.

Definition at line 225 of file ProcessExportPds.h.

◆ m_forceCoreNull

bool Isis::ProcessExportPds::m_forceCoreNull
private

Indicates whether to add the CORE_NULL keyword in the PDS labels.

Definition at line 223 of file ProcessExportPds.h.

◆ m_forceOffset

bool Isis::ProcessExportPds::m_forceOffset
private

Indicates whether to add the OFFSET keyword in the PDS labels.

Definition at line 210 of file ProcessExportPds.h.

◆ m_forceSampleBitMask

bool Isis::ProcessExportPds::m_forceSampleBitMask
private

Indicates whether to add the SAMPLE_BIT_MASK keyword in the PDS labels.

Definition at line 217 of file ProcessExportPds.h.

◆ m_forceSampleBits

bool Isis::ProcessExportPds::m_forceSampleBits
private

Indicates whether to add the SAMPLE_BITS keyword in the PDS labels.

Definition at line 215 of file ProcessExportPds.h.

◆ m_forceSampleType

bool Isis::ProcessExportPds::m_forceSampleType
private

Indicates whether to add the SAMPLE_TYPE keyword in the PDS labels.

Definition at line 220 of file ProcessExportPds.h.

◆ m_forceScalingFactor

bool Isis::ProcessExportPds::m_forceScalingFactor
private

Indicates whether to add the SCALING_FACTOR keyword in the PDS labels.

Definition at line 212 of file ProcessExportPds.h.

◆ m_formatter

PvlFormatPds* Isis::ProcessExportPds::m_formatter
protected

Used to determine how to format the keyword values in the PDS file.

Definition at line 191 of file ProcessExportPds.h.

◆ m_label

Pvl* Isis::ProcessExportPds::m_label
protected

Exported PDS label.

Definition at line 193 of file ProcessExportPds.h.

◆ m_ownedCubes

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.

Definition at line 214 of file Process.h.

◆ m_pdsFileType

PdsFileType Isis::ProcessExportPds::m_pdsFileType
private

Image, Qube, Spectral Qube, or JP2 Image.

Definition at line 241 of file ProcessExportPds.h.

◆ m_tableBuffers

std::vector<char *> Isis::ProcessExportPds::m_tableBuffers
private

Vector containing the binary table data for each of the added tables.

The order of the tables represented in this vector corresponds to the order of the table data in m_tableRecords.

Definition at line 254 of file ProcessExportPds.h.

◆ m_tableRecords

std::vector<int> Isis::ProcessExportPds::m_tableRecords
private

Number of records in each added table.

The order of the tables represented in this vector corresponds to the order of the table data in m_tableBuffers.

Definition at line 249 of file ProcessExportPds.h.

◆ m_tableStartRecord

std::vector<int> Isis::ProcessExportPds::m_tableStartRecord
private

Record number where the added table data begins.

The order of the tables represented in this vector corresponds to the order of the table data in m_tableBuffers

Definition at line 244 of file ProcessExportPds.h.

◆ OutputCubes

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

◆ p_bandStats

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.

Definition at line 187 of file Process.h.

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

◆ p_cubeStats

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.

Definition at line 194 of file Process.h.

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

◆ p_endianSwap

EndianSwapper* Isis::ProcessExport::p_endianSwap
protectedinherited

◆ p_endianType

ByteOrder Isis::ProcessExport::p_endianType
protectedinherited

The byte order of the output file.

Definition at line 252 of file ProcessExport.h.

Referenced by Isis::ProcessExport::SetOutputEndian().

◆ p_format

ExportFormat Isis::ProcessExport::p_format
protectedinherited

◆ p_His

double Isis::ProcessExport::p_His
protectedinherited

The output value for pixels whose input DNs are High Instrument Saturation values.

Definition at line 265 of file ProcessExport.h.

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

◆ p_His_Set

bool Isis::ProcessExport::p_His_Set
protectedinherited

Indicates whether p_His has been set (i.e.

if setHis() has been called).

Definition at line 276 of file ProcessExport.h.

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

◆ p_Hrs

double Isis::ProcessExport::p_Hrs
protectedinherited

The output value for pixels whose input DNs are High Representation Saturation values.

Definition at line 267 of file ProcessExport.h.

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

◆ p_Hrs_Set

bool Isis::ProcessExport::p_Hrs_Set
protectedinherited

Indicates whether p_Hrs has been set (i.e.

if setHrs() has been called).

Definition at line 278 of file ProcessExport.h.

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

◆ p_inputMaximum

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

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

Definition at line 247 of file ProcessExport.h.

Referenced by Isis::ProcessExport::GetInputMaximum(), Isis::ProcessExport::InitProcess(), Isis::ProcessExport::ProcessExport(), and Isis::ProcessExport::SetInputRange().

◆ p_inputMiddle

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

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

Definition at line 243 of file ProcessExport.h.

Referenced by Isis::ProcessExport::InitProcess(), Isis::ProcessExport::ProcessExport(), and Isis::ProcessExport::SetInputRange().

◆ p_inputMinimum

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

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

Definition at line 240 of file ProcessExport.h.

Referenced by Isis::ProcessExport::GetInputMinimum(), Isis::ProcessExport::InitProcess(), Isis::ProcessExport::ProcessExport(), and Isis::ProcessExport::SetInputRange().

◆ p_Lis

double Isis::ProcessExport::p_Lis
protectedinherited

The output value for pixels whose input DNs are Low Instrument Saturation values.

Definition at line 261 of file ProcessExport.h.

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

◆ p_Lis_Set

bool Isis::ProcessExport::p_Lis_Set
protectedinherited

Indicates whether p_Lis has been set (i.e.

if setLis() has been called).

Definition at line 272 of file ProcessExport.h.

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

◆ p_Lrs

double Isis::ProcessExport::p_Lrs
protectedinherited

The output value for pixels whose input DNs are Low Representation Saturation values.

Definition at line 263 of file ProcessExport.h.

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

◆ p_Lrs_Set

bool Isis::ProcessExport::p_Lrs_Set
protectedinherited

Indicates whether p_Lrs has been set (i.e.

if setLrs() has been called).

Definition at line 274 of file ProcessExport.h.

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

◆ p_Null

double Isis::ProcessExport::p_Null
protectedinherited

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

Definition at line 260 of file ProcessExport.h.

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

◆ p_Null_Set

bool Isis::ProcessExport::p_Null_Set
protectedinherited

Indicates whether p_Null has been set (i.e.

if setNull() has been called).

Definition at line 270 of file ProcessExport.h.

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

◆ p_outputMaximum

double Isis::ProcessExport::p_outputMaximum
protectedinherited

◆ p_outputMiddle

double Isis::ProcessExport::p_outputMiddle
protectedinherited

Middle pixel value (minimum+maximun)/2.0 in the Buffer.

Definition at line 236 of file ProcessExport.h.

Referenced by Isis::ProcessExport::InitProcess(), Isis::ProcessExport::ProcessExport(), and Isis::ProcessExport::SetOutputRange().

◆ p_outputMinimum

◆ p_pixelType

PixelType Isis::ProcessExport::p_pixelType
protectedinherited

The bits per pixel of the output image.

Definition at line 254 of file ProcessExport.h.

Referenced by Isis::ProcessExport::SetOutputType(), and Isis::ProcessExport::StartProcess().

◆ p_progress

◆ p_propagateHistory

bool Isis::Process::p_propagateHistory
protectedinherited

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

Definition at line 176 of file Process.h.

◆ p_propagateLabels

bool Isis::Process::p_propagateLabels
protectedinherited

Flag indicating if labels are be propagated to output cubes.

Definition at line 164 of file Process.h.

◆ p_propagateOriginalLabel

bool Isis::Process::p_propagateOriginalLabel
protectedinherited

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

Definition at line 180 of file Process.h.

◆ p_propagatePolygons

bool Isis::Process::p_propagatePolygons
protectedinherited

Flag indicating if blobs are be propagated to output cubes.

Definition at line 172 of file Process.h.

◆ p_propagateTables

bool Isis::Process::p_propagateTables
protectedinherited

Flag indicating if tables are be propagated to output cubes.

Definition at line 168 of file Process.h.

◆ p_str

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

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

Definition at line 256 of file ProcessExport.h.

Referenced by Isis::ProcessExport::InitProcess(), Isis::ProcessExport::StartProcess(), and Isis::ProcessExport::~ProcessExport().


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