Keys and Parameters

copysource//making 3 keys
String keyName = "encoder";
Key<Boolean> k1 = JKeyType.BooleanKey().make(keyName);
Key<Short> k2 = JKeyType.ShortKey().make(keyName, JUnits.NoUnits);
Key<String> k3 = JKeyType.StringKey().make(keyName, JUnits.day);

//storing a single value
Parameter<Boolean> booleanParam = k1.set(true);

//storing multiple values
Short[] shortArray = {1, 2, 3, 4};
Parameter<Short> paramWithManyShorts1 = k2.setAll(shortArray);
Parameter<Short> paramWithManyShorts2 = k2.set((short) 1, (short) 2, (short) 3, (short) 4);

//associating units
String[] weekDays = {"Sunday", "Monday", "Tuesday"};
Parameter<String> paramWithUnits1 = k3.setAll(weekDays);
Parameter<String> paramWithUnits2 = k3.setAll(weekDays).withUnits(JUnits.day);

//deault unit is NoUnits()
boolean hasDefaultUnit = booleanParam.units() == JUnits.NoUnits; //true

//set units explicitly on an existing Parameter
Parameter<Short> paramWithUnits3 = paramWithManyShorts1.withUnits(JUnits.meter);

//retrieve values from Parameter
Short[] allValues = (Short[]) paramWithManyShorts1.values();

//retrieve just top value
Short head = paramWithManyShorts1.head();

copysource//make some arrays
Double[] arr1 = {1.0, 2.0, 3.0, 4.0, 5.0};
Double[] arr2 = {10.0, 20.0, 30.0, 40.0, 50.0};

//keys
Key<ArrayData<Double>> filterKey = JKeyType.DoubleArrayKey().make("filter", JUnits.NoUnits);

//Store some values using helper method in ArrayData
Parameter<ArrayData<Double>> p1 = filterKey.set(ArrayData.fromArray(arr1), ArrayData.fromArray(arr2));
Parameter<ArrayData<Double>> p2 = filterKey.set(ArrayData.fromArray(arr2)).withUnits(JUnits.liter);

//add units to existing parameters
Parameter<ArrayData<Double>> p1AsCount = p1.withUnits(JUnits.count);

//default unit is NoUnits()
boolean bDefaultUnit = JUnits.NoUnits == p1.units();

//retrieving values
List<Double> head = p1.head().jValues();
List<ArrayData<Double>> listOfArrayData = p1.jValues();
Double[] arrayOfDoubles = (Double[]) p2.jValues().get(0).values();

copysource//make some arrays
Byte[][] m1 = {{1, 2, 3}, {4, 5, 6}, {7, 8, 9}};
Byte[][] m2 = {{1, 2, 3, 4, 5}, {10, 20, 30, 40, 50}};

//keys
Key<MatrixData<Byte>> encoderKey = JKeyType.ByteMatrixKey().make("encoder", JUnits.NoUnits);

//Store some values using helper method in ArrayData
Parameter<MatrixData<Byte>> p1 = encoderKey.set(
        MatrixData.fromArrays(m1),
        MatrixData.fromArrays(m2));
Parameter<MatrixData<Byte>> p2 = encoderKey.set(
        MatrixData.fromArrays(m2)
).withUnits(JUnits.liter);

//add units to existing parameters
Parameter<MatrixData<Byte>> p1AsLiter = p1.withUnits(JUnits.liter);

//default unit is NoUnits()
boolean bDefaultUnit = JUnits.NoUnits == p1.units();

//retrieving values
MatrixData<Byte> head = p1.head();
List<MatrixData<Byte>> matrixData1 = p1.jValues();
List<MatrixData<Byte>> matrixData2 = p2.jValues();

copysource
//import csw.params.core.models.Coords.*;
//import static csw.params.core.models.JCoords.*;
//import static csw.params.core.models.Coords.*;

// Coordinate types
ProperMotion pm = new ProperMotion(0.5, 2.33);

EqCoord eqCoord = new EqCoord("12:13:14.15", "-30:31:32.3", FK5(), BASE(),
        DEFAULT_CATNAME(), pm.pmx(), pm.pmy());

SolarSystemCoord solarSystemCoord = new SolarSystemCoord(BASE(), Venus());

MinorPlanetCoord minorPlanetCoord = new MinorPlanetCoord(GUIDER1(), 2000, JAngle.degree(90),
        JAngle.degree(2), JAngle.degree(100), 1.4, 0.234, JAngle.degree(220));

CometCoord cometCoord = new CometCoord(BASE(), 2000.0, JAngle.degree(90),
        JAngle.degree(2), JAngle.degree(100), 1.4, 0.234);

AltAzCoord altAzCoord = new AltAzCoord(BASE(), JAngle.degree(301), JAngle.degree(42.5));

// Can use base trait CoordKey to store values for all types
Key<Coord> basePosKey = JKeyType.CoordKey().make("BasePosition", JUnits.NoUnits);

Parameter<Coord> posParam = basePosKey.set(eqCoord, solarSystemCoord, minorPlanetCoord, cometCoord, altAzCoord);

//retrieving values
assert (posParam.jValues().size() == 5);
assert (posParam.jValues().get(0).equals(eqCoord));
assert (posParam.jValues().get(1).equals(solarSystemCoord));
assert (posParam.jValues().get(2).equals(minorPlanetCoord));
assert (posParam.jValues().get(3).equals(cometCoord));
assert (posParam.jValues().get(4).equals(altAzCoord));

copysource//Choice
final Choices choices = Choices.from("A", "B", "C");

//keys
GChoiceKey choice1Key = JKeyType.ChoiceKey().make("mode", JUnits.NoUnits, choices);
GChoiceKey choice2Key = JKeyType.ChoiceKey().make(
        "mode-reset", JUnits.NoUnits,
        Choices.fromChoices(
                new Choice("c"),
                new Choice("b"),
                new Choice("a")));

//store values
Parameter<Choice> p1 = choice1Key.set(new Choice("A")).withUnits(JUnits.foot);
Parameter<Choice> p2 = choice2Key.set(new Choice("c"));

//add units
Parameter<Choice> paramWithFoot = p1.withUnits(JUnits.foot);

//default unit is NoUnits()
boolean bDefaultUnit = JUnits.NoUnits == p2.units();

//retrieving values
Choice head = p1.head();
List<Choice> values = p2.jValues();