IsisAml Class Reference
[Application Interface]

Application program XML file parameter manager. More...

#include <IsisAml.h>

Inherits IsisAmlData.

Inherited by Isis::UserInterface.

List of all members.

Public Member Functions
	IsisAml (const QString &xmlfile)
	Constructs an IsisAml object and internalizes the XML data in the given file name.
	~IsisAml ()
	Destructs an IsisAml object.
void	PutAsString (const QString &paramName, const QString &value)
	Allows the insertion of a value for any parameter.
void	PutAsString (const QString &paramName, const std::vector< QString > &value)
void	PutFileName (const QString &paramName, const QString &value)
	Allows the insertion of a value for a parameter of type "filename".
void	PutFileName (const QString &paramName, const std::vector< QString > &value)
void	PutDouble (const QString &paramName, const double &value)
	Allows the insertion of a value for a parameter of type "double".
void	PutDouble (const QString &paramName, const std::vector< double > &value)
void	PutInteger (const QString &paramName, const int &value)
	Allows the insertion of a value for a parameter of type "integer".
void	PutInteger (const QString &paramName, const std::vector< int > &value)
void	PutBoolean (const QString &paramName, const bool &value)
	Allows the insertion of a value for a parameter of type "boolean".
void	PutBoolean (const QString &paramName, const std::vector< bool > &value)
void	PutString (const QString &paramName, const QString &value)
	Allows the insertion of a value for any parameter.
void	PutString (const QString &paramName, const std::vector< QString > &value)
QString	GetAsString (const QString &paramName) const
	Allows the retrieval of a value for a parameter of any type.
void	GetAsString (const QString &paramName, std::vector< QString > &values) const
QString	GetFileName (const QString &paramName, QString extension="") const
	Allows the retrieval of a value for a parameter of type "filename".
void	GetFileName (const QString &paramName, std::vector< QString > &values) const
QString	GetString (const QString &paramName) const
	Allows the retrieval of a value for a parameter of type "string".
void	GetString (const QString &paramName, std::vector< QString > &values) const
int	GetInteger (const QString &paramName) const
	Allows the retrieval of a value for a parameter of type "integer".
void	GetInteger (const QString &paramName, std::vector< int > &values) const
bool	GetBoolean (const QString &paramName) const
	Allows the retrieval of a value for a parameter of type "boolean".
void	GetBoolean (const QString &paramName, std::vector< bool > &values) const
double	GetDouble (const QString &paramName) const
	Allows the retrieval of a value for a parameter of type "double".
void	GetDouble (const QString &paramName, std::vector< double > &values) const
bool	WasEntered (const QString &paramName) const
	Returns a true if the parameter has a value, and false if it does not.
void	Clear (const QString &paramName)
	Clears the value(s) in the named parameter.
Isis::CubeAttributeInput &	GetInputAttribute (const QString &paramName)
	Gets the attributes for an input cube.
Isis::CubeAttributeOutput &	GetOutputAttribute (const QString &paramName)
	Gets the attributes for an output cube.
QString	ProgramName () const
	Returns the Program name.
QString	Brief () const
	Returns the brief description of the program.
QString	Description () const
	Returns the full description of the program.
int	NumGroups () const
	Returns the number of groups found in the XML.
QString	GroupName (const int &group) const
	Returns the group name of group[index].
int	GroupIndex (const QString &grpName) const
	Given the group name get its index in group array.
int	NumParams (const int &) const
	Returns the number of parameters in a group.
QString	ParamName (const int &group, const int &param) const
	Returns the parameter name.
QString	ParamType (const int &group, const int &param) const
	Returns the parameter type of a parameter in a specified group.
QString	ParamBrief (const int &group, const int &param) const
	Returns the brief description of a parameter in a specified group.
QString	ParamDescription (const int &group, const int &param) const
	Returns the long description of a parameter in a specified group.
QString	ParamMinimum (const int &group, const int &param) const
	Returns the minimum value of a parameter in a specified group.
QString	ParamMinimumInclusive (const int &group, const int &param) const
	Returns whether the minimum value is inclusive or not.
QString	ParamMaximum (const int &group, const int &param) const
	Returns the maximum value of a parameter in a specified group.
QString	ParamMaximumInclusive (const int &group, const int &param) const
	Returns whether the maximum value is inclusive or not.
QString	ParamOdd (const int &group, const int &param) const
	Returns whether the selected parameter has a restriction on odd values or not.
int	ParamGreaterThanSize (const int &group, const int &param) const
	Returns the number of values in the parameters greater than list.
int	ParamGreaterThanOrEqualSize (const int &group, const int &param) const
	Returns the number of values in the parameters greater than or equal list.
int	ParamLessThanSize (const int &group, const int &param) const
	Returns the number of values in the parameters less than list.
int	ParamLessThanOrEqualSize (const int &group, const int &param) const
	Returns the number of values in the parameters less than or equal list.
int	ParamNotEqualSize (const int &group, const int &param) const
	Returns the number of values in the not equal list.
QString	ParamGreaterThan (const int &group, const int &param, const int &great) const
	Returns the name of the specified greaterThan parameter.
QString	ParamGreaterThanOrEqual (const int &group, const int &param, const int &great) const
	Returns the name of the specified greaterThanOrEqual parameter.
QString	ParamLessThan (const int &group, const int &param, const int &great) const
	Returns the name of the specified lessThan parameter.
QString	ParamLessThanOrEqual (const int &group, const int &param, const int &les) const
	Returns the name of the specified lessThanOrEqual parameter.
QString	ParamNotEqual (const int &group, const int &param, const int &notEq) const
	Returns the name of the specified notEqual parameter.
int	ParamListSize (const int &group, const int &param) const
	Returns the number of options in the specified parameter's list.
QString	ParamListValue (const int &group, const int &param, const int &option) const
	Returns the option value for a specific option to a parameter.
QString	ParamListBrief (const int &group, const int &param, const int &option) const
	Returns the brief description for a specific option to a parameter.
QString	ParamListDescription (const int &group, const int &param, const int &option) const
	Returns the full description for a specific option to a parameter.
int	ParamListExcludeSize (const int &group, const int &param, const int &option) const
	Returns the number of items in a parameters list exclude section.
QString	ParamListExclude (const int &group, const int &param, const int &option, const int &exclude) const
	Returns the parameter name to be excluded if this option is selected.
int	ParamListIncludeSize (const int &group, const int &param, const int &option) const
	Returns the number of items in a parameters list include section.
QString	ParamListInclude (const int &group, const int &param, const int &option, const int &include) const
	Returns the parameter name to be included if this option is selected.
QString	ParamDefault (const int &group, const int &param) const
	Returns the default for a parameter in a specified group.
QString	ParamInternalDefault (const int &group, const int &param) const
	Returns the internal default for a parameter in a specified group.
QString	ParamFilter (const int &group, const int &param) const
	Returns the parameter filter for a parameter in a specified group.
QString	ParamPath (const int &group, const int &param) const
	Returns the default path for a filename/cube parameter.
QString	ParamFileMode (const int &group, const int &param) const
	Returns the file mode for a parameter in a specified group.
int	ParamExcludeSize (const int &group, const int &param) const
	Returns the number of parameters excluded in this parameter's exclusions.
QString	ParamExclude (const int &group, const int &param, const int &exclude) const
	Returns the name of the specified excluded parameter.
int	ParamIncludeSize (const int &group, const int &param) const
	Returns the number of parameters included in this parameter's inclusions.
QString	ParamInclude (const int &group, const int &param, const int &include) const
	Returns the name of the specified included parameter.
QString	PixelType (const int &group, const int &param) const
	Returns the default pixel type from the XML.
int	HelpersSize (const int &group, const int &param) const
	Returns the number of helpers the parameter has.
QString	HelperButtonName (const int &group, const int &param, const int &helper) const
	Returns the name of the helper button.
QString	HelperFunction (const int &group, const int &param, const int &helper) const
	Returns the name of the helper function.
QString	HelperBrief (const int &group, const int &param, const int &helper) const
	Returns the brief description of the helper button.
QString	HelperDescription (const int &group, const int &param, const int &helper) const
	Returns the long description of the helper button.
QString	HelperIcon (const int &group, const int &param, const int &helper) const
	Returns the name of the icon for the helper button.
bool	IsParamInPvlInclude (QString &paramName, std::vector< QString > &exclude)
	Verify whether Parameter name is in the Include list Used in creation of DefFile.
void	CreatePVL (Isis::Pvl &pvlDef, QString guiGrpName, QString pvlObjName, QString pvlGrpName, std::vector< QString > &exclude)
	Create Pvl with the parameters in a user defined group given the Pvl object and group name.
void	VerifyAll ()
	Verify all parameters.
bool	StringToBool (QString value) const
	Returns a boolean value based on the QString contents.
void	CommandLine (Isis::Pvl &lab) const
	Creates a QString which could be used as a command line.
QString	Version () const
	Returns the application version date.
Protected Member Functions
const IsisParameterData *	ReturnParam (const QString &paramName) const
	Returns a pointer to a parameter whose name starts with paramName.
Protected Attributes
QString	name
QString	brief
QString	description
std::vector< IsisGroupData >	groups
std::vector< QString >	categorys
std::vector< IsisChangeData >	changes

---

Detailed Description

Application program XML file parameter manager.

This class is used to manage the data in an application XML file pertaining to the program parameters. The data is stored, accessed, and modified through this class and its helper classes.

Author:

2002-05-30 Stuart Sides

---

Constructor & Destructor Documentation

IsisAml::IsisAml

(

const QString &

xmlfile

)

Constructs an IsisAml object and internalizes the XML data in the given file name.

Parameters:

xmlfile

Indicates the pull path of the XML file to be parsed.

IsisAml::~IsisAml

(

)

Destructs an IsisAml object.

---

Member Function Documentation

QString IsisAml::Brief

(

)

const

Returns the brief description of the program.

Returns:

The brief description.

References IsisAmlData::brief.

Referenced by Isis::Application::History().

void IsisAml::Clear

(

const QString &

paramName

)

Clears the value(s) in the named parameter.

Parameters:

paramName

The name of the parameter to clear

References IsisParameterData::inCubeAtt, IsisParameterData::outCubeAtt, IsisParameterData::pixelType, ReturnParam(), Isis::CubeAttribute< ChildClass >::setAttributes(), and IsisParameterData::values.

Referenced by Isis::UserInterface::SetBatchList(), and Isis::ProcessExport::SetInputRange().

void IsisAml::CommandLine

(

Isis::Pvl &

cont

)

const

Creates a QString which could be used as a command line.

Parameters:

cont

Pvl to put command line information in

References Isis::PvlObject::AddGroup(), Isis::PvlKeyword::AddValue(), Isis::PvlObject::Clear(), IsisParameterData::defaultValues, Isis::PvlContainer::DeleteKeyword(), g, GetAsString(), IsisAmlData::groups, Isis::PvlContainer::HasKeyword(), IsisParameterData::listOptions, IsisParameterData::name, ParamName(), ReturnParam(), Isis::IString::Trim(), IsisParameterData::type, Isis::IString::UpCase(), and IsisParameterData::values.

Referenced by Isis::Application::History(), and Isis::UserInterface::SaveHistory().

void IsisAml::CreatePVL	(	Isis::Pvl &	pvlDef,
		QString	guiGrpName,
		QString	pvlObjName,
		QString	pvlGrpName,
		std::vector< QString > &	exclude
	)

Create Pvl with the parameters in a user defined group given the Pvl object and group name.

QString IsisAml::Description

(

)

const

Returns the full description of the program.

Returns:

The full description.

References IsisAmlData::description.

void IsisAml::GetAsString	(	const QString &	paramName,
		std::vector< QString > &	values
	)			const

QString IsisAml::GetAsString

(

const QString &

paramName

)

const

Allows the retrieval of a value for a parameter of any type.

The value will be returned as a QString no matter what the parameter type is.

Parameters:

paramName

The partial or full name of the parameter to be retrieved.

Returns:

A QString representation of the value for the specified parameter.

Exceptions:

iException

(IsisProgrammerError) The parameter has no value.

References _FILEINFO_, IsisParameterData::defaultValues, Isis::IException::Programmer, ReturnParam(), and IsisParameterData::values.

Referenced by Isis::PipelineApplication::AddParameter(), CommandLine(), Isis::Pipeline::SetInputFile(), Isis::Pipeline::SetOutputFile(), Isis::GuiParameter::SetToCurrent(), Isis::GuiParameter::Update(), and VerifyAll().

void IsisAml::GetBoolean	(	const QString &	paramName,
		std::vector< bool > &	values
	)			const

bool IsisAml::GetBoolean

(

const QString &

paramName

)

const

Allows the retrieval of a value for a parameter of type "boolean".

Parameters:

paramName

The partial or full name of the parameter to be retrieved.

Returns:

The value of the parameter.

Exceptions:

iException::Programmer

(IsisErrorUser) The parameter has no value.

References _FILEINFO_, IsisParameterData::defaultValues, Isis::IException::Programmer, ReturnParam(), Isis::toBool(), IsisParameterData::type, Isis::IException::User, and IsisParameterData::values.

void IsisAml::GetDouble	(	const QString &	paramName,
		std::vector< double > &	values
	)			const

double IsisAml::GetDouble

(

const QString &

paramName

)

const

Allows the retrieval of a value for a parameter of type "double".

Parameters:

paramName

The partial or full name of the parameter to be retrieved.

Returns:

The value of the parameter.

Exceptions:

iException::Programmer

(IsisErrorUser) The parameter has no value.

References _FILEINFO_, IsisParameterData::defaultValues, Isis::IException::Programmer, ReturnParam(), Isis::IString::ToDouble(), IsisParameterData::type, Isis::IException::User, and IsisParameterData::values.

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

void IsisAml::GetFileName	(	const QString &	paramName,
		std::vector< QString > &	values
	)			const

QString IsisAml::GetFileName	(	const QString &	paramName,
		QString	extension = ""
	)			const

Allows the retrieval of a value for a parameter of type "filename".

Parameters:

	paramName	The partial or full name of the parameter to be retrieved.
	extension	A default extension to add if it does not already exist on the file name. For example, "txt" will make /mydir/myfile into /mydir/myfile.txt

Returns:

The value of the parameter.

References _FILEINFO_, Isis::FileName::addExtension(), IsisParameterData::defaultValues, Isis::FileName::expanded(), IsisAmlData::name, Isis::IException::Programmer, ReturnParam(), IsisParameterData::type, Isis::IException::User, and IsisParameterData::values.

Referenced by Isis::Process::SetInputCube(), Isis::Pipeline::SetInputFile(), Isis::Pipeline::SetInputListFile(), Isis::ProcessPolygons::SetOutputCube(), Isis::ProcessMosaic::SetOutputCube(), Isis::ProcessGroundPolygons::SetOutputCube(), Isis::Process::SetOutputCube(), and Isis::Pipeline::SetOutputListFile().

Isis::CubeAttributeInput & IsisAml::GetInputAttribute

(

const QString &

paramName

)

Gets the attributes for an input cube.

Parameters:

paramName

The name of the parameter to get the attributes for

Returns:

CubeAttributeInput

Exceptions:

	iException::Programmer	"Parameter is not a cube."
	iException::Programmer	"Parameter in not an input cube"

References _FILEINFO_, IsisParameterData::defaultValues, IsisParameterData::fileMode, IsisParameterData::inCubeAtt, Isis::IException::Programmer, ReturnParam(), Isis::CubeAttribute< ChildClass >::setAttributes(), IsisParameterData::type, and IsisParameterData::values.

Referenced by Isis::Process::SetInputCube(), and Isis::Pipeline::SetInputFile().

void IsisAml::GetInteger	(	const QString &	paramName,
		std::vector< int > &	values
	)			const

int IsisAml::GetInteger

(

const QString &

paramName

)

const

Allows the retrieval of a value for a parameter of type "integer".

Parameters:

paramName

The partial or full name of the parameter to be retrieved.

Returns:

The value of the parameter.

Exceptions:

iException::Programmer

(IsisErrorUser) The parameter has no value.

References _FILEINFO_, IsisParameterData::defaultValues, Isis::IException::Programmer, ReturnParam(), Isis::IString::ToInteger(), IsisParameterData::type, Isis::IException::User, and IsisParameterData::values.

Referenced by VerifyAll().

Isis::CubeAttributeOutput & IsisAml::GetOutputAttribute

(

const QString &

paramName

)

Gets the attributes for an output cube.

Parameters:

paramName

The name of the parameter to get the attributes for

Returns:

CubeAttributeOutput

Exceptions:

	iException::Programmer	"Parameter is not a cube"
	iException::Programmer	"Parameter in not an output"

References _FILEINFO_, Isis::CubeAttribute< ChildClass >::addAttributes(), IsisParameterData::defaultValues, IsisParameterData::fileMode, IsisParameterData::outCubeAtt, IsisParameterData::pixelType, Isis::IException::Programmer, ReturnParam(), Isis::CubeAttribute< ChildClass >::setAttributes(), IsisParameterData::type, and IsisParameterData::values.

Referenced by Isis::ProcessPolygons::SetOutputCube(), Isis::ProcessImport::SetOutputCube(), Isis::ProcessGroundPolygons::SetOutputCube(), and Isis::Process::SetOutputCube().

void IsisAml::GetString	(	const QString &	paramName,
		std::vector< QString > &	values
	)			const

QString IsisAml::GetString

(

const QString &

paramName

)

const

Allows the retrieval of a value for a parameter of type "string".

Parameters:

paramName

The partial or full name of the parameter to be retrieved.

Returns:

The value of the parameter.

Exceptions:

iException::Programmer

(IsisErrorUser) The parameter has no value.

References _FILEINFO_, IsisParameterData::defaultValues, IsisParameterData::listOptions, Isis::IException::Programmer, ReturnParam(), IsisParameterData::type, Isis::IException::User, and IsisParameterData::values.

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

int IsisAml::GroupIndex

(

const QString &

grpName

)

const

Given the group name get its index in group array.

Given group name return its index in the Gui.

Author:

Sharmila Prasad (8/11/2011)

Parameters:

grpName

Returns:

int

References IsisAmlData::groups, and IsisAmlData::name.

QString IsisAml::GroupName

(

const int &

index

)

const

Returns the group name of group[index].

Parameters:

index

The array index of the group.

Returns:

The group name.

References IsisAmlData::groups.

QString IsisAml::HelperBrief	(	const int &	group,
		const int &	param,
		const int &	helper
	)			const

Returns the brief description of the helper button.

Parameters:

	group	The group index
	param	The parameter index
	helper	The helper index

Returns:

QString The brief description of the helper button

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::AddHelpers().

QString IsisAml::HelperButtonName	(	const int &	group,
		const int &	param,
		const int &	helper
	)			const

Returns the name of the helper button.

Parameters:

	group	The group index
	param	The parameter index
	helper	The helper index

Returns:

QString The name of the helper

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::AddHelpers().

QString IsisAml::HelperDescription	(	const int &	group,
		const int &	param,
		const int &	helper
	)			const

Returns the long description of the helper button.

Parameters:

	group	The group index
	param	The parameter index
	helper	The helper index

Returns:

QString The long description of the helper button

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::AddHelpers().

QString IsisAml::HelperFunction	(	const int &	group,
		const int &	param,
		const int &	helper
	)			const

Returns the name of the helper function.

Parameters:

	group	The group index
	param	The parameter index
	helper	The helper index

Returns:

QString The name of the helper function

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::AddHelpers().

QString IsisAml::HelperIcon	(	const int &	group,
		const int &	param,
		const int &	helper
	)			const

Returns the name of the icon for the helper button.

Parameters:

	group	The group index
	param	The parameter index
	helper	The helper index

Returns:

QString The name of the helper icon

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::AddHelpers().

int IsisAml::HelpersSize	(	const int &	group,
		const int &	param
	)			const

Returns the number of helpers the parameter has.

Parameters:

	group	The group index
	param	The parameter index

Returns:

int The number of helpers the parameter has

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::AddHelpers(), Isis::GuiBooleanParameter::GuiBooleanParameter(), Isis::GuiDoubleParameter::GuiDoubleParameter(), Isis::GuiFileNameParameter::GuiFileNameParameter(), Isis::GuiIntegerParameter::GuiIntegerParameter(), Isis::GuiListParameter::GuiListParameter(), and Isis::GuiStringParameter::GuiStringParameter().

bool IsisAml::IsParamInPvlInclude	(	QString &	paramName,
		std::vector< QString > &	exclude
	)

Verify whether Parameter name is in the Include list Used in creation of DefFile.

int IsisAml::NumGroups

(

)

const

Returns the number of groups found in the XML.

Returns:

The number of groups.

References IsisAmlData::groups.

Referenced by Isis::Gui::Gui(), and Isis::UserInterface::SetBatchList().

int IsisAml::NumParams

(

const int &

group

)

const

Returns the number of parameters in a group.

Parameters:

group

The group to measure.

Returns:

The number of parameters.

References IsisAmlData::groups.

Referenced by Isis::Gui::Gui(), and Isis::UserInterface::SetBatchList().

QString IsisAml::ParamBrief	(	const int &	group,
		const int &	param
	)			const

Returns the brief description of a parameter in a specified group.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The brief description.

References IsisAmlData::groups.

Referenced by Isis::GuiBooleanParameter::GuiBooleanParameter(), and Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamDefault	(	const int &	group,
		const int &	param
	)			const

Returns the default for a parameter in a specified group.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The default for the specified parameter.

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter(), Isis::GuiParameter::IsModified(), Isis::GuiBooleanParameter::IsModified(), Isis::GuiParameter::SetToDefault(), and Isis::GuiParameter::Update().

QString IsisAml::ParamDescription	(	const int &	group,
		const int &	param
	)			const

Returns the long description of a parameter in a specified group.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The long description

References IsisAmlData::groups.

QString IsisAml::ParamExclude	(	const int &	group,
		const int &	param,
		const int &	exclude
	)			const

Returns the name of the specified excluded parameter.

Parameters:

	group	The group index
	param	The parameter index
	exclude	The exclude index

Returns:

The name of the excluded parameter

References IsisAmlData::groups.

Referenced by Isis::GuiBooleanParameter::Exclusions(), and Isis::GuiParameter::GuiParameter().

int IsisAml::ParamExcludeSize	(	const int &	group,
		const int &	param
	)			const

Returns the number of parameters excluded in this parameter's exclusions.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The number of items in the parameters exclude list

References IsisAmlData::groups.

Referenced by Isis::GuiBooleanParameter::Exclusions(), and Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamFileMode	(	const int &	group,
		const int &	param
	)			const

Returns the file mode for a parameter in a specified group.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The file mode for the parameter.

References IsisAmlData::groups.

Referenced by Isis::GuiFileNameParameter::SelectFile().

QString IsisAml::ParamFilter	(	const int &	group,
		const int &	param
	)			const

Returns the parameter filter for a parameter in a specified group.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The paramter filter.

References filter(), and IsisAmlData::groups.

Referenced by Isis::GuiFileNameParameter::SelectFile().

QString IsisAml::ParamGreaterThan	(	const int &	group,
		const int &	param,
		const int &	great
	)			const

Returns the name of the specified greaterThan parameter.

Parameters:

	group	The group index
	param	The parameter index
	great	The greaterThan index

Returns:

The name of the greaterThan parameter

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamGreaterThanOrEqual	(	const int &	group,
		const int &	param,
		const int &	great
	)			const

Returns the name of the specified greaterThanOrEqual parameter.

Parameters:

	group	The group index
	param	The parameter index
	great	The greaterThanOrEqual index

Returns:

The name of the greaterThanOrEqual parameter

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

int IsisAml::ParamGreaterThanOrEqualSize	(	const int &	group,
		const int &	param
	)			const

Returns the number of values in the parameters greater than or equal list.

Parameters:

	group	The group index
	param	The parameter index

Returns:

Number of values in the parameters greater than or equal list

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

int IsisAml::ParamGreaterThanSize	(	const int &	group,
		const int &	param
	)			const

Returns the number of values in the parameters greater than list.

Parameters:

	group	The group index
	param	The parameter index

Returns:

Number of values in the parameters greater than list

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamInclude	(	const int &	group,
		const int &	param,
		const int &	include
	)			const

Returns the name of the specified included parameter.

Parameters:

	group	The group index
	param	The parameter index
	include	The include index

Returns:

The name of the included parameter

References IsisAmlData::groups.

Referenced by Isis::GuiBooleanParameter::Exclusions(), and Isis::GuiParameter::GuiParameter().

int IsisAml::ParamIncludeSize	(	const int &	group,
		const int &	param
	)			const

Returns the number of parameters included in this parameter's inclusions.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The number of items in the parameters include list

References IsisAmlData::groups.

Referenced by Isis::GuiBooleanParameter::Exclusions(), and Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamInternalDefault	(	const int &	group,
		const int &	param
	)			const

Returns the internal default for a parameter in a specified group.

.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The internal default for the specified parameter.

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter(), Isis::GuiParameter::IsModified(), Isis::GuiFileNameParameter::SelectFile(), Isis::GuiParameter::SetToDefault(), and Isis::GuiParameter::Update().

QString IsisAml::ParamLessThan	(	const int &	group,
		const int &	param,
		const int &	les
	)			const

Returns the name of the specified lessThan parameter.

Parameters:

	group	The group index
	param	The parameter index
	les	The lessThan index

Returns:

The name of the lessThan parameter

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamLessThanOrEqual	(	const int &	group,
		const int &	param,
		const int &	les
	)			const

Returns the name of the specified lessThanOrEqual parameter.

Parameters:

	group	The group index
	param	The parameter index
	les	The lessThanOrEqual index

Returns:

The name of the lessThanOrEqual parameter

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

int IsisAml::ParamLessThanOrEqualSize	(	const int &	group,
		const int &	param
	)			const

Returns the number of values in the parameters less than or equal list.

Parameters:

	group	The group index
	param	The parameter index

Returns:

Number of values in the parameters less than or equal list

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

int IsisAml::ParamLessThanSize	(	const int &	group,
		const int &	param
	)			const

Returns the number of values in the parameters less than list.

Parameters:

	group	The group index
	param	The parameter index

Returns:

Number of values in the parameters less than list

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamListBrief	(	const int &	group,
		const int &	param,
		const int &	option
	)			const

Returns the brief description for a specific option to a parameter.

Parameters:

	group	The group index
	param	The parameter index
	option	The option number within the parameters list.

Returns:

The brief description of the option.

References IsisAmlData::groups.

Referenced by Isis::GuiComboBoxParameter::GuiComboBoxParameter(), and Isis::GuiListParameter::GuiListParameter().

QString IsisAml::ParamListDescription	(	const int &	group,
		const int &	param,
		const int &	option
	)			const

Returns the full description for a specific option to a parameter.

Parameters:

	group	The group index
	param	The parameter index
	option	The option number within the parameters list.

Returns:

The full description of the option.

References IsisAmlData::groups.

QString IsisAml::ParamListExclude	(	const int &	group,
		const int &	param,
		const int &	option,
		const int &	exclude
	)			const

Returns the parameter name to be excluded if this option is selected.

Parameters:

	group	The group index
	param	The parameter index
	option	The option number within the parameters list.
	exclude	The exclusion number within the parameters list.

Returns:

The parameter name to be excluded if this option is selected.

References IsisAmlData::groups.

Referenced by Isis::GuiListParameter::Exclusions(), and Isis::GuiComboBoxParameter::Exclusions().

int IsisAml::ParamListExcludeSize	(	const int &	group,
		const int &	param,
		const int &	option
	)			const

Returns the number of items in a parameters list exclude section.

Parameters:

	group	The group index
	param	The parameter index
	option	The option number within the parameters list.

Returns:

The number of items in the parameters list exclude section.

References IsisAmlData::groups.

Referenced by Isis::GuiListParameter::Exclusions(), and Isis::GuiComboBoxParameter::Exclusions().

QString IsisAml::ParamListInclude	(	const int &	group,
		const int &	param,
		const int &	option,
		const int &	include
	)			const

Returns the parameter name to be included if this option is selected.

Parameters:

	group	The group index
	param	The parameter index
	option	The option number within the parameters list.
	include	The inclusion number within the parameters list.

Returns:

The parameter name to be included if this option is selected.

References IsisAmlData::groups.

int IsisAml::ParamListIncludeSize	(	const int &	group,
		const int &	param,
		const int &	option
	)			const

Returns the number of items in a parameters list include section.

Parameters:

	group	The group index
	param	The parameter index
	option	The option number within the parameters list.

Returns:

The number of items in the parameters list include section.

References IsisAmlData::groups.

int IsisAml::ParamListSize	(	const int &	group,
		const int &	param
	)			const

Returns the number of options in the specified parameter's list.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The number of options contained in the parameter's list. If the parameter does not contain a list, zero will be returned.

References IsisAmlData::groups.

Referenced by Isis::GuiParameterFactory::Create(), Isis::GuiComboBoxParameter::GuiComboBoxParameter(), Isis::GuiListParameter::GuiListParameter(), Isis::GuiListParameter::Set(), and Isis::GuiComboBoxParameter::Set().

QString IsisAml::ParamListValue	(	const int &	group,
		const int &	param,
		const int &	option
	)			const

Returns the option value for a specific option to a parameter.

Parameters:

	group	The group index
	param	The parameter index
	option	The option number within the parameters list.

Returns:

The value of the option.

References IsisAmlData::groups.

Referenced by Isis::GuiComboBoxParameter::GuiComboBoxParameter(), Isis::GuiListParameter::GuiListParameter(), Isis::GuiListParameter::Set(), Isis::GuiComboBoxParameter::Set(), Isis::GuiListParameter::Value(), and Isis::GuiComboBoxParameter::Value().

QString IsisAml::ParamMaximum	(	const int &	group,
		const int &	param
	)			const

Returns the maximum value of a parameter in a specified group.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The maximum

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamMaximumInclusive	(	const int &	group,
		const int &	param
	)			const

Returns whether the maximum value is inclusive or not.

Parameters:

	group	The group index
	param	The parameter index

Returns:

Whether maximum is inclusive or not

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamMinimum	(	const int &	group,
		const int &	param
	)			const

Returns the minimum value of a parameter in a specified group.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The minimum

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamMinimumInclusive	(	const int &	group,
		const int &	param
	)			const

Returns whether the minimum value is inclusive or not.

Parameters:

	group	The group index
	param	The parameter index

Returns:

Whether minimum is inclusive or not

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamName	(	const int &	group,
		const int &	param
	)			const

Returns the parameter name.

Parameters:

	group	The group index where the parameter can be found.
	param	The index of the parameter to name.

Returns:

The name of the parameter.

References IsisAmlData::groups.

Referenced by CommandLine(), Isis::GuiParameter::GuiParameter(), and Isis::UserInterface::SetBatchList().

QString IsisAml::ParamNotEqual	(	const int &	group,
		const int &	param,
		const int &	notEq
	)			const

Returns the name of the specified notEqual parameter.

Parameters:

	group	The group index
	param	The parameter index
	notEq	The notEqual index

Returns:

The name of the notEqual parameter

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

int IsisAml::ParamNotEqualSize	(	const int &	group,
		const int &	param
	)			const

Returns the number of values in the not equal list.

Parameters:

	group	The group index
	param	The parameter index

Returns:

Number of values in the parameters not equal list

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamOdd	(	const int &	group,
		const int &	param
	)			const

Returns whether the selected parameter has a restriction on odd values or not.

Parameters:

	group	The group index
	param	The parameter index

Returns:

Whether the parameter restricts odd values or not

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ParamPath	(	const int &	group,
		const int &	param
	)			const

Returns the default path for a filename/cube parameter.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The default path.

References IsisAmlData::groups.

Referenced by Isis::GuiFileNameParameter::SelectFile().

QString IsisAml::ParamType	(	const int &	group,
		const int &	param
	)			const

Returns the parameter type of a parameter in a specified group.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The type of parameter.

References IsisAmlData::groups.

Referenced by Isis::GuiParameterFactory::Create(), and Isis::GuiParameter::GuiParameter().

QString IsisAml::PixelType	(	const int &	group,
		const int &	param
	)			const

Returns the default pixel type from the XML.

Parameters:

	group	The group index
	param	The parameter index

Returns:

The default pixel type

References IsisAmlData::groups.

Referenced by Isis::GuiParameter::GuiParameter().

QString IsisAml::ProgramName

(

)

const

Returns the Program name.

Returns:

The name of the program.

References IsisAmlData::name.

Referenced by Isis::Application::History(), Isis::UserInterface::SaveHistory(), and Isis::Gui::ShowWarning().

void IsisAml::PutAsString	(	const QString &	paramName,
		const std::vector< QString > &	value
	)

void IsisAml::PutAsString	(	const QString &	paramName,
		const QString &	value
	)

Allows the insertion of a value for any parameter.

No validity check is performed on the value passed in.

Parameters:

	paramName	The partial or full name of the parameter to be modified.
	value	The QString representation of the value to be placed in the parameters value data member. For parameters of type integer, the QString must be convertable to an integer. For parameters of type double, the QString must be convertable to a double. For parameters of type boolean, the QString must be one of: (TRUE, FALSE, YES, NO, or a partial match of any of these beginning with the first character).

Exceptions:

IException

The parameter already has a value in its "value" data member.Overwriting an existing value is not allowed. Use "Clear" to erase all values in the value data member instead of overwriting an existing value.

References _FILEINFO_, ReturnParam(), Isis::IException::User, and IsisParameterData::values.

Referenced by Isis::UserInterface::SetBatchList().

void IsisAml::PutBoolean	(	const QString &	paramName,
		const std::vector< bool > &	value
	)

void IsisAml::PutBoolean	(	const QString &	paramName,
		const bool &	value
	)

Allows the insertion of a value for a parameter of type "boolean".

A validity check is performed on the value passed in.

Parameters:

	paramName	The partial or full name of the parameter to be modified.
	value	The boolean value to be placed in the boolean's value data member.

Exceptions:

	iException	(IsisProgrammerError) The parameter already has a value in its "value" data member.Overwriting an existing value is not allowed. Use "Clear" to erase all values in the value data member instead of overwriting an existing value.
	iException	(IsisProgrammerError) The parameter is not of type "boolean".

References _FILEINFO_, Isis::IException::Programmer, ReturnParam(), IsisParameterData::type, and IsisParameterData::values.

void IsisAml::PutDouble	(	const QString &	paramName,
		const std::vector< double > &	value
	)

void IsisAml::PutDouble	(	const QString &	paramName,
		const double &	value
	)

Allows the insertion of a value for a parameter of type "double".

A validity check is performed on the value passed in.

Parameters:

	paramName	The partial or full name of the parameter to be modified.
	value	The double value to be placed in the double's value data member.

Exceptions:

	iException	(IsisProgrammerError) The parameter already has a value in its "value" data member.Overwriting an existing value is not allowed. Use "Clear" to erase all values in the value data member instead of overwriting an existing value.
	iException	(IsisProgrammerError) The parameter is not of type "double".

References _FILEINFO_, Isis::IException::Programmer, ReturnParam(), Isis::toString(), IsisParameterData::type, and IsisParameterData::values.

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

void IsisAml::PutFileName	(	const QString &	paramName,
		const std::vector< QString > &	value
	)

void IsisAml::PutFileName	(	const QString &	paramName,
		const QString &	value
	)

Allows the insertion of a value for a parameter of type "filename".

A validity check is performed on the value passed in.

Parameters:

	paramName	The partial or full name of the parameter to be modified.
	value	The QString representation of the value to be placed in the filename's value data member.

References _FILEINFO_, Isis::IException::Programmer, ReturnParam(), IsisParameterData::type, and IsisParameterData::values.

void IsisAml::PutInteger	(	const QString &	paramName,
		const std::vector< int > &	value
	)

void IsisAml::PutInteger	(	const QString &	paramName,
		const int &	value
	)

Allows the insertion of a value for a parameter of type "integer".

A validity check is performed on the value passed in.

Parameters:

	paramName	The partial or full name of the parameter to be modified.
	value	The integer value to be placed in the integer's value data member.

Exceptions:

iException

(IsisProgrammerError) The parameter is not of type "int".

References _FILEINFO_, Isis::IException::Programmer, ReturnParam(), Isis::toString(), IsisParameterData::type, and IsisParameterData::values.

void IsisAml::PutString	(	const QString &	paramName,
		const std::vector< QString > &	value
	)

void IsisAml::PutString	(	const QString &	paramName,
		const QString &	value
	)

Allows the insertion of a value for any parameter.

No validity check is performed on the value passed in.

Parameters:

	paramName	The partial or full name of the parameter to be modified.
	value	The QString representation of the value to be placed in the parameters value data member. For parameters of type integer, the QString must be convertable to an integer. For parameters of type double, the QString must be convertable to a double. For parameters of type boolean, the QString must be one of: (TRUE, FALSE, YES, NO, or a partial match of any of these beginning with the first character).

References _FILEINFO_, Isis::IException::Programmer, ReturnParam(), IsisParameterData::type, and IsisParameterData::values.

const IsisParameterData * IsisAml::ReturnParam

(

const QString &

paramName

)

const [protected]

Returns a pointer to a parameter whose name starts with paramName.

Parameters:

paramName

The name of the parameter to return

Returns:

IsisParameterData

Exceptions:

	iException::User	(Parameter is not unique)
	iException::User	(Unknown Parameter)

References _FILEINFO_, g, IsisAmlData::groups, Isis::IString::UpCase(), and Isis::IException::User.

Referenced by Clear(), CommandLine(), GetAsString(), GetBoolean(), GetDouble(), GetFileName(), GetInputAttribute(), GetInteger(), GetOutputAttribute(), GetString(), PutAsString(), PutBoolean(), PutDouble(), PutFileName(), PutInteger(), PutString(), VerifyAll(), and WasEntered().

bool IsisAml::StringToBool

(

QString

value

)

const

Returns a boolean value based on the QString contents.

Parameters:

value

The value to convert to a boolean

Returns:

boolean value based on QString contents

Exceptions:

iException::Programmer

(Invalid boolean value)

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

Referenced by Isis::GuiBooleanParameter::Set(), and VerifyAll().

void IsisAml::VerifyAll

(

)

Verify all parameters.

References _FILEINFO_, IsisParameterData::defaultValues, IsisParameterData::exclude, g, GetAsString(), GetDouble(), GetInteger(), GetString(), IsisParameterData::greaterThan, IsisParameterData::greaterThanOrEqual, IsisAmlData::groups, IsisParameterData::include, IsisParameterData::internalDefault, IsisParameterData::lessThan, IsisParameterData::lessThanOrEqual, IsisParameterData::listOptions, IsisParameterData::name, IsisParameterData::notEqual, Isis::IException::Programmer, ReturnParam(), StringToBool(), IsisParameterData::type, Isis::IException::User, and IsisParameterData::values.

Referenced by Isis::Application::Run(), and Isis::UserInterface::SetBatchList().

QString IsisAml::Version

(

)

const

Returns the application version date.

Returns:

The application version date

References IsisAmlData::changes, and st.

Referenced by Isis::Application::History().

bool IsisAml::WasEntered

(

const QString &

paramName

)

const

Returns a true if the parameter has a value, and false if it does not.

Parameters:

paramName

The name of the parameter to check if it was entered

Returns:

True if the parameter was entered, and false if it was not

References ReturnParam(), and IsisParameterData::values.

Referenced by Isis::PipelineApplication::AddParameter(), Isis::Pipeline::SetInputFile(), Isis::Pipeline::SetOutputFile(), Isis::Pipeline::SetOutputListFile(), Isis::GuiParameter::SetToCurrent(), and Isis::GuiParameter::Update().

---

Member Data Documentation

QString IsisAmlData::brief [inherited]

Referenced by Brief(), and IsisXMLApplication::startElement().

std::vector<QString> IsisAmlData::categorys [inherited]

Referenced by IsisXMLApplication::startElement().

std::vector<IsisChangeData> IsisAmlData::changes [inherited]

Referenced by IsisXMLApplication::startElement(), and Version().

QString IsisAmlData::description [inherited]

Referenced by Description(), and IsisXMLApplication::startElement().

std::vector<IsisGroupData> IsisAmlData::groups [inherited]

Referenced by CommandLine(), GroupIndex(), GroupName(), HelperBrief(), HelperButtonName(), HelperDescription(), HelperFunction(), HelperIcon(), HelpersSize(), NumGroups(), NumParams(), ParamBrief(), ParamDefault(), ParamDescription(), ParamExclude(), ParamExcludeSize(), ParamFileMode(), ParamFilter(), ParamGreaterThan(), ParamGreaterThanOrEqual(), ParamGreaterThanOrEqualSize(), ParamGreaterThanSize(), ParamInclude(), ParamIncludeSize(), ParamInternalDefault(), ParamLessThan(), ParamLessThanOrEqual(), ParamLessThanOrEqualSize(), ParamLessThanSize(), ParamListBrief(), ParamListDescription(), ParamListExclude(), ParamListExcludeSize(), ParamListInclude(), ParamListIncludeSize(), ParamListSize(), ParamListValue(), ParamMaximum(), ParamMaximumInclusive(), ParamMinimum(), ParamMinimumInclusive(), ParamName(), ParamNotEqual(), ParamNotEqualSize(), ParamOdd(), ParamPath(), ParamType(), PixelType(), ReturnParam(), IsisXMLApplication::startElement(), and VerifyAll().

QString IsisAmlData::name [inherited]

Referenced by GetFileName(), GroupIndex(), ProgramName(), and IsisXMLApplication::startElement().

---

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

• src/base/objs/IsisAml/IsisAml.h
• src/base/objs/IsisAml/IsisAml.cpp