SetInstance¶

public class SetInstance extends BasicInstance<SetInstanceBase> implements Iterable<Object>¶

A SetInstance object stores the information regarding a specific instance of a set. The instances can be accessed through the function Set.get of the parent entity.

The members of the set can be strings, double numbers or tuples.

Data can be assigned using Set.setValues or using AMPL.setData and a DataFrame object.

All the accessors in this class throw a IllegalArgumentException if the instance has been deleted in the underlying AMPL interpreter.

Constructors¶

SetInstance¶

SetInstance(SetInstanceBase impl)¶

Methods¶

contains¶

public boolean contains(Object o)¶

Check contents of the set for members. The object to be found can be a String, a double, a Tuple or an array. In this last case, each element in the array is considered as elements of a Tuple to be found.

i.e. the following are equivalent:

contains(new Tuple(1, "abc"));

and

contains(new Object[]{1, "abc});

Parameters

o – Object to be found (double, String, Tuple or Object[] with the elements of a tuple)

Returns

True if the object is present.

containsAll¶

public boolean containsAll(Collection<?> c)¶

Check if the sets contains all the elements in the collection c. Each element in the collection can be a double, a String, a Tuple or an array. In case of arrays, each array is considered as a Tuple.

Example: considering the AMPL set declared as

set s := {(1, 'abc'), ('def', 2)};

the following is true:

List<Object> l = new LinkedList<Object>();
list.add(new Tuple("def", 2));
list.add(new Object[] { 1, "abc" });
ampl.getSet("s").get().containsAll(list);

Parameters

c – A Collection of objects to be found. See above for the semantics of the objects.

Returns

True if all the specified objects are present

containsAll¶

public boolean containsAll(double[] c)¶

containsAll¶

public boolean containsAll(int[] c)¶

containsAll¶

public boolean containsAll(String[] c)¶

getValues¶

public DataFrame getValues()¶: Get all the members of this set in a DataFrame

impl¶

SetInstanceBase impl()¶

iterator¶

public Iterator<Object> iterator()¶

setValues¶

public void setValues(Tuple[] objects)¶

Assign values to the this set. The values can be strings, doubles, tuples or arrays of objects (which will be converted into tuples).

For example, to assign values to a set of tuples:

ampl.eval("set s dimen 2;");
Set s = ampl.getSet("s");
Object[] data = new Object[] { new Tuple(1, "abc"), new Tuple(2, "def") };
s.setValues(data);

or alternatively, using arrays of objects:

ampl.eval("set s dimen 2;");
Set s = ampl.getSet("s");
Object[] data = new Object[] {new Object[]{1, "abc"}, new Object{2, "def"}};
s.setValues(data);

Parameters

objects – Values to be assigned to the set

setValues¶

public void setValues(Tuple value)¶

setValues¶

public void setValues(DataFrame data)¶

setValuesFlattened¶

public void setValuesFlattened(double... objects)¶

An alternative way to assign values to a set of tuples of size n is to use a flattened array, in which every n elements are considered a Tuple. So, an equivalent formulation of the example above is:

ampl.eval("set s dimen 2;");
Set s = ampl.getSet("s");
Object[] data = new Object[] { 1, "abc", 2, "def" };
s.setValues(data);

Parameters

objects –

setValuesFlattened¶

public void setValuesFlattened(String... objects)¶

size¶

public int size()¶

Get the size

Returns: Cardinality of this set

toArray¶

public Object[] toArray()¶

Convert this set to an array.

Valid only for not indexed sets.

toSet¶

public java.util.Set<Object> toSet()¶

Convert this set to an java set.

Valid only for not indexed sets.

Set

Variable