Isis Developer Reference
Isis::UserInterface Class Reference

Command Line and Xml loader, validation, and access. More...

#include <UserInterface.h>

Inheritance diagram for Isis::UserInterface:
Inheritance graph
Collaboration diagram for Isis::UserInterface:
Collaboration graph

Public Member Functions

 UserInterface (const QString &xmlfile, int &argc, char *argv[])
 Constructs an UserInterface object.
 
 UserInterface (const QString &xmlfile, QVector< QString > &args)
 Constructs an UserInterface object.
 
 ~UserInterface ()
 Destroys the UserInterface object.
 
bool AbortOnError ()
 Returns true if the program should abort on error, and false if it should continue.
 
int BatchListSize ()
 Returns the size of the batchlist.
 
bool IsInteractive ()
 Indicates if the Isis Graphical User Interface is operating.
 
int ParentId ()
 Returns the parent id.
 
GuiTheGui ()
 
QString GetParamPreference ()
 Get the the preference path passed in by the user.
 
QString GetInfoFileName ()
 This method returns the filename where the debugging info is stored when the "-info" tag is used.
 
bool GetInfoFlag ()
 This method returns the flag state of info.
 
QString BuildNewCommandLineFromPvl (Pvl temp)
 
void SetBatchList (int i)
 Clears the gui parameters and sets the batch list information at line i as the new parameters.
 
void SetErrorList (int i)
 This method adds the line specified in the BatchList that the error occured on.
 
void SaveHistory ()
 Saves the user parameter information in the history of the program for later use.
 
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 PutCubeName (const QString &paramName, const QString &value)
 Allows the insertion of a value for a parameter of type "cubename".
 
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 GetCubeName (const QString &paramName, QString extension="") const
 Retrieves of a value for a parameter of type "cubename".
 
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::CubeAttributeInputGetInputAttribute (const QString &paramName)
 Gets the attributes for an input cube.
 
Isis::CubeAttributeOutputGetOutputAttribute (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.
 
nlohmann::json GetParams ()
 Creates a json object which could be used as a command line.
 
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 IsisParameterDataReturnParam (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< IsisGroupDatagroups
 
std::vector< QString > categorys
 
std::vector< IsisChangeDatachanges
 

Detailed Description

Command Line and Xml loader, validation, and access.

This object is used to load and query user input via the command line. It requires as input to the constructor 1) an Isis Application Xml file and 2) the command line arguments (argc and argv). The Xml file will be used to validate the user input given on the command line (if any). To access user input see the Aml class which is inherited.

Author
2002-05-29 Jeff Anderson

Constructor & Destructor Documentation

◆ UserInterface() [1/2]

Isis::UserInterface::UserInterface ( const QString & xmlfile,
int & argc,
char * argv[] )

Constructs an UserInterface object.

Parameters
xmlfileName of the Isis application xml file to open.
argcNumber of arguments on the command line. Must be pass by reference!!
argv[]Array of arguments

References Isis::Gui::checkX11(), Isis::Gui::Create(), and Isis::FileName::dir().

◆ UserInterface() [2/2]

Isis::UserInterface::UserInterface ( const QString & xmlfile,
QVector< QString > & args )

Constructs an UserInterface object.

Parameters
xmlfileName of the Isis application xml file to open.
argcNumber of arguments on the command line. Must be pass by reference!!
argv[]Array of arguments

References Isis::FileName::dir().

◆ ~UserInterface()

Isis::UserInterface::~UserInterface ( )

Destroys the UserInterface object.

Member Function Documentation

◆ AbortOnError()

bool Isis::UserInterface::AbortOnError ( )
inline

Returns true if the program should abort on error, and false if it should continue.

Returns
bool True for abort, False for continue

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

◆ BatchListSize()

int Isis::UserInterface::BatchListSize ( )
inline

Returns the size of the batchlist.

If there is no batchlist, it will return 0

Returns
int The size of the batchlist

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

◆ Brief()

QString IsisAml::Brief ( ) const
inherited

Returns the brief description of the program.

Returns
The brief description.

References IsisAmlData::brief.

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

◆ BuildNewCommandLineFromPvl()

QString Isis::UserInterface::BuildNewCommandLineFromPvl ( Pvl temp)

◆ Clear()

void IsisAml::Clear ( const QString & paramName)
inherited

Clears the value(s) in the named parameter.

Parameters
paramNameThe name of the parameter to clear

References IsisAml::ReturnParam(), and IsisParameterData::values.

Referenced by SetBatchList().

◆ CommandLine()

void IsisAml::CommandLine ( Isis::Pvl & cont) const
inherited

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

Parameters
contPvl to put command line information in

References Isis::PvlContainer::deleteKeyword(), IsisAml::GetAsString(), IsisAmlData::groups, Isis::PvlContainer::hasKeyword(), IsisAml::ParamName(), IsisAml::ReturnParam(), Isis::IString::Trim(), and Isis::IString::UpCase().

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

◆ CreatePVL()

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

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

Create a PVL file from the parameters in a Group given the Gui group name, Pvl Object and Group names and the list of parameters to be included in the Pvl.

Author
Sharmila Prasad (8/11/2011)
Parameters
pvlDef- output PVL
guiGrpName- Gui Group name
pvlObjName- output PVL Object name
pvlGrpName- output PVL Group name
include- vector of parameter names to be part of the output PVL

References _FILEINFO_, Isis::IString::DownCase(), IsisAml::GetAsString(), IsisAml::GetBoolean(), IsisAml::GetDouble(), IsisAml::GetInteger(), IsisAml::GroupIndex(), IsisAml::IsParamInPvlInclude(), IsisAml::NumParams(), IsisAml::ParamName(), IsisAml::ParamType(), Isis::toString(), and Isis::IException::User.

◆ Description()

QString IsisAml::Description ( ) const
inherited

Returns the full description of the program.

Returns
The full description.

References IsisAmlData::description.

◆ GetAsString() [1/2]

QString IsisAml::GetAsString ( const QString & paramName) const
inherited

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
paramNameThe 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_, Isis::IException::Programmer, and IsisAml::ReturnParam().

Referenced by IsisAml::CommandLine(), IsisAml::CreatePVL(), Isis::GuiParameter::SetToCurrent(), Isis::GuiParameter::Update(), and IsisAml::VerifyAll().

◆ GetAsString() [2/2]

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

◆ GetBoolean() [1/2]

bool IsisAml::GetBoolean ( const QString & paramName) const
inherited

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

Parameters
paramNameThe 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_, Isis::IException::Programmer, IsisAml::ReturnParam(), Isis::toBool(), and Isis::IException::User.

Referenced by IsisAml::CreatePVL().

◆ GetBoolean() [2/2]

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

◆ GetCubeName()

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

Retrieves of a value for a parameter of type "cubename".

Parameters
paramNameThe partial or full name of the parameter to be retrieved.
extensionA 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_, IsisAmlData::name, Isis::IException::Programmer, IsisAml::ReturnParam(), and Isis::IException::User.

◆ GetDouble() [1/2]

double IsisAml::GetDouble ( const QString & paramName) const
inherited

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

Parameters
paramNameThe 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_, Isis::IException::Programmer, IsisAml::ReturnParam(), Isis::IString::ToDouble(), and Isis::IException::User.

Referenced by IsisAml::CreatePVL(), and IsisAml::VerifyAll().

◆ GetDouble() [2/2]

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

◆ GetFileName() [1/2]

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

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

Parameters
paramNameThe partial or full name of the parameter to be retrieved.
extensionA 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_, IsisAmlData::name, Isis::IException::Programmer, IsisAml::ReturnParam(), and Isis::IException::User.

◆ GetFileName() [2/2]

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

◆ GetInfoFileName()

QString Isis::UserInterface::GetInfoFileName ( )

This method returns the filename where the debugging info is stored when the "-info" tag is used.

Returns
QString Name of file containing debugging ingo.

◆ GetInfoFlag()

bool Isis::UserInterface::GetInfoFlag ( )

This method returns the flag state of info.

This returns if its in debugging mode(the -info tag was specified).

Returns
bool Flag state on info.

◆ GetInputAttribute()

Isis::CubeAttributeInput & IsisAml::GetInputAttribute ( const QString & paramName)
inherited

Gets the attributes for an input cube.

Parameters
paramNameThe 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_, Isis::IException::Programmer, IsisAml::ReturnParam(), and IsisParameterData::type.

◆ GetInteger() [1/2]

int IsisAml::GetInteger ( const QString & paramName) const
inherited

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

Parameters
paramNameThe 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_, Isis::IException::Programmer, IsisAml::ReturnParam(), Isis::IString::ToInteger(), and Isis::IException::User.

Referenced by IsisAml::CreatePVL(), and IsisAml::VerifyAll().

◆ GetInteger() [2/2]

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

◆ GetOutputAttribute()

Isis::CubeAttributeOutput & IsisAml::GetOutputAttribute ( const QString & paramName)
inherited

Gets the attributes for an output cube.

Parameters
paramNameThe 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::IException::Programmer, IsisAml::ReturnParam(), and IsisParameterData::type.

◆ GetParamPreference()

QString Isis::UserInterface::GetParamPreference ( )
inline

Get the the preference path passed in by the user.

Otherwise an empty string

Returns
QString

◆ GetParams()

json IsisAml::GetParams ( )
inherited

Creates a json object which could be used as a command line.

References IsisAmlData::groups, IsisAml::ParamName(), and IsisAml::ReturnParam().

◆ GetString() [1/2]

QString IsisAml::GetString ( const QString & paramName) const
inherited

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

Parameters
paramNameThe 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_, Isis::IException::Programmer, IsisAml::ReturnParam(), and Isis::IException::User.

Referenced by IsisAml::VerifyAll().

◆ GetString() [2/2]

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

◆ GroupIndex()

int IsisAml::GroupIndex ( const QString & grpName) const
inherited

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 Isis::IString::DownCase(), IsisAmlData::groups, and IsisAmlData::name.

Referenced by IsisAml::CreatePVL().

◆ GroupName()

QString IsisAml::GroupName ( const int & index) const
inherited

Returns the group name of group[index].

Parameters
indexThe array index of the group.
Returns
The group name.

References IsisAmlData::groups.

◆ HelperBrief()

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

Returns the brief description of the helper button.

Parameters
groupThe group index
paramThe parameter index
helperThe helper index
Returns
QString The brief description of the helper button

References IsisAmlData::groups.

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

◆ HelperButtonName()

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

Returns the name of the helper button.

Parameters
groupThe group index
paramThe parameter index
helperThe helper index
Returns
QString The name of the helper

References IsisAmlData::groups.

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

◆ HelperDescription()

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

Returns the long description of the helper button.

Parameters
groupThe group index
paramThe parameter index
helperThe helper index
Returns
QString The long description of the helper button

References IsisAmlData::groups.

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

◆ HelperFunction()

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

Returns the name of the helper function.

Parameters
groupThe group index
paramThe parameter index
helperThe helper index
Returns
QString The name of the helper function

References IsisAmlData::groups.

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

◆ HelperIcon()

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

Returns the name of the icon for the helper button.

Parameters
groupThe group index
paramThe parameter index
helperThe helper index
Returns
QString The name of the helper icon

References IsisAmlData::groups.

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

◆ HelpersSize()

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

◆ IsInteractive()

bool Isis::UserInterface::IsInteractive ( )
inline

Indicates if the Isis Graphical User Interface is operating.

Returns
bool

Referenced by Isis::Application::Application(), Isis::Application::History(), and Isis::Application::Run().

◆ IsParamInPvlInclude()

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

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

Verify if the Parameter is in the Included list.

Author
Sharmila Prasad (8/11/2011)
Parameters
paramName- parameter name
include- include list
Returns
bool

References Isis::IString::DownCase().

Referenced by IsisAml::CreatePVL().

◆ NumGroups()

int IsisAml::NumGroups ( ) const
inherited

Returns the number of groups found in the XML.

Returns
The number of groups.

References IsisAmlData::groups.

Referenced by SetBatchList().

◆ NumParams()

int IsisAml::NumParams ( const int & group) const
inherited

Returns the number of parameters in a group.

Parameters
groupThe group to measure.
Returns
The number of parameters.

References IsisAmlData::groups.

Referenced by IsisAml::CreatePVL(), and SetBatchList().

◆ ParamBrief()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
The brief description.

References IsisAmlData::groups.

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

◆ ParamDefault()

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

Returns the default for a parameter in a specified group.

Parameters
groupThe group index
paramThe parameter index
Returns
The default for the specified parameter.

References IsisAmlData::groups.

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

◆ ParamDescription()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
The long description

References IsisAmlData::groups.

◆ ParamExclude()

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

Returns the name of the specified excluded parameter.

Parameters
groupThe group index
paramThe parameter index
excludeThe exclude index
Returns
The name of the excluded parameter

References IsisAmlData::groups.

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

◆ ParamExcludeSize()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
The number of items in the parameters exclude list

References IsisAmlData::groups.

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

◆ ParamFileMode()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
The file mode for the parameter.

References IsisAmlData::groups.

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

◆ ParamFilter()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
The paramter filter.

References IsisAmlData::groups.

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

◆ ParamGreaterThan()

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

Returns the name of the specified greaterThan parameter.

Parameters
groupThe group index
paramThe parameter index
greatThe greaterThan index
Returns
The name of the greaterThan parameter

References IsisAmlData::groups.

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

◆ ParamGreaterThanOrEqual()

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

Returns the name of the specified greaterThanOrEqual parameter.

Parameters
groupThe group index
paramThe parameter index
greatThe greaterThanOrEqual index
Returns
The name of the greaterThanOrEqual parameter

References IsisAmlData::groups.

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

◆ ParamGreaterThanOrEqualSize()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
Number of values in the parameters greater than or equal list

References IsisAmlData::groups.

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

◆ ParamGreaterThanSize()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
Number of values in the parameters greater than list

References IsisAmlData::groups.

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

◆ ParamInclude()

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

Returns the name of the specified included parameter.

Parameters
groupThe group index
paramThe parameter index
includeThe include index
Returns
The name of the included parameter

References IsisAmlData::groups.

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

◆ ParamIncludeSize()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
The number of items in the parameters include list

References IsisAmlData::groups.

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

◆ ParamInternalDefault()

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

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

.

Parameters
groupThe group index
paramThe 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().

◆ ParamLessThan()

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

Returns the name of the specified lessThan parameter.

Parameters
groupThe group index
paramThe parameter index
lesThe lessThan index
Returns
The name of the lessThan parameter

References IsisAmlData::groups.

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

◆ ParamLessThanOrEqual()

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

Returns the name of the specified lessThanOrEqual parameter.

Parameters
groupThe group index
paramThe parameter index
lesThe lessThanOrEqual index
Returns
The name of the lessThanOrEqual parameter

References IsisAmlData::groups.

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

◆ ParamLessThanOrEqualSize()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
Number of values in the parameters less than or equal list

References IsisAmlData::groups.

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

◆ ParamLessThanSize()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
Number of values in the parameters less than list

References IsisAmlData::groups.

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

◆ ParamListBrief()

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

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

Parameters
groupThe group index
paramThe parameter index
optionThe option number within the parameters list.
Returns
The brief description of the option.

References IsisAmlData::groups.

◆ ParamListDescription()

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

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

Parameters
groupThe group index
paramThe parameter index
optionThe option number within the parameters list.
Returns
The full description of the option.

References IsisAmlData::groups.

◆ ParamListExclude()

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

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

Parameters
groupThe group index
paramThe parameter index
optionThe option number within the parameters list.
excludeThe exclusion number within the parameters list.
Returns
The parameter name to be excluded if this option is selected.

References IsisAmlData::groups.

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

◆ ParamListExcludeSize()

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

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

Parameters
groupThe group index
paramThe parameter index
optionThe option number within the parameters list.
Returns
The number of items in the parameters list exclude section.

References IsisAmlData::groups.

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

◆ ParamListInclude()

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

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

Parameters
groupThe group index
paramThe parameter index
optionThe option number within the parameters list.
includeThe inclusion number within the parameters list.
Returns
The parameter name to be included if this option is selected.

References IsisAmlData::groups.

◆ ParamListIncludeSize()

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

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

Parameters
groupThe group index
paramThe parameter index
optionThe option number within the parameters list.
Returns
The number of items in the parameters list include section.

References IsisAmlData::groups.

◆ ParamListSize()

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

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

Parameters
groupThe group index
paramThe 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::GuiComboBoxParameter::Set(), and Isis::GuiListParameter::Set().

◆ ParamListValue()

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

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

Parameters
groupThe group index
paramThe parameter index
optionThe option number within the parameters list.
Returns
The value of the option.

References IsisAmlData::groups.

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

◆ ParamMaximum()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
The maximum

References IsisAmlData::groups.

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

◆ ParamMaximumInclusive()

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

Returns whether the maximum value is inclusive or not.

Parameters
groupThe group index
paramThe parameter index
Returns
Whether maximum is inclusive or not

References IsisAmlData::groups.

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

◆ ParamMinimum()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
The minimum

References IsisAmlData::groups.

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

◆ ParamMinimumInclusive()

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

Returns whether the minimum value is inclusive or not.

Parameters
groupThe group index
paramThe parameter index
Returns
Whether minimum is inclusive or not

References IsisAmlData::groups.

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

◆ ParamName()

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

Returns the parameter name.

Parameters
groupThe group index where the parameter can be found.
paramThe index of the parameter to name.
Returns
The name of the parameter.

References IsisAmlData::groups.

Referenced by IsisAml::CommandLine(), IsisAml::CreatePVL(), IsisAml::GetParams(), Isis::GuiParameter::GuiParameter(), and SetBatchList().

◆ ParamNotEqual()

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

Returns the name of the specified notEqual parameter.

Parameters
groupThe group index
paramThe parameter index
notEqThe notEqual index
Returns
The name of the notEqual parameter

References IsisAmlData::groups.

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

◆ ParamNotEqualSize()

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

Returns the number of values in the not equal list.

Parameters
groupThe group index
paramThe parameter index
Returns
Number of values in the parameters not equal list

References IsisAmlData::groups.

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

◆ ParamOdd()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
Whether the parameter restricts odd values or not

References IsisAmlData::groups.

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

◆ ParamPath()

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

Returns the default path for a filename/cube parameter.

Parameters
groupThe group index
paramThe parameter index
Returns
The default path.

References IsisAmlData::groups.

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

◆ ParamType()

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

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

Parameters
groupThe group index
paramThe parameter index
Returns
The type of parameter.

References IsisAmlData::groups.

Referenced by IsisAml::CreatePVL(), and Isis::GuiParameter::GuiParameter().

◆ ParentId()

int Isis::UserInterface::ParentId ( )
inline

Returns the parent id.

Returns
int The parent id

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

◆ PixelType()

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

Returns the default pixel type from the XML.

Parameters
groupThe group index
paramThe parameter index
Returns
The default pixel type

References IsisAmlData::groups.

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

◆ ProgramName()

QString IsisAml::ProgramName ( ) const
inherited

Returns the Program name.

Returns
The name of the program.

References IsisAmlData::name.

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

◆ PutAsString() [1/2]

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

Allows the insertion of a value for any parameter.

No validity check is performed on the value passed in.

Parameters
paramNameThe partial or full name of the parameter to be modified.
valueThe 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
IExceptionThe 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_, IsisAml::ReturnParam(), and Isis::IException::User.

Referenced by SetBatchList().

◆ PutAsString() [2/2]

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

◆ PutBoolean() [1/2]

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

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

A validity check is performed on the value passed in.

Parameters
paramNameThe partial or full name of the parameter to be modified.
valueThe 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, and IsisAml::ReturnParam().

◆ PutBoolean() [2/2]

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

◆ PutCubeName()

void IsisAml::PutCubeName ( const QString & paramName,
const QString & value )
inherited

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

A validity check is performed on the value passed in.

Parameters
paramNameThe partial or full name of the parameter to be modified.
valueThe QString representation of the value to be placed in the cubename's value data member.

References _FILEINFO_, Isis::IException::Programmer, and IsisAml::ReturnParam().

◆ PutDouble() [1/2]

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

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

A validity check is performed on the value passed in.

Parameters
paramNameThe partial or full name of the parameter to be modified.
valueThe 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, IsisAml::ReturnParam(), and Isis::toString().

◆ PutDouble() [2/2]

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

◆ PutFileName() [1/2]

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

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

A validity check is performed on the value passed in.

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

References _FILEINFO_, Isis::IException::Programmer, and IsisAml::ReturnParam().

◆ PutFileName() [2/2]

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

◆ PutInteger() [1/2]

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

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

A validity check is performed on the value passed in.

Parameters
paramNameThe partial or full name of the parameter to be modified.
valueThe 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, IsisAml::ReturnParam(), and Isis::toString().

◆ PutInteger() [2/2]

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

◆ PutString() [1/2]

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

Allows the insertion of a value for any parameter.

No validity check is performed on the value passed in.

Parameters
paramNameThe partial or full name of the parameter to be modified.
valueThe 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, and IsisAml::ReturnParam().

◆ PutString() [2/2]

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

◆ ReturnParam()

const IsisParameterData * IsisAml::ReturnParam ( const QString & paramName) const
protectedinherited

◆ SaveHistory()

void Isis::UserInterface::SaveHistory ( )

Saves the user parameter information in the history of the program for later use.

References IsisAml::CommandLine(), Isis::Preference::Preferences(), IsisAml::ProgramName(), Isis::Pvl::read(), Isis::toInt(), and Isis::PvlObject::Traverse.

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

◆ SetBatchList()

void Isis::UserInterface::SetBatchList ( int i)

Clears the gui parameters and sets the batch list information at line i as the new parameters.

Parameters
iThe line number to retrieve parameter information from
Exceptions
Isis::IException::User- Invalid command line

References _FILEINFO_, IsisAml::Clear(), IsisAml::NumGroups(), IsisAml::NumParams(), IsisAml::ParamName(), IsisAml::PutAsString(), Isis::toInt(), Isis::IString::Token(), Isis::IString::ToQt(), Isis::IException::User, and IsisAml::VerifyAll().

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

◆ SetErrorList()

void Isis::UserInterface::SetErrorList ( int i)

This method adds the line specified in the BatchList that the error occured on.

The BatchList line is added exactly as it is seen, so the BatchList command can be run on the errorlist file created.

Parameters
iThe line of the batchlist to write to the error file
Exceptions
Isis::IException::User- Unable to create error list - Disk may be full or directory permissions not writeable

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

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

◆ StringToBool()

bool IsisAml::StringToBool ( QString value) const
inherited

Returns a boolean value based on the QString contents.

Parameters
valueThe 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 IsisAml::VerifyAll().

◆ TheGui()

Gui * Isis::UserInterface::TheGui ( )
inline

◆ VerifyAll()

◆ Version()

QString IsisAml::Version ( ) const
inherited

Returns the application version date.

Returns
The application version date

References IsisAmlData::changes.

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

◆ WasEntered()

bool IsisAml::WasEntered ( const QString & paramName) const
inherited

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

Parameters
paramNameThe name of the parameter to check if it was entered
Returns
True if the parameter was entered, and false if it was not

References IsisAml::ReturnParam().

Referenced by Isis::GuiParameter::SetToCurrent(), and Isis::GuiParameter::Update().

Member Data Documentation

◆ brief

QString IsisAmlData::brief
inherited

◆ categorys

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

◆ changes

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

◆ description

QString IsisAmlData::description
inherited

◆ groups

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

◆ name


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