org.ptolemy.fmi

Class FMIScalarVariable

java.lang.Object

org.ptolemy.fmi.FMIScalarVariable

public class FMIScalarVariable
extends java.lang.Object

An object that represents the ScalarVariable element of a modelDescription.xml file contained within a Functional Mock-up Interface .fmu XML file.

A Functional Mock-up Unit file is a .fmu file in zip format that contains a .xml file named "modelDescription.xml". In that file, the ModelVariables element may contain elements such as ScalarVariable.

FMI documentation may be found at http://www.modelisar.com/fmi.html.

Since:

Ptolemy II 10.0

Version:

$Id: FMIScalarVariable.java 70402 2014-10-23 00:52:20Z cxh $

Author:

Christopher Brooks

Accepted Rating:

Red (cxh)

Proposed Rating:

Red (cxh)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FMIScalarVariable.Alias Acceptable values for the alias xml attribute.
static class	FMIScalarVariable.Causality Acceptable values for the causality xml attribute.
static class	FMIScalarVariable.Variability Acceptable values for the variability xml attribute.

Field Summary

Fields

Modifier and Type	Field and Description
FMIScalarVariable.Alias	alias The value of the alias xml attribute.
FMIScalarVariable.Causality	causality The value of the causality xml attribute.
java.lang.String	description The value of the description xml attribute.
java.util.Set<java.lang.String>	directDependency The input ports on which an output has a direct dependence.
FMIModelDescription	fmiModelDescription The Model Description for this variable.
java.lang.String	name The value of the name xml attribute.
FMIType	type The value of the type xml attribute.
long	valueReference The value of the valueReference xml attribute.
FMIScalarVariable.Variability	variability The value of the variability xml attribute.

Constructor Summary

Constructors

Constructor and Description
FMIScalarVariable() Create an empty ScalarVariable.
FMIScalarVariable(FMIModelDescription fmiModelDescription, org.w3c.dom.Element element) Create a ScalarVariable from an XML Element.

Method Summary

Modifier and Type	Method and Description
boolean	getBoolean(com.sun.jna.Pointer fmiComponent) Return the value of this variable as a boolean.
double	getDouble(com.sun.jna.Pointer fmiComponent) Return the value of this variable as a double.
int	getInt(com.sun.jna.Pointer fmiComponent) Return the value of this variable as an int.
java.lang.String	getString(com.sun.jna.Pointer fmiComponent) Return the value of this variable as a String.
void	setBoolean(com.sun.jna.Pointer fmiComponent, boolean value) Set the value of this variable as a boolean.
void	setDouble(com.sun.jna.Pointer fmiComponent, double value) Set the value of this variable as a double.
void	setInt(com.sun.jna.Pointer fmiComponent, int value) Set the value of this variable as an integer.
void	setString(com.sun.jna.Pointer fmiComponent, java.lang.String value) Set the value of this variable as a String.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

alias

public FMIScalarVariable.Alias alias

The value of the alias xml attribute.

causality

public FMIScalarVariable.Causality causality

The value of the causality xml attribute.

description

public java.lang.String description

The value of the description xml attribute.

directDependency

public java.util.Set<java.lang.String> directDependency

The input ports on which an output has a direct dependence.

fmiModelDescription

public FMIModelDescription fmiModelDescription

The Model Description for this variable.

name

public java.lang.String name

The value of the name xml attribute.

type

public FMIType type

The value of the type xml attribute.

valueReference

public long valueReference

The value of the valueReference xml attribute. In FMI 1.0, a valueReference is typically 32-bits or an unsigned int. Java does not have an unsigned int, so we use a long.

variability

public FMIScalarVariable.Variability variability

The value of the variability xml attribute.

Constructor Detail

FMIScalarVariable

public FMIScalarVariable()

Create an empty ScalarVariable.

FMIScalarVariable

public FMIScalarVariable(FMIModelDescription fmiModelDescription,
                         org.w3c.dom.Element element)

Create a ScalarVariable from an XML Element.

Parameters:

fmiModelDescription - the Model Description for this variable.

element - The XML Element that contains attributes.

Method Detail

getBoolean

public boolean getBoolean(com.sun.jna.Pointer fmiComponent)

Return the value of this variable as a boolean.

Parameters:

fmiComponent - The Functional Mock-up Interface (FMI) component that contains a reference to the variable.

Returns:

the value of this variable as boolean.

See Also:

setBoolean(Pointer, boolean)

getDouble

public double getDouble(com.sun.jna.Pointer fmiComponent)

Return the value of this variable as a double. If the variable is of type FMIIntegerType, the the integer value is cast to a double.

Parameters:

fmiComponent - The Functional Mock-up Interface (FMI) component that contains a reference to the variable.

Returns:

the value of this variable as double.

See Also:

setDouble(Pointer, double)

getInt

public int getInt(com.sun.jna.Pointer fmiComponent)

Return the value of this variable as an int.

Parameters:

fmiComponent - The Functional Mock-up Interface (FMI) component that contains a reference to the variable.

Returns:

the value of this variable as an int.

See Also:

setInt(Pointer, int)

getString

public java.lang.String getString(com.sun.jna.Pointer fmiComponent)

Return the value of this variable as a String.

Parameters:

fmiComponent - The Functional Mock-up Interface (FMI) component that contains a reference to the variable.

Returns:

the value of this variable as a String.

See Also:

setString(Pointer, String)

setBoolean

public void setBoolean(com.sun.jna.Pointer fmiComponent,
                       boolean value)

Set the value of this variable as a boolean.

Parameters:

fmiComponent - The Functional Mock-up Interface (FMI) component that contains a reference to the variable.

value - The value of this variable.

See Also:

getBoolean(Pointer fmiComponent)

setDouble

public void setDouble(com.sun.jna.Pointer fmiComponent,
                      double value)

Set the value of this variable as a double.

Parameters:

fmiComponent - The Functional Mock-up Interface (FMI) component that contains a reference to the variable.

value - The value of this variable.

See Also:

getDouble(Pointer)

setInt

public void setInt(com.sun.jna.Pointer fmiComponent,
                   int value)

Set the value of this variable as an integer.

Parameters:

fmiComponent - The Functional Mock-up Interface (FMI) component that contains a reference to the variable.

value - The value of this variable.

See Also:

getInt(Pointer)

setString

public void setString(com.sun.jna.Pointer fmiComponent,
                      java.lang.String value)

Set the value of this variable as a String. This method allocates memory, the caller should eventually call FMIModelDescription.dispose().

Parameters:

fmiComponent - The Functional Mock-up Interface (FMI) component that contains a reference to the variable.

value - The value of this variable.

See Also:

getString(Pointer)