#include <ossimRegTool.h>

Inheritance diagram for ossimRegTool:

Public Member Functions
	ossimRegTool ()

virtual	~ossimRegTool ()

virtual void	setUsage (ossimArgumentParser &ap)
	Initializes the aurgument parser with expected parameters and options. More...

virtual bool	initialize (ossimArgumentParser &ap)
	Initial method to be ran prior to execute. More...

virtual void	initialize (const ossimKeywordlist &ap)
	This method is responsible for completely setting up the full processing chain according to the specifications given in the kwl passed in. More...

virtual bool	execute ()
	Performs the actual product write. More...

virtual ossimString	getClassName () const

virtual void	getKwlTemplate (ossimKeywordlist &kwl)
	Assigns a template keywordlist to string for initializing derived classes. More...

Public Member Functions inherited from ossimChipProcTool
	ossimChipProcTool ()
	default constructor More...

virtual	~ossimChipProcTool ()
	virtual destructor More...

virtual void	clear ()
	Disconnects and clears the dem and image layers. More...

virtual void	abort ()

virtual bool	isChipProcessor () const
	Overrides base class implementation to indicate this class supports getChip() calls. More...

virtual ossimListenerManager *	getManager ()

virtual ossimObject *	getObject ()

virtual const ossimObject *	getObject () const

virtual ossimRefPtr< ossimImageData >	getChip (const ossimIrect &img_rect)
	The meat and potatos of this class. More...

virtual ossimRefPtr< ossimImageData >	getChip (const ossimGrect &gnd_rect)

ossimRefPtr< ossimImageData >	getChip (const ossimDrect &map_bounding_rect, const ossimDpt &gsd)

ossimRefPtr< ossimImageData >	getChip ()
	Get chip method that assumes pre-initialized state. More...

const ossimFilename &	getProductFilename () const

Public Member Functions inherited from ossimTool
	ossimTool ()

virtual	~ossimTool ()

virtual void	loadJSON (const Json::Value &json_request)
	Reads processing params from JSON object provided. More...

virtual void	saveJSON (Json::Value &json) const
	Fetch product as JSON object when applicable Always returns true since using exception on error. More...

virtual const std::string &	getResponse () const
	Fetch product as string (typically JSON) when applicable, otherwise passes back empty string. More...

void	getAPI (std::string &out) const
	Outputs a JSON representation of the Utility's API. More...

std::string	getAPI () const

void	getBuildDate (std::string &s) const
	Gets build date. More...

void	getRevision (std::string &s) const
	Gets revision. More...

void	getVersion (std::string &s) const
	Gets version. More...

void	setOutputStream (std::ostream *os)
	Redirects any console output to the supplied stream for logging or JNI application. More...

bool	helpRequested () const
	Returns true when the initialization detects a "--help" option, so caller can avoid subsequent execute() call. More...

Public Member Functions inherited from ossimObject
	ossimObject ()

virtual	~ossimObject ()

virtual ossimObject *	dup () const

virtual ossimString	getShortName () const

virtual ossimString	getLongName () const

virtual ossimString	getDescription () const

virtual RTTItypeid	getType () const

virtual bool	canCastTo (ossimObject *obj) const

virtual bool	canCastTo (const RTTItypeid &id) const

virtual bool	canCastTo (const ossimString &parentClassName) const

virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=0) const

virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=0)

virtual std::ostream &	print (std::ostream &out) const
	Generic print method. More...

virtual bool	isEqualTo (const ossimObject &obj, ossimCompareType compareType=OSSIM_COMPARE_FULL) const

virtual void	accept (ossimVisitor &visitor)

Public Member Functions inherited from ossimReferenced
	ossimReferenced ()

	ossimReferenced (const ossimReferenced &)

ossimReferenced &	operator= (const ossimReferenced &)

void	ref () const
	increment the reference count by one, indicating that this object has another pointer which is referencing it. More...

void	unref () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

void	unref_nodelete () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

int	referenceCount () const

Public Member Functions inherited from ossim::JsonInterface
	JsonInterface ()

virtual	~JsonInterface ()

Public Member Functions inherited from ossimProcessInterface
	ossimProcessInterface ()

virtual	~ossimProcessInterface ()

bool	needsAborting () const

bool	isAbortRequested () const

bool	isAborted () const

bool	isExecuting () const

ossimProcessStatus	getProcessStatus () const

virtual void	setProcessStatus (ossimProcessStatus processStatus)

virtual double	getPercentComplete () const

virtual void	setPercentComplete (double percentComplete)

void	enableEvents ()

void	disableEvents ()

void	setCurrentMessage (const ossimString &message)

virtual std::ostream &	print (std::ostream &out) const

Public Member Functions inherited from ossimListenerManager
	ossimListenerManager ()

virtual	~ossimListenerManager ()

virtual void	fireEvent (ossimEvent &event)

virtual bool	addListener (ossimListener *listener)

virtual bool	removeListener (ossimListener *listener)

virtual bool	findListener (ossimListener *listener)

Static Public Attributes
static const char *	DESCRIPTION

Private Member Functions
virtual void	initProcessingChain ()
	Derived classes initialize their custom chains here. More...

virtual void	finalizeChain ()
	Called after initProcessingChain() to append common items to the processing chain. More...

Additional Inherited Members
Public Types inherited from ossimProcessInterface
enum	ossimProcessStatus { PROCESS_STATUS_UNKNOWN = 0, PROCESS_STATUS_EXECUTING = 1, PROCESS_STATUS_ABORTED = 2, PROCESS_STATUS_ABORT_REQUEST = 3, PROCESS_STATUS_NOT_EXECUTING = 4 }

Protected Member Functions inherited from ossimChipProcTool
void	processRemainingArgs (ossimArgumentParser &ap)
	Intended to be called after derived class has picked off its own options from the parser, and arguments remain (such as input and output filenames). More...

virtual void	loadImageFiles ()
	Creates chains for image entries associated with specified keyword. More...

virtual void	loadDemFiles ()
	Loads all DEM files specified in master KWL into the elev manager's database. More...

ossimRefPtr< ossimSingleImageChain >	createInputChain (const ossimFilename &image_file, ossim_uint32 entry_index=0)
	Creates the ossimSingleImageChain from image filename and populates the chain with resampler and product output projection on view-side of resampler's IVT. More...

void	createOutputProjection ()
	Creates the output or view projection. More...

ossimRefPtr< ossimMapProjection >	newIdentityProjection ()
	Sets the single image chain for identity operations view to a ossimImageViewAffineTransform. More...

ossimRefPtr< ossimMapProjection >	newUtmProjection ()
	Convenience method to get a utm projection. More...

virtual void	initializeProjectionGsd ()
	Initializes the projection gsd. More...

virtual void	initializeAOI ()
	Initializes m_aoiViewRect with the output area of interest as specified in master KWL. More...

bool	getProjectionOrigin (ossimGpt &gpt)
	Reads the KWL for origin latitude and central meridian. More...

ossimRefPtr< ossimImageFileWriter >	newWriter ()
	Creates a new writer. More...

void	propagateGeometryToChains ()
	Loops through all chains and sets the output projection. More...

ossimRefPtr< ossimImageSource >	combineLayers (std::vector< ossimRefPtr< ossimSingleImageChain > > &layers) const
	When multiple input sources are present, this method instantiates a combiner and adds inputs. More...

void	computeAdjustedViewFromGrect ()
	Initializes m_aoiViewRect given m_aoiGroundRect. More...

void	setAoiToInputs ()
	Assigns the AOI to be the bounding rect of the union of all inputs. More...

void	getBandList (ossim_uint32 image_idx, std::vector< ossim_uint32 > &bandList) const
	Gets the band list if BANDS keyword is set. More...

void	setReaderProps (ossimImageHandler *ih) const
	Passes reader properties to single image handler if any. More...

	ossimChipProcTool (const ossimChipProcTool &obj)
	Hidden from use copy constructor. More...

const ossimChipProcTool &	operator= (const ossimChipProcTool &)
	Hidden from use assignment operator. More...

ossimRefPtr< ossimGeoPolygon >	createClipPolygon () const

void	findCenterGpt (ossimGpt &gpt)
	Tries to determine the AOI center point based on KWL entries, else returns NaNs in gpt. More...

ossimRefPtr< ossimImageSource >	mosaicDemSources ()
	Some utilities need to work on DEMs as images. More...

Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()

Protected Member Functions inherited from ossimListenerManager
	ossimListenerManager (const ossimListenerManager &rhs)

Protected Attributes inherited from ossimChipProcTool
ossimRefPtr< ossimImageGeometry >	m_geom

ossimIrect	m_aoiViewRect

ossimGrect	m_aoiGroundRect

std::vector< ossimRefPtr< ossimSingleImageChain > >	m_imgLayers

std::vector< ossimFilename >	m_demSources

ossimRefPtr< ossimImageFileWriter >	m_writer

ossimRefPtr< ossimImageChain >	m_procChain

ossimRefPtr< ossimRectangleCutFilter >	m_cutRectFilter

bool	m_projIsIdentity

ossimDpt	m_gsd

bool	m_geoScaled

ossimFilename	m_productFilename

ossimScalarType	m_productScalarType

bool	m_needCutRect

Protected Attributes inherited from ossimTool
ossimKeywordlist	m_kwl

std::ostream *	m_consoleStream

bool	m_helpRequested

std::string	m_response

Protected Attributes inherited from ossimProcessInterface
double	thePercentComplete

ossimProcessStatus	theProcessStatus

ossimString	theMessage

bool	theEventFlag

Protected Attributes inherited from ossimListenerManager
std::list< ossimListener * >	theListenerList

bool	theEnabledFlag

std::list< ossimListener * >	theDelayedAdd

std::list< ossimListener * >	theDelayedRemove

bool	theFireEventFlag

Detailed Description

Definition at line 15 of file ossimRegTool.h.

Constructor & Destructor Documentation

◆ ossimRegTool()

ossimRegTool::ossimRegTool ( )

Definition at line 19 of file ossimRegTool.cpp.

20 {

21 }

◆ ~ossimRegTool()

ossimRegTool::~ossimRegTool ( )

virtual

Definition at line 23 of file ossimRegTool.cpp.

24 {

25 }

Member Function Documentation

◆ execute()

bool ossimRegTool::execute ( )

virtual

Performs the actual product write.

Note: Throws ossimException on error.

Reimplemented from ossimChipProcTool.

Definition at line 77 of file ossimRegTool.cpp.

 {
    ostringstream xmsg;
 
    // Establish intersections
 
    // Find tiepoints
 
    // Register images
 
    // Report results
 
    return true;
 }

◆ finalizeChain()

virtual void ossimRegTool::finalizeChain ( )

privatevirtual

Called after initProcessingChain() to append common items to the processing chain.

Sets up the AOI box cutter filter and related stuff and initializes area of interest(aoi). The filter is appended to the current m_procChain. Derived class should override if not applicable to its processing chain.

Reimplemented from ossimChipProcTool.

◆ getClassName()

virtual ossimString ossimRegTool::getClassName ( ) const

inlinevirtual

Reimplemented from ossimTool.

Definition at line 32 of file ossimRegTool.h.

32 { return "ossimRegTool"; }

◆ getKwlTemplate()

void ossimRegTool::getKwlTemplate ( ossimKeywordlist & kwl )

virtual

Assigns a template keywordlist to string for initializing derived classes.

Reimplemented from ossimTool.

Definition at line 93 of file ossimRegTool.cpp.

References ossimKeywordlist::addPair().

 {
    ostringstream value;
    value<<"<float> (optional, defaults to <ADD DEFAULT>)";
    kwl.addPair("myoption", value.str());
 
 }

◆ initialize() [1/2]

bool ossimRegTool::initialize ( ossimArgumentParser & ap )

virtual

Initial method to be ran prior to execute.

Intended for command-line app usage.

Parameters

ap	Arg parser to initialize from.

Returns: FALSE if –help option requested or no params provided, so that derived classes can

Note: Throws ossimException on error.; A throw with an error message of "usage" is used to get out when a usage is printed.

Reimplemented from ossimChipProcTool.

Definition at line 42 of file ossimRegTool.cpp.

References ossimTool::initialize(), and ossimArgumentParser::read().

 {
    string ts1;
    ossimArgumentParser::ossimParameter sp1(ts1);
 
    if (!ossimTool::initialize(ap))
       return false;
 
    if ( ap.read("--myoption", sp1))
       m_kwl.addPair("myoption", ts1);
 
    processRemainingArgs(ap);
    return true;
 }

◆ initialize() [2/2]

void ossimRegTool::initialize ( const ossimKeywordlist & kwl )

virtual

This method is responsible for completely setting up the full processing chain according to the specifications given in the kwl passed in.

If the utility is run from a command line, the initialize(ossimArgumentParser) will assign the member master KWL and pass it to this method. Web service calls will fill a KWL and pass it.

This base class implementation should be called by the derived class implementation (assuming the derived class needs to pull some parameters out of the KWL before the chains are set up.

This method will instantiate the output projection and define the output bounding rect and product size in pixels. The processing chain (stored in m_procChain) will be completely initialized and ready for calls to getTile(). Then either getChip() or execute() can be called depending on usage to fetch product.

Note: Throws ossimException on error.

Reimplemented from ossimChipProcTool.

Definition at line 57 of file ossimRegTool.cpp.

References ossimString::empty(), ossimChipProcTool::initialize(), and ossimString::toDouble().

 {
    ossimString value;
    ostringstream xmsg;
 
    // Don't copy KWL if member KWL passed in:
    if (&kwl != &m_kwl)
    {
       // Start with clean options keyword list.
       m_kwl.clear();
       m_kwl.addList( kwl, true );
    }
 
    value = m_kwl.findKey("myoption");
    if (!value.empty())
       double myoption = value.toDouble();
 
    ossimChipProcTool::initialize(kwl);
 }

◆ initProcessingChain()

virtual void ossimRegTool::initProcessingChain ( )

privatevirtual

Derived classes initialize their custom chains here.

Implements ossimChipProcTool.

◆ setUsage()

void ossimRegTool::setUsage ( ossimArgumentParser & ap )

virtual

Initializes the aurgument parser with expected parameters and options.

It does not output anything. To see the usage, the caller will need to do something like:

ap.getApplicationUsage()->write(<ostream>);

This base class has some common arguments to add. The derived class should call this implementation in addition to setting its own arguments.

Reimplemented from ossimChipProcTool.

Definition at line 27 of file ossimRegTool.cpp.

References ossimApplicationUsage::addCommandLineOption(), ossimArgumentParser::getApplicationName(), ossimArgumentParser::getApplicationUsage(), ossimApplicationUsage::setCommandLineUsage(), and ossimTool::setUsage().

 {
    // Add global usage options. Don't include ossimChipProcUtil options as not appropriate.
    ossimTool::setUsage(ap);
 
    // Set the general usage:
    ossimApplicationUsage* au = ap.getApplicationUsage();
    ossimString usageString = ap.getApplicationName();
    usageString += " registration [options] <input-raster-file> <input-raster-file> [...]";
    au->setCommandLineUsage(usageString);
 
    // Set the command line options:
    au->addCommandLineOption("--myoption <float>", "Blah blah");
 }

Member Data Documentation

◆ DESCRIPTION

const char * ossimRegTool::DESCRIPTION

static

Initial value:

=

"Performs registration given list of images."

Definition at line 18 of file ossimRegTool.h.

Referenced by ossimRegToolFactory::getCapabilities().

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

Public Member Functions

Static Public Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ossimRegTool()

◆ ~ossimRegTool()

Member Function Documentation

◆ execute()

◆ finalizeChain()

◆ getClassName()

◆ getKwlTemplate()

◆ initialize() [1/2]

◆ initialize() [2/2]

◆ initProcessingChain()

◆ setUsage()

Member Data Documentation

◆ DESCRIPTION