org.sbml.jsbml.ext.qual

Class Output

java.lang.Object

org.sbml.jsbml.AbstractTreeNode

org.sbml.jsbml.AbstractSBase

org.sbml.jsbml.AbstractNamedSBase

org.sbml.jsbml.ext.qual.Output

All Implemented Interfaces:

Serializable, Cloneable, TreeNode, org.sbml.jsbml.CallableSBase, org.sbml.jsbml.NamedSBase, org.sbml.jsbml.NamedSBaseWithDerivedUnit, org.sbml.jsbml.SBase, org.sbml.jsbml.SBaseWithDerivedUnit, org.sbml.jsbml.UniqueNamedSBase, org.sbml.jsbml.util.TreeNodeWithChangeSupport

public class Output
extends org.sbml.jsbml.AbstractNamedSBase
implements org.sbml.jsbml.UniqueNamedSBase, org.sbml.jsbml.CallableSBase

Each Output refers to a QualitativeSpecies that participates in (is affected by) the corresponding Transition. In Petri net models these are the output places of the transition. In a logical model, a QualitativeSpecies should be referenced in at most one listOfOutputs, (that of the Transition defining the evolution of this species). When a Transition has several outputs, it is because the referenced species share the same regulators and the same logical rules.

Since:

1.0

Version:

$Rev$

Author:

Nicolas Rodriguez, Finja Büchel, Florian Mittag

See Also:

Serialized Form

Last modified:

$Date$

Field Summary

Fields inherited from class org.sbml.jsbml.AbstractSBase

ignoredExtensions, ignoredXMLElements, packageName

Fields inherited from class org.sbml.jsbml.AbstractTreeNode

listOfListeners, parent, resourceBundle, UNKNOWN_ATTRIBUTES, UNKNOWN_ELEMENTS

Constructor Summary

Constructors

Constructor and Description
Output()
Output(int level, int version)
Output(Output out)
Output(QualitativeSpecies qualitativeSpecies, OutputTransitionEffect transitionEffect)
Output(String id)
Output(String id, int level, int version)
Output(String id, QualitativeSpecies qualitativeSpecies, OutputTransitionEffect transitionEffect)
Output(String id, String name, int level, int version)

Method Summary

Modifier and Type	Method and Description
Output	clone()
boolean	containsUndeclaredUnits()
boolean	equals(Object object)
org.sbml.jsbml.UnitDefinition	getDerivedUnitDefinition()
String	getDerivedUnits()
int	getOutputLevel() Returns the outputLevel.
String	getQualitativeSpecies() Returns the qualitativeSpecies
OutputTransitionEffect	getTransitionEffect() Returns the transitionEffect
int	hashCode()
void	initDefaults()
boolean	isIdMandatory()
boolean	isOutputLevelMandatory()
boolean	isQualitativeSpeciesMandatory()
boolean	isSetOutputLevel()
boolean	isSetQualitativeSpecies()
boolean	isSetTransitionEffect()
boolean	isTransitionEffectMandatory()
boolean	readAttribute(String attributeName, String prefix, String value)
void	setOutputLevel(int level) The outputLevel is a non-negative integer used along with the transitionEffect to specify the effect of the Transition on the corresponding QualitativeSpecies.
void	setQualitativeSpecies(String qualitativeSpecies) The required attribute qualitativeSpecies is used to identify the QualitativeSpecies that is the output of this Transition.
void	setTransitionEffect(OutputTransitionEffect transitionEffect) Each Output has a required attribute transitionEffect of type OutputTransitionEffect which describes how the QualitativeSpecies referenced by the Output is affected by the Transition.
String	toString()
boolean	unsetOutputLevel()
boolean	unsetQualitativeSpecies()
boolean	unsetTransitionEffect()
Map<String,String>	writeXMLAttributes()

Methods inherited from class org.sbml.jsbml.AbstractNamedSBase

getId, getName, isSetId, isSetName, isValidId, setId, setName, unsetId, unsetName

Methods inherited from class org.sbml.jsbml.AbstractSBase

addCVTerm, addDeclaredNamespace, addExtension, addPlugin, appendAnnotation, appendAnnotation, appendNotes, appendNotes, checkAndSetPackageNamespaceAndVersion, checkAndSetPackageNamespaceAndVersion, checkLevelAndVersionCompatibility, createHistory, createPlugin, disablePackage, enablePackage, enablePackage, filterCVTerms, filterCVTerms, filterCVTerms, filterCVTerms, fireNodeRemovedEvent, firePropertyChange, getAllowsChildren, getAnnotation, getAnnotationString, getChildAt, getChildCount, getCVTerm, getCVTermCount, getCVTerms, getDeclaredNamespaces, getElementName, getExtension, getExtensionCount, getExtensionPackages, getHistory, getIdManager, getLevel, getLevelAndVersion, getMetaId, getModel, getNamespace, getNotes, getNotesString, getNumCVTerms, getNumPlugins, getPackageName, getPackageVersion, getParent, getParentSBMLObject, getPlugin, getSBMLDocument, getSBOTerm, getSBOTermID, getURI, getVersion, hasValidAnnotation, hasValidLevelVersionNamespaceCombination, isExtendedByOtherPackages, isPackageEnabled, isPackageURIEnabled, isPkgEnabled, isPkgURIEnabled, isSetAnnotation, isSetHistory, isSetLevel, isSetLevelAndVersion, isSetMetaId, isSetNotes, isSetPackageVErsion, isSetParentSBMLObject, isSetPlugin, isSetSBOTerm, isSetVersion, isValidLevelAndVersionCombination, isValidMetaId, notifyChildChange, registerChild, removeCVTerm, removeCVTerm, setAnnotation, setAnnotation, setAnnotation, setHistory, setLevel, setMetaId, setNamespace, setNotes, setNotes, setPackageVersion, setParentSBML, setParentSBMLObject, setSBOTerm, setSBOTerm, setThisAsParentSBMLObject, setVersion, unregisterChild, unsetAnnotation, unsetCVTerms, unsetExtension, unsetHistory, unsetMetaId, unsetNamespace, unsetNotes, unsetPlugin, unsetSBOTerm

Methods inherited from class org.sbml.jsbml.AbstractTreeNode

addAllChangeListeners, addAllChangeListeners, addTreeNodeChangeListener, addTreeNodeChangeListener, children, clearUserObjects, containsUserObjectKey, filter, filter, filter, fireNodeAddedEvent, getIndex, getListOfTreeNodeChangeListeners, getNumChildren, getRoot, getTreeNodeChangeListenerCount, getUserObject, indexOf, isLeaf, isRoot, isSetParent, isSetUserObjects, putUserObject, removeAllTreeNodeChangeListeners, removeAllTreeNodeChangeListeners, removeFromParent, removeTreeNodeChangeListener, removeTreeNodeChangeListener, removeUserObject, setParent, userObjectKeySet

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.sbml.jsbml.NamedSBase

getId, getName, isSetId, isSetName, setId, setName, unsetId, unsetName

Methods inherited from interface org.sbml.jsbml.SBase

addCVTerm, addDeclaredNamespace, addExtension, addPlugin, appendAnnotation, appendAnnotation, appendNotes, appendNotes, createPlugin, disablePackage, enablePackage, enablePackage, filterCVTerms, filterCVTerms, filterCVTerms, filterCVTerms, getAnnotation, getAnnotationString, getCVTerm, getCVTermCount, getCVTerms, getDeclaredNamespaces, getElementName, getExtension, getExtensionCount, getExtensionPackages, getHistory, getLevel, getLevelAndVersion, getMetaId, getModel, getNamespace, getNotes, getNotesString, getNumCVTerms, getNumPlugins, getPackageName, getPackageVersion, getParentSBMLObject, getPlugin, getSBMLDocument, getSBOTerm, getSBOTermID, getURI, getVersion, hasValidAnnotation, hasValidLevelVersionNamespaceCombination, isExtendedByOtherPackages, isPackageEnabled, isPackageURIEnabled, isPkgEnabled, isPkgURIEnabled, isSetAnnotation, isSetHistory, isSetLevel, isSetLevelAndVersion, isSetMetaId, isSetNotes, isSetPackageVErsion, isSetParentSBMLObject, isSetPlugin, isSetSBOTerm, isSetVersion, registerChild, removeCVTerm, removeCVTerm, removeTreeNodeChangeListener, setAnnotation, setAnnotation, setAnnotation, setHistory, setLevel, setMetaId, setNotes, setNotes, setPackageVersion, setSBOTerm, setSBOTerm, setThisAsParentSBMLObject, setVersion, unregisterChild, unsetAnnotation, unsetCVTerms, unsetExtension, unsetHistory, unsetMetaId, unsetNotes, unsetPlugin, unsetSBOTerm

Methods inherited from interface org.sbml.jsbml.util.TreeNodeWithChangeSupport

addAllChangeListeners, addAllChangeListeners, addTreeNodeChangeListener, addTreeNodeChangeListener, clearUserObjects, containsUserObjectKey, filter, filter, filter, fireNodeAddedEvent, fireNodeRemovedEvent, firePropertyChange, getListOfTreeNodeChangeListeners, getRoot, getTreeNodeChangeListenerCount, getUserObject, isRoot, isSetParent, isSetUserObjects, putUserObject, removeAllTreeNodeChangeListeners, removeAllTreeNodeChangeListeners, removeFromParent, removeTreeNodeChangeListener, removeUserObject, userObjectKeySet

Methods inherited from interface javax.swing.tree.TreeNode

children, getAllowsChildren, getChildAt, getChildCount, getIndex, getParent, isLeaf

Constructor Detail

Output

public Output()

Output

public Output(String id)

Parameters:

id -

Output

public Output(QualitativeSpecies qualitativeSpecies,
              OutputTransitionEffect transitionEffect)

Parameters:

qualitativeSpecies -

transitionEffect -

Output

public Output(String id,
              QualitativeSpecies qualitativeSpecies,
              OutputTransitionEffect transitionEffect)

Parameters:

id -

qualitativeSpecies -

transitionEffect -

Output

public Output(int level,
              int version)

Parameters:

level -

version -

Output

public Output(String id,
              int level,
              int version)

Parameters:

id -

level -

version -

Output

public Output(String id,
              String name,
              int level,
              int version)

Parameters:

id -

name -

level -

version -

Output

public Output(Output out)

Parameters:

out -

Method Detail

initDefaults

public void initDefaults()

clone

public Output clone()

Specified by:

clone in interface org.sbml.jsbml.SBase

Overrides:

clone in class org.sbml.jsbml.AbstractSBase

isIdMandatory

public boolean isIdMandatory()

Specified by:

isIdMandatory in interface org.sbml.jsbml.NamedSBase

isQualitativeSpeciesMandatory

public boolean isQualitativeSpeciesMandatory()

Returns:

true

isSetQualitativeSpecies

public boolean isSetQualitativeSpecies()

Returns:

getQualitativeSpecies

public String getQualitativeSpecies()

Returns the qualitativeSpecies

Returns:

the qualitativeSpecies

Throws:

org.sbml.jsbml.PropertyUndefinedError - if isSetQualitativeSpecies() return false.

setQualitativeSpecies

public void setQualitativeSpecies(String qualitativeSpecies)

The required attribute qualitativeSpecies is used to identify the QualitativeSpecies that is the output of this Transition. The attribute's value must be the identifier of an existing QualitativeSpecies object in the Model. This attribute is comparable with the species attribute on the SpeciesReference element.

Parameters:

qualitativeSpecies - the qualitativeSpecies to set

unsetQualitativeSpecies

public boolean unsetQualitativeSpecies()

Returns:

isTransitionEffectMandatory

public boolean isTransitionEffectMandatory()

Returns:

false

isSetTransitionEffect

public boolean isSetTransitionEffect()

Returns:

getTransitionEffect

public OutputTransitionEffect getTransitionEffect()

Returns the transitionEffect

Returns:

the transitionEffect

Throws:

org.sbml.jsbml.PropertyUndefinedError - if isSetTransitionEffect() return false.

setTransitionEffect

public void setTransitionEffect(OutputTransitionEffect transitionEffect)

Each Output has a required attribute transitionEffect of type OutputTransitionEffect which describes how the QualitativeSpecies referenced by the Output is affected by the Transition. In logical models the transitionEffect is set to "assignmentLevel" whilst in standard Petri nets it is set to "production". It is envisioned that to encode High Level Petri nets it will be necessary to allow the use of "assignmentLevel" as an OutputTransitionEffect; however considering the implications of this is left to future versions of the specification.

Parameters:

transitionEffect - the transitionEffect to set

unsetTransitionEffect

public boolean unsetTransitionEffect()

Returns:

isOutputLevelMandatory

public boolean isOutputLevelMandatory()

Returns:

false

isSetOutputLevel

public boolean isSetOutputLevel()

Returns:

getOutputLevel

public int getOutputLevel()

Returns the outputLevel.

Returns:

the outputLevel

Throws:

org.sbml.jsbml.PropertyUndefinedError - if isSetOutputLevel() return false.

setOutputLevel

public void setOutputLevel(int level)

The outputLevel is a non-negative integer used along with the transitionEffect to specify the effect of the Transition on the corresponding QualitativeSpecies. It does not specify the result of a Transition; this is done by using the resultLevel attribute on a FunctionTerm. However, in Petri nets, it relates to the weight of the arc connecting the Transition to the output place and may be multiplied by the resultLevel in a "production" situation. In logical models there is no interpretation of the outputLevel attribute as the outcome of a Transition is always an assignment to the resultLevel defined by the FunctionTerm. The outputLevel attribute is optional since if the transitionEffect is set to "assignmentLevel" (as in logical models), it has no meaning. However, where the transitionEffect of the Output is set to "production" (as in Petri net models) the resulting level of the QualitativeSpecies is the resultLevel from the appropriate FunctionTerm multiplied by the outputLevel. Since there are no default values in SBML Level 3, when the transitionEffect is set to "production" the outputLevel attribute must have a value.

Parameters:

level - the level to set

unsetOutputLevel

public boolean unsetOutputLevel()

Returns:

equals

public boolean equals(Object object)

Specified by:

equals in interface org.sbml.jsbml.SBase

Overrides:

equals in class org.sbml.jsbml.AbstractNamedSBase

hashCode

public int hashCode()

Specified by:

hashCode in interface org.sbml.jsbml.SBase

Overrides:

hashCode in class org.sbml.jsbml.AbstractNamedSBase

readAttribute

public boolean readAttribute(String attributeName,
                             String prefix,
                             String value)

Specified by:

readAttribute in interface org.sbml.jsbml.SBase

Overrides:

readAttribute in class org.sbml.jsbml.AbstractNamedSBase

writeXMLAttributes

public Map<String,String> writeXMLAttributes()

Specified by:

writeXMLAttributes in interface org.sbml.jsbml.SBase

Overrides:

writeXMLAttributes in class org.sbml.jsbml.AbstractNamedSBase

containsUndeclaredUnits

public boolean containsUndeclaredUnits()

Specified by:

containsUndeclaredUnits in interface org.sbml.jsbml.SBaseWithDerivedUnit

getDerivedUnitDefinition

public org.sbml.jsbml.UnitDefinition getDerivedUnitDefinition()

Specified by:

getDerivedUnitDefinition in interface org.sbml.jsbml.SBaseWithDerivedUnit

getDerivedUnits

public String getDerivedUnits()

Specified by:

getDerivedUnits in interface org.sbml.jsbml.SBaseWithDerivedUnit

toString

public String toString()

Overrides:

toString in class org.sbml.jsbml.AbstractNamedSBase