Loading...
Searching...
No Matches

GAMS Alias. More...

Inheritance diagram for Set:
Abstract

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);
GAMS Transfer Container stores (multiple) symbols.
Definition: Container.m:67
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:

  1. container (Container): Container object this symbol should be stored in
  2. name (string): name of alias
  3. 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:

  1. destination (Container): Destination container

Optional Arguments:

  1. 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:

  1. 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:

  1. verbose (logical): If true, the reason for an invalid symbol is printed
  2. 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