GAMS Alias. More...

Inheritance diagram for Set:

GAMS Alias.

This class represents a GAMS Alias, which is a link to another GAMS Set.

Example:

c = Container();
s = symbol.Set.construct(c, 's');
a = alias.Set.construct(c, 'a', s);

See also: Alias, symbol.Set, Container.addAlias

Public Member Functions
function	equals (in obj, in symbol)
	Checks equivalence with other symbol.

function	copy (in obj, in varargin)
	Copies symbol to destination container.

function	setRecords (in obj, in varargin)
	Sets symbol records in supported format.

function	transformRecords (in obj, in target_format)
	Transforms symbol records into given format.

function	isValid (in obj, in varargin)
	Checks correctness of alias.

function	getDomainViolations (in obj, in varargin)
	Get domain violations.

function	resolveDomainViolations (in obj, in varargin)
	Extends domain sets in order to resolve domain violations.

function	getSparsity (in obj)
	Returns the sparsity of symbol records.

function	getMaxValue (in obj, in varargin)
	Returns the largest value in records.

function	getMinValue (in obj, in varargin)
	Returns the smallest value in records.

function	getMeanValue (in obj, in varargin)
	Returns the mean value over all values in records.

function	getMaxAbsValue (in obj, in varargin)
	Returns the largest absolute value in records.

function	countNA (in obj, in varargin)
	Returns the number of GAMS NA values in records.

function	countUndef (in obj, in varargin)
	Returns the number of GAMS UNDEF values in records.

function	countEps (in obj, in varargin)
	Returns the number of GAMS EPS values in records.

function	countPosInf (in obj, in varargin)
	Returns the number of GAMS PINF (positive infinity) values in records.

function	countNegInf (in obj, in varargin)
	Returns the number of GAMS MINF (negative infinity) values in records.

function	getNumberRecords (in obj)
	Returns the number of GDX records (not available for matrix formats)

function	getNumberValues (in obj, in varargin)
	Returns the number of values stored for this symbol.Abstract.

function	getUELs (in obj, in varargin)
	Returns the UELs used in this symbol.

function	setUELs (in obj, in varargin)
	Sets the UELs with updating UEL codes in records.

function	addUELs (in obj, in varargin)
	Adds UELs to the symbol.

function	removeUELs (in obj, in varargin)
	Removes UELs from the symbol.

function	renameUELs (in obj, in varargin)
	Renames UELs in the symbol.

function	lowerUELs (in obj, in varargin)
	Converts UELs to lower case.

function	upperUELs (in obj, in varargin)
	Converts UELs to lower case.

Public Member Functions inherited from Abstract
function	copy (in obj, in varargin)
	(Abstract) Copies symbol to destination container

function	equals (in obj, in symbol)
	Checks equivalence with other symbol.

function	isValid (in obj, in varargin)
	(Abstract) Checks correctness of alias

function	getUELs (in obj, in varargin)
	(Abstract) Returns the UELs used in this symbol

function	removeUELs (in obj, in varargin)
	(Abstract) Removes UELs from the symbol

function	renameUELs (in obj, in uels)
	(Abstract) Renames UELs in the symbol

function	lowerUELs (in obj)
	(Abstract) Converts UELs to lower case

function	upperUELs (in obj)
	(Abstract) Converts UELs to lower case

Static Public Member Functions
static function	construct (in container, in name, in alias_with)
	Constructs a GAMS Alias.

Static Public Member Functions inherited from Abstract
static function	describe (in symbols)
	Returns an overview over all aliases given.

Public Attributes
Property	alias_with
	Aliased symbol.

Property	description
	Aliased GAMS Set description.

Property	is_singleton
	Indicator if aliased GAMS Set is singleton.

Property	dimension
	Aliased GAMS Set dimension (in [0,20])

Property	size
	Aliased GAMS Set Shape (length == dimension)

Property	domain
	Aliased GAMS Set domain (length == dimension)

Property	domain_labels
	Expected domain labels in records.

Property	domain_forwarding
	Enables domain forwarding in aliased symbol.

Property	records
	Storage of aliased Set records.

Public Attributes inherited from Abstract
Property	container
	Container the symbol is stored in.

Property	name
	Alias name.

Property	alias_with
	(Abstract) Aliased symbol

Property	description
	(Abstract) Aliased GAMS Set description

Property	is_singleton
	(Abstract) Indicator if aliased GAMS Set is singleton

Property	dimension
	(Abstract) Aliased GAMS Set dimension (in [0,20])

Property	size
	(Abstract) Aliased GAMS Set Shape (length == dimension)

Property	domain
	(Abstract) Aliased GAMS Set domain (length == dimension)

Property	domain_labels
	(Abstract) Expected domain labels in records

Property	domain_forwarding
	(Abstract) Enables domain forwarding in aliased symbol

Property	records
	(Abstract) Storage of aliased Set records

Property	modified
	Flag to indicate modification.

Private Attributes
Property	domain_names
	Aliased GAMS Set domain names.

Property	domain_type
	Specifies if domains are stored 'relaxed' or 'regular'.

Property	format
	Records format of aliased Set records.

Member Function Documentation

◆ addUELs()

function addUELs	(	in	obj,
		in	varargin
	)

Adds UELs to the symbol.

See also: symbol.Abstract.addUELs

◆ construct()

static function construct	(	in	container,
		in	name,
		in	alias_with
	)

static

Constructs a GAMS Alias.

See Creating a Symbol for more information.

Required Arguments:

container (Container): Container object this symbol should be stored in
name (string): name of alias
alias_with (Set or Alias): GAMS Set to be linked to

Example:

c = Container();
s = symbol.Set.construct(c, 's');
a = alias.Set.construct(c, 'a', s);

See also: Alias, symbol.Set, Container.addAlias

◆ copy()

function copy	(	in	obj,
		in	varargin
	)

Copies symbol to destination container.

If destination container does not have a symbol equal to the aliased symbol, an error is raised.

Required Arguments:

destination (Container): Destination container

Optional Arguments:

overwrite (bool): Overwrites symbol with same name in destination if true. Default: false.

◆ countEps()

function countEps	(	in	obj,
		in	varargin
	)

Returns the number of GAMS EPS values in records.

See also: symbol.Abstract.countEps

◆ countNA()

function countNA	(	in	obj,
		in	varargin
	)

Returns the number of GAMS NA values in records.

See also: symbol.Abstract.countNA

◆ countNegInf()

function countNegInf	(	in	obj,
		in	varargin
	)

Returns the number of GAMS MINF (negative infinity) values in records.

See also: symbol.Abstract.countNegInf

◆ countPosInf()

function countPosInf	(	in	obj,
		in	varargin
	)

Returns the number of GAMS PINF (positive infinity) values in records.

See also: symbol.Abstract.countPosInf

◆ countUndef()

function countUndef	(	in	obj,
		in	varargin
	)

Returns the number of GAMS UNDEF values in records.

See also: symbol.Abstract.countUndef

◆ equals()

function equals	(	in	obj,
		in	symbol
	)

Checks equivalence with other symbol.

Note: A symbol is always linked to a container. This method does not check equivalence of the linked containers.

Required Arguments:

symbol (any): Other symbol

◆ getDomainViolations()

function getDomainViolations	(	in	obj,
		in	varargin
	)

Get domain violations.

See also: symbol.Abstract.getDomainViolations

◆ getMaxAbsValue()

function getMaxAbsValue	(	in	obj,
		in	varargin
	)

Returns the largest absolute value in records.

See also: symbol.Abstract.getMaxAbsValue

◆ getMaxValue()

function getMaxValue	(	in	obj,
		in	varargin
	)

Returns the largest value in records.

See also: symbol.Abstract.getMaxValue

◆ getMeanValue()

function getMeanValue	(	in	obj,
		in	varargin
	)

Returns the mean value over all values in records.

See also: symbol.Abstract.getMeanValue

◆ getMinValue()

function getMinValue	(	in	obj,
		in	varargin
	)

Returns the smallest value in records.

See also: symbol.Abstract.getMinValue

◆ getNumberRecords()

function getNumberRecords ( in obj )

Returns the number of GDX records (not available for matrix formats)

See also: symbol.Abstract.getNumberRecords

◆ getNumberValues()

function getNumberValues	(	in	obj,
		in	varargin
	)

Returns the number of values stored for this symbol.Abstract.

See also: symbol.Abstract.getNumberValues

◆ getSparsity()

function getSparsity ( in obj )

Returns the sparsity of symbol records.

See also: symbol.Abstract.getSparsity

◆ getUELs()

function getUELs	(	in	obj,
		in	varargin
	)

Returns the UELs used in this symbol.

See also: symbol.Abstract.getUELs

◆ isValid()

function isValid	(	in	obj,
		in	varargin
	)

Checks correctness of alias.

Optional Arguments:

verbose (logical): If true, the reason for an invalid symbol is printed
force (logical): If true, forces reevaluation of validity (resets cache)

◆ lowerUELs()

function lowerUELs	(	in	obj,
		in	varargin
	)

Converts UELs to lower case.

See also: symbol.Abstract.lowerUELs

◆ removeUELs()

function removeUELs	(	in	obj,
		in	varargin
	)

Removes UELs from the symbol.

See also: symbol.Abstract.removeUELs

◆ renameUELs()

function renameUELs	(	in	obj,
		in	varargin
	)

Renames UELs in the symbol.

See also: symbol.Abstract.renameUELs

◆ resolveDomainViolations()

function resolveDomainViolations	(	in	obj,
		in	varargin
	)

Extends domain sets in order to resolve domain violations.

See also: symbol.Abstract.resolveDomainViolations

◆ setRecords()

function setRecords	(	in	obj,
		in	varargin
	)

Sets symbol records in supported format.

See also: symbol.Abstract.setRecords

◆ setUELs()

function setUELs	(	in	obj,
		in	varargin
	)

Sets the UELs with updating UEL codes in records.

See also: symbol.Abstract.setUELs

◆ transformRecords()

function transformRecords	(	in	obj,
		in	target_format
	)

Transforms symbol records into given format.

See also: symbol.Abstract.transformRecords

◆ upperUELs()

function upperUELs	(	in	obj,
		in	varargin
	)

Converts UELs to lower case.

See also: symbol.Abstract.upperUELs

Public Member Functions

Static Public Member Functions

Public Attributes

Private Attributes

Member Function Documentation

◆ addUELs()

◆ construct()

◆ copy()

◆ countEps()

◆ countNA()

◆ countNegInf()

◆ countPosInf()

◆ countUndef()

◆ equals()

◆ getDomainViolations()

◆ getMaxAbsValue()

◆ getMaxValue()

◆ getMeanValue()

◆ getMinValue()

◆ getNumberRecords()

◆ getNumberValues()

◆ getSparsity()

◆ getUELs()

◆ isValid()

◆ lowerUELs()

◆ removeUELs()

◆ renameUELs()

◆ resolveDomainViolations()

◆ setRecords()

◆ setUELs()

◆ transformRecords()

◆ upperUELs()