Parameter¶

public class Parameter extends BasicEntity<Object>¶

Represents an AMPL parameter. The values can be Double or String (in case of symbolic parameters).

Data can be assigned to the parameter using the methods set, setValues directly from objects of this class or using AMPL.setData and a DataFrame object.

Constructors¶

Parameter¶

public Parameter(Entity entity)¶: Constructor

Parameter¶

protected Parameter(ParameterBase impl)¶

Methods¶

get¶

public Object get()¶

Get the value of a scalar parameter.

Throws

IllegalStateException – if the entity has been deleted in the underlying AMPL
UnsupportedOperationException – if this parameter is not scalar.

get¶

public Object get(Object... key)¶

Get the value corresponding to key. The value will be a string or a double if the parameter is symbolic, a double otherwise. See Access to instances and values for further information on how the key can be specified.

Parameters

key – The key to be found

Throws

IllegalStateException – if the entity has been deleted in the underlying AMPL interpreter
IllegalArgumentException – if trying to access an instance with the wrong number of keys (see Entity.indexarity)

Returns

The value of the parameter for the corresponding key (String or double) or null if the specified key is not found

get¶

public Object get(Tuple key)¶

Get the value corresponding to key (passed as a Tuple). The value will be a string or a double if the parameter is symbolic, a double otherwise. See Access to instances and values for further information on how the key can be specified.

Parameters

key – The key (as a tuple) to be found

Throws

IllegalStateException – if the entity has been deleted in the underlying AMPL interpreter
IllegalArgumentException – if trying to access an instance with the wrong number of keys (see Entity.indexarity)

Returns

The value of the parameter for the corresponding key (String or double) or null if the specified key is not found

hasDefault¶

public boolean hasDefault()¶

Check if the parameter has a default initial value. In case of the following AMPL code:

param a;
param b default a;

the function will return true for parameter b.

Returns: True if the parameter has a default initial value. Please note that if the parameter has a default expression which refers to another parameter which value is not defined, this will return true.

impl¶

ParameterBase impl()¶

isSymbolic¶

public boolean isSymbolic()¶

Check if the parameter is symbolic (aka can store strings)

Returns: True if the parameter is symbolic

iterator¶

public Iterator<Object> iterator()¶

set¶

public void set(double index, double value)¶

Assign a value to the parameter at the specified index, equivalent to the AMPL code

let par[index] := value;

Parameters

index – Index (key) of instance to be set, can be a Tuple or an array for multidimensional parameters.
value – Value to set.

Throws

UnsupportedOperationException – If called on a scalar parameter

set¶

public void set(String index, double value)¶

set¶

public void set(Tuple index, double value)¶

set¶

public void set(double index, String value)¶

Assign a string to the parameter at the specified index, equivalent to the AMPL code:

let par[index] := value;

Parameters

index – Index (key) of instance to be set, can be a Tuple or an array for multidimensional parameters.
value – Value to set.

Throws

UnsupportedOperationException – If called on a scalar parameter

set¶

public void set(String index, String value)¶

set¶

public void set(Tuple index, String value)¶

set¶

public void set(double value)¶

Set the value of a scalar parameter.

Throws

IllegalStateException – if the entity has been deleted in the underlying AMPL
UnsupportedOperationException – if this parameter is not scalar.

set¶

public void set(String value)¶

Set the value of a scalar parameter.

Throws

IllegalStateException – if the entity has been deleted in the underlying AMPL
UnsupportedOperationException – if the entity is not scalar.

setValues¶

public void setValues(Tuple[] indices, double[] values)¶

Assign the (double) values to the parameter instances with the specified indices, equivalent to the AMPL code:

let {i in indices} par[i] := values[i];

Parameters

indices – Index (key) of instance to be set. Each item in the array can be a Tuple or an array of objects, in case of multidimensional array.
values – Values to set.

Throws

UnsupportedOperationException – If called on a scalar parameter
IllegalArgumentException – if the dimension of some of the indices does not match the dimension of the indices of the parameter

setValues¶

public void setValues(Tuple[] indices, String[] values)¶

Assign the values (string or double) to the parameter instances with the specified indices, equivalent to the AMPL code:

let {i in indices} par[i] := values[i];

Parameters

indices – Index (key) of instance to be set. Each item in the array can be a Tuple or an array of objects, in case of multidimensional array.
values – Values to set.

Throws

UnsupportedOperationException – If called on a scalar parameter
IllegalArgumentException – If called with some string values on a non symbolic parameter or if the dimension of some of the indices does not match the dimension of the indices of the parameter

setValues¶

public void setValues(double[] rowindices, double[] colindices, double[][] values, boolean transpose)¶

Assign the specified values to a 2-d parameter, using the two dimensions as two indices.

For example, the \(m \times n\) matrix: \(A = \left( \begin{array}{cccc} a_{11} & a_{12} & ... & a_{1n} \\ a_{21} & a_{22} & ... & a_{2n} \\ ... & ... & ... & ... \\ a_{m1} & a_{m2} & ... & a_{mn} \end{array} \right)\)

can be assigned to the AMPL parameter: param A {1..m, 1..n}; with the statement setValues(A, false).

As an example, to assign the matrix: \(A = \left( \begin{array}{cccc} 11 & 12 \\ 21 & 22 \\ 31 & 32 \end{array} \right)\)

to the AMPL paramater: param A{1..3, 1..2}; we can use the following code.

ampl.eval("param a{1..3, 1..2};");
Parameter a = ampl.getParameter("a");
double[][] values = new double[3][2];
for (int i = 0; i < 3; i++)
  for (int j = 0; j < 2; j++)
    values[i][j] = (i + 1) * 10 + (j + 1);
a.setValues(new double[] { 1, 2, 3 }, new double[] { 1, 2 }, values, false);

Parameters

values – Values to be assigned
transpose – True to transpose the values in the matrix

Throws

UnsupportedOperationException – If the method is called on a parameter which is not two-dimensional
IllegalArgumentException – If the passed array of values is not rectangular or if the sizes of ‘values’ do not correspond to the sizes of the underlying indices

setValues¶

public void setValues(String[] rowindices, String[] colindices, double[][] values, boolean transpose)¶

setValues¶

public void setValues(String... values)¶

Assign the specified values to this parameter, assigning them to the parameter in the same order as the indices in the entity.

The number of values in the array must be of the same size of the parameter, as this function will try to assign all values.

Parameters

values – Values to be assigned.

Throws

IllegalArgumentException – If multiple values are assigned to a scalar parameter, if the size of the values array is not equal to the size (number of instances) of the parameter or if trying to assign a string to a non symbolic parameter

setValues¶

public void setValues(double... values)¶

toString¶

public String toString()¶

Returns a string representation of this parameter. Equivalent to the AMPL statement:

show parameterName;

ObjectiveInstance

Set