Isis::CameraFactory Class Reference

Initializes a Camera Model. More...

#include <CameraFactory.h>

Collaboration diagram for Isis::CameraFactory:

Static Public Member Functions
static Camera *	Create (Cube &cube)
	Creates a Camera object using Pvl Specifications.
static int	CameraVersion (Cube &cube)
	This looks up the current camera model version from the cube.
static int	CameraVersion (Pvl &lab)
	Looks up the current camera model version in the pvl labels.
static void	initPlugin ()
	Reads the appropriate plugin file for the ISIS cameras, and scans the directories specified in IsisPreferences for CSM cameras.
static Camera *	CreateFromIsd (const QString &isdFile, Cube &cube)
	Create a CSMCamera from an external ISD file and attach it to a cube.
static void	updateLabelForCsm (Cube &cube, csm::Model *model)
	Update the cube label in memory to support CSM cameras.
static void	writeAdjustedCsmState (const QString &cubeFile, const QString &state, const QString &prefix="")
	Write adjusted CSM model state to a JSON file.
static csm::Model *	constructModelFromIsdOrState (const QString &filePath)
	Construct a CSM model from either an ISD or a model state file.
static csm::Model *	constructModelFromIsd (QString isdFilePath, QString pluginName="", QString modelName="", QString isdFormat="")
	Constructs CSM Model from ISD.
static QStringList	getModelSpecFromIsd (QString isdFilePath, QString pluginName="", QString modelName="")
	Generate CSM Model specs from ISD.

Detailed Description

Initializes a Camera Model.

This factory class is used to obtain a Camera Model object given a PVL which contains a valid Instrument group. The Instrument group can come from an image/cube or a hand-created PVL file. The camera is loaded based on information using the SpacecraftName and IntrumentID contained in the Instrument group. It is plugin oriented. That is, this class looks in $ISISROOT/lib/Camera.plugin to convert the SpacecraftName and IntrumentID string into a pointer to the appropriate camera class (e.g., Viking, HiRISE, etc.). This allows programmers who develop new camera models to create a plugin without the need for recompiling all the Isis applications that use camera models.

Author

2005-05-10 Elizabeth Ribelin

Member Function Documentation

CameraVersion() [1/2]

int Isis::CameraFactory::CameraVersion ( Cube & cube )

static

This looks up the current camera model version from the cube.

Parameters

cube	Input cube

Returns

int Latest Camera Version

References CameraVersion(), and Isis::Cube::label().

Referenced by CameraVersion(), Create(), and Isis::KernelDb::findAll().

CameraVersion() [2/2]

int Isis::CameraFactory::CameraVersion ( Pvl & lab )

static

Looks up the current camera model version in the pvl labels.

Parameters

lab	The pvl labels

Returns

The current camera model version

References initPlugin().

constructModelFromIsd()

csm::Model * Isis::CameraFactory::constructModelFromIsd ( QString isdFilePath, QString pluginName = "", QString modelName = "", QString isdFormat = "" )

static

Constructs CSM Model from ISD.

Parameters

isdFilePath	Path to ISD file
pluginName	Plugin name
modelName	Model name
isdFormat	ISD format type (e.g., NITF)

References getModelSpecFromIsd().

constructModelFromIsdOrState()

csm::Model * Isis::CameraFactory::constructModelFromIsdOrState ( const QString & filePath )

static

Construct a CSM model from either an ISD or a model state file.

Tries the ISD path first (canModelBeConstructedFromISD), then falls back to the state path (canModelBeConstructedFromState). Follows the same plugin iteration logic as csminit.

Parameters

filePath

Path to the ISD or model state file.

Returns

csm::Model* The constructed CSM model (caller owns).

References initPlugin().

Referenced by CreateFromIsd().

Create()

Camera * Isis::CameraFactory::Create ( Cube & cube )

static

Creates a Camera object using Pvl Specifications.

Parameters

cube	The original cube with the current version camera model

Returns

Camera* The Camera object created

Exceptions

Isis::iException::System	- Unsupported camera model, unable to find the plugin
Isis::iException::Camera	- Unable to initialize camera model

References CameraVersion(), Isis::Cube::hasBlob(), initPlugin(), and Isis::Cube::label().

Referenced by Isis::Cube::camera(), Isis::ControlNetFilter::CubeDistanceFilter(), Isis::ControlNetFilter::PointDistanceFilter(), Isis::ControlNetFilter::PointLatLonFilter(), Isis::ControlNet::SetImages(), Isis::LidarData::SetImages(), and Isis::UniversalGroundMap::UniversalGroundMap().

CreateFromIsd()

Camera * Isis::CameraFactory::CreateFromIsd ( const QString & isdFile, Cube & cube )

static

Create a CSMCamera from an external ISD file and attach it to a cube.

Parameters

isdFile	Path to the external ISD file.
cube	The cube to attach the camera to.

Returns

Camera* The CSMCamera object created.

References constructModelFromIsdOrState(), and updateLabelForCsm().

Referenced by Isis::CameraPointInfo::SetCube(), and Isis::ControlNet::SetImages().

getModelSpecFromIsd()

QStringList Isis::CameraFactory::getModelSpecFromIsd ( QString isdFilePath, QString pluginName = "", QString modelName = "" )

static

Generate CSM Model specs from ISD.

Parameters

isdFilePath	Path to ISD file
pluginName	Plugin name
modelName	Model name

Referenced by constructModelFromIsd().

initPlugin()

void Isis::CameraFactory::initPlugin ( )

static

Reads the appropriate plugin file for the ISIS cameras, and scans the directories specified in IsisPreferences for CSM cameras.

Referenced by CameraVersion(), constructModelFromIsdOrState(), and Create().

updateLabelForCsm()

void Isis::CameraFactory::updateLabelForCsm ( Cube & cube, csm::Model * model )

static

Update the cube label in memory to support CSM cameras.

Follows the same logic as csminit: sets ShapeModel=Null in the Kernels group and injects a CsmInfo group with platform/instrument identifiers derived from the CSM model. This allows serial number derivation and camera creation to work as if csminit had been run, but without modifying the cube on disk.

Parameters

cube	The cube whose label will be modified.
model	The CSM sensor model.

References Isis::Cube::label().

Referenced by CreateFromIsd().

writeAdjustedCsmState()

void Isis::CameraFactory::writeAdjustedCsmState ( const QString & cubeFile, const QString & state, const QString & prefix = "" )

static

Write adjusted CSM model state to a JSON file.

The output file is named <prefix><cube_basename>.adjusted_state.json, following the same convention as ASP bundle_adjust.

Parameters

cubeFile	Path to the input cube (basename used for output name).
state	The adjusted CSM model state string.
prefix	Optional file prefix (e.g., "run/run_").

---

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

• /home/runner/work/ISIS3/ISIS3/isis/src/base/objs/CameraFactory/CameraFactory.h
• /home/runner/work/ISIS3/ISIS3/isis/src/base/objs/CameraFactory/CameraFactory.cpp