artisynth.core.probes

Class NumericMonitorProbe

java.lang.Object

artisynth.core.modelbase.ModelComponentBase

artisynth.core.modelbase.ModelAgentBase

artisynth.core.probes.Probe

artisynth.core.probes.NumericProbeBase

artisynth.core.probes.NumericDataFunctionProbe

artisynth.core.probes.NumericMonitorProbe

All Implemented Interfaces:

Displayable, CopyableComponent, HasState, ModelAgent, ModelComponent, PostScannable, java.lang.Cloneable, HasProperties, HierarchyNode, Scannable

Direct Known Subclasses:

ExactForceProbe, ExactMomentProbe, ForceErrorProbe, ForceProbe, MomentProbe

public class NumericMonitorProbe
extends NumericDataFunctionProbe

An output probe that generates data with an application-supplied generating function. Applications can supply this function by either

• Supplying a DataFunction to generate the data;
• Overriding the generateData(maspack.matrix.VectorNd, double, double) method;
• Overriding the apply(double) method.

Nested Class Summary

Nested classes/interfaces inherited from class artisynth.core.probes.Probe

Probe.ExportProps, Probe.ImportExportFileInfo

Nested classes/interfaces inherited from interface artisynth.core.modelbase.ModelComponent

ModelComponent.NavpanelVisibility

Field Summary

Fields

Modifier and Type	Field and Description
static PropertyList	myProps

Fields inherited from class artisynth.core.probes.NumericProbeBase

EXPLICIT_TIME, mySmallDisplay

Fields inherited from class artisynth.core.probes.Probe

useOldSaveMethod, writeStartStopTimeInSeconds

Fields inherited from class artisynth.core.modelbase.ModelComponentBase

enforceUniqueCompositeNames, enforceUniqueNames, myNumber, NULL_OBJ, useCompactPathNames

Fields inherited from interface artisynth.core.modelbase.CopyableComponent

COPY_REFERENCES, REST_POSITION

Constructor Summary

Constructors

Constructor and Description
NumericMonitorProbe()
NumericMonitorProbe(int vsize, double interval)
NumericMonitorProbe(int vsize, java.lang.String fileName, double startTime, double stopTime, double interval)

Method Summary

Modifier and Type	Method and Description
void	apply(double t) Called at time t to apply this probe
ModelComponent	copy(int flags, java.util.Map<ModelComponent,ModelComponent> copyMap) Create a copy of this component.
void	generateData(VectorNd vec, double t, double trel) Generates data for this probe by evaluating a vectored-valued function of time and storing the result in vec.
PropertyList	getAllPropertyInfo() Returns a list giving static information about all properties exported by this object.
boolean	getCopyReferences(java.util.List<ModelComponent> refs, ModelComponent ancestor) Collects external references which must also be copied in order to duplicate this component.
NumericList	getOutput()
boolean	getShowHeader()
boolean	getShowTime()
void	save() When called (perhaps by the Artsynth timeline), causes information about this probe to be written to its attached file.
void	scan(ReaderTokenizer rtok, java.lang.Object ref) Scans this element from a ReaderTokenizer.
boolean	scanItem(ReaderTokenizer rtok, java.util.Deque<ScanToken> tokens)
void	setAttachedFileName(java.lang.String fileName, java.lang.String fmtStr)
void	setAttachedFileName(java.lang.String fileName, java.lang.String fmtStr, boolean showTime, boolean showHeader)
void	setShowHeader(boolean enable)
void	setShowTime(boolean enable)
void	setVsize(int vsize)
void	setVsize(int vsize, PlotTraceInfo[] traceInfos)
void	write(java.io.PrintWriter pw, java.lang.String fmtStr, boolean showTime) Writes the start and stop times, scale value, and data for this probe to a PrintWriter, using the format described for NumericInputProbe.read(File).
void	writeData(java.io.PrintWriter pw, java.lang.String fmtStr, boolean showTime)
void	writeItems(java.io.PrintWriter pw, NumberFormat fmt, CompositeComponent ancestor) Write probe attributes to a PrintWriter

Methods inherited from class artisynth.core.probes.NumericDataFunctionProbe

clone, createState, getDataFunction, getInitialState, getState, hasState, isCloneable, isDuplicatable, setDataFunction, setState

Methods inherited from class artisynth.core.probes.NumericProbeBase

addData, applyDefaultDisplayRanges, clearData, createNumericList, decreaseDisplayRanges, dispose, export, getAttachedProperties, getData, getDefaultDisplayMax, getDefaultDisplayMin, getDefaultDisplayRange, getDisplay, getDrivers, getExportFileInfo, getExportProps, getFormat, getInterpolation, getInterpolationOrder, getLegend, getMatlabName, getMinMaxValues, getNumericList, getOrderedTraceIndex, getPlotTraceInfo, getRange, getRange, getTraceColor, getTraceLabel, getTraceManager, getValues, getVariables, getVsize, importData, importText, increaseDisplayRanges, isEmpty, isPrintable, isSmallDisplayVisible, isTraceVisible, isValidVariableName, isWritable, loadFromMatlab, print, read, removeDisplay, removeLegend, resetTraceColors, resetTraceOrder, saveToMatlab, scaleNumericList, setDefaultDisplayRange, setDefaultDisplayRange, setFormat, setInterpolation, setInterpolationOrder, setLegend, setLegendLabels, setScale, setSmallDisplayVisible, setTraceColor, setTraceLabel, setTraceOrder, setTraceVisible, setValues, smoothWithMovingAverage, smoothWithSavitzkyGolay, swapPlotTraceOrder, updateDisplays, updateDisplays, updateDisplaysForPropertyChanges, updateDisplaysWithoutAutoRanging, writeText

Methods inherited from class artisynth.core.probes.Probe

getAttachedFile, getAttachedFileName, getChildren, getClippedVirtualTime, getDefaultScale, getDefaultStartTime, getDefaultStopTime, getDefaultUpdateInterval, getDuration, getExportFile, getExportFileName, getFileFromPath, getImportFile, getImportFileInfo, getImportFileName, getPathFromFile, getProperty, getScale, getStartTime, getStopTime, getTimelineTime, getTrack, getUpdateInterval, getVirtualTime, hasAttachedFile, hasChildren, isAttachedFileRelative, isEventTime, isInput, isScalable, isSettable, load, nextEventTime, setAttachedFileName, setData, setExportFileName, setImportFileName, setInterval, setName, setScalable, setStartStopTimes, setStartTime, setStopTime, setTrack, setUpdateInterval

Methods inherited from class artisynth.core.modelbase.ModelAgentBase

finalize, getModel, initialize, isActive, setActive, setModel, setModelFromComponent, write

Methods inherited from class artisynth.core.modelbase.ModelComponentBase

checkFlag, checkName, checkNameUniqueness, clearFlag, connectToHierarchy, createTempFlag, disconnectFromHierarchy, getGrandParent, getHardReferences, getName, getNameRange, getNavpanelVisibility, getNavpanelVisibility, getNumber, getParent, getSoftReferences, isFixed, isMarked, isScanning, isSelected, makeValidName, makeValidName, notifyParentOfChange, postscan, printReferences, recursivelyContained, recursivelyContains, removeTempFlag, setFixed, setFlag, setMarked, setNavpanelVisibility, setNavpanelVisibility, setNumber, setParent, setScanning, setSelected, setWritable, updateReferences

Methods inherited from class java.lang.Object

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

Methods inherited from interface artisynth.core.modelbase.ModelComponent

connectToHierarchy, disconnectFromHierarchy, getHardReferences, getName, getNavpanelVisibility, getNumber, getParent, getSoftReferences, isFixed, isMarked, isSelected, notifyParentOfChange, setFixed, setMarked, setName, setNumber, setParent, setSelected, setWritable, updateReferences

Methods inherited from interface maspack.properties.HasProperties

getProperty

Methods inherited from interface maspack.properties.HierarchyNode

getChildren, hasChildren

Methods inherited from interface artisynth.core.modelbase.PostScannable

postscan

Methods inherited from interface maspack.util.Scannable

isWritable, write

Field Detail

myProps

public static PropertyList myProps

Constructor Detail

NumericMonitorProbe

public NumericMonitorProbe()

NumericMonitorProbe

public NumericMonitorProbe(int vsize,
                           double interval)

NumericMonitorProbe

public NumericMonitorProbe(int vsize,
                           java.lang.String fileName,
                           double startTime,
                           double stopTime,
                           double interval)

Method Detail

getAllPropertyInfo

public PropertyList getAllPropertyInfo()

Description copied from interface: HasProperties

Returns a list giving static information about all properties exported by this object.

Specified by:

getAllPropertyInfo in interface HasProperties

Overrides:

getAllPropertyInfo in class NumericProbeBase

Returns:

static information for all exported properties

getShowTime

public boolean getShowTime()

setShowTime

public void setShowTime(boolean enable)

getShowHeader

public boolean getShowHeader()

setShowHeader

public void setShowHeader(boolean enable)

write

public void write(java.io.PrintWriter pw,
                  java.lang.String fmtStr,
                  boolean showTime)
           throws java.io.IOException

Writes the start and stop times, scale value, and data for this probe to a PrintWriter, using the format described for NumericInputProbe.read(File). The format used for producing floating point numbers can be controlled using a printf-style format string, details of which are described in NumberFormat.

Parameters:

pw - writer which accepts the output

fmtStr - printf-style format string (if set to null then "%g" will be assumed, which will produce full precision output).

showTime - if true, then time values are written explicitly. Otherwise, an implicit step size corresponding to the value returned by getUpdateInterval will be specified.

Throws:

java.io.IOException - if an I/O error occurs.

setAttachedFileName

public void setAttachedFileName(java.lang.String fileName,
                                java.lang.String fmtStr)

setAttachedFileName

public void setAttachedFileName(java.lang.String fileName,
                                java.lang.String fmtStr,
                                boolean showTime,
                                boolean showHeader)

save

public void save()
          throws java.io.IOException

When called (perhaps by the Artsynth timeline), causes information about this probe to be written to its attached file.

Overrides:

save in class Probe

Throws:

java.io.IOException

See Also:

write(java.io.PrintWriter, java.lang.String, boolean)

writeData

public void writeData(java.io.PrintWriter pw,
                      java.lang.String fmtStr,
                      boolean showTime)

generateData

public void generateData(VectorNd vec,
                         double t,
                         double trel)

Generates data for this probe by evaluating a vectored-valued function of time and storing the result in vec. The size of vec will equal the vector size of the probe (as returned by NumericProbeBase.getVsize(). The function may generate the data using either absolute time t or relative time trel, where relative time is determined from the probe's start time and scale factor using

 trel = (t - startTime)/scale 

Parameters:

vec - returns the generated data.

t - absolute time (seconds)

trel - probe relative time

apply

public void apply(double t)

Description copied from class: Probe

Called at time t to apply this probe

Specified by:

apply in class NumericProbeBase

Parameters:

t - time at which probe is being applied

getOutput

public NumericList getOutput()

scanItem

public boolean scanItem(ReaderTokenizer rtok,
                        java.util.Deque<ScanToken> tokens)
                 throws java.io.IOException

Throws:

java.io.IOException

scan

public void scan(ReaderTokenizer rtok,
                 java.lang.Object ref)
          throws java.io.IOException

Description copied from class: ModelComponentBase

Scans this element from a ReaderTokenizer. The expected text format is assumed to be compatible with that produced by write.

Specified by:

scan in interface ModelComponent

Specified by:

scan in interface Scannable

Overrides:

scan in class Probe

Parameters:

rtok - Tokenizer from which to scan the element

ref - optional reference object which can be used for resolving references to other objects

Throws:

java.io.IOException - if an I/O or formatting error occured

writeItems

public void writeItems(java.io.PrintWriter pw,
                       NumberFormat fmt,
                       CompositeComponent ancestor)
                throws java.io.IOException

Description copied from class: Probe

Write probe attributes to a PrintWriter

Parameters:

pw - writer to which components are written

fmt - format for floating point numbers

ancestor - ancestor component which respect to which references are expressed

Throws:

java.io.IOException - if an I/O error occurred

setVsize

public void setVsize(int vsize)

setVsize

public void setVsize(int vsize,
                     PlotTraceInfo[] traceInfos)

getCopyReferences

public boolean getCopyReferences(java.util.List<ModelComponent> refs,
                                 ModelComponent ancestor)

Collects external references which must also be copied in order to duplicate this component. These references should exclude those which are contained within a specified component hierarchy. This method should return true if and only if CopyableComponent.isDuplicatable() returns true.

Parameters:

refs - list to which references are appended

ancestor - root node of the hierarchy from which references are to be excluded

Returns:

false if it is discovered that the component cannot be duplicated

copy

public ModelComponent copy(int flags,
                           java.util.Map<ModelComponent,ModelComponent> copyMap)

Description copied from interface: CopyableComponent

Create a copy of this component. If COPY_REFERENCES is set in flags, then any component referenced by this component should itself be set to a copy. This should be done first checking copyMap for an existing copy of the referenced component. If there is no existing copy, then a copy should be created by calling copy recursively and adding the new copy to copyMap.

Specified by:

copy in interface CopyableComponent

Overrides:

copy in class ModelComponentBase

Parameters:

flags - flags to control the copying

copyMap - map to possible existing instances of referenced components

Returns:

copy of this component