Deprecated API


Contents
Deprecated Interfaces
ptolemy.actor.TokenGotListener
          Use IOPortEventListener instead. 
ptolemy.actor.TokenSentListener
          Use IOPortEventListener instead. 
 

Deprecated Classes
ptolemy.vergil.toolbox.AnnotationEditorFactory
          Use ptolemy.vergil.kernel.attributes.TextAttribute. 
diva.gui.ApplicationResources
          Use diva.resource.DefaultBundle instead. 
ptolemy.domains.fsm.modal.Case
          Use ptolemy.actor.lib.hoc.Case instead. 
ptolemy.domains.modal.modal.Case
          Use ptolemy.actor.lib.hoc.Case instead. 
ptolemy.domains.ddf.lib.DDFOrderedMerge
          Use OrderedMerge, which now supports DDF. 
ptolemy.domains.continuous.lib.DiscreteClock
          Use ptolemy.actor.lib.DiscreteClock instead. 
ptolemy.vergil.kernel.attributes.DocumentationAttribute
          DocumentationAttribute provides no UI way to edit the URL, one must edit the MoML file by hand. Use ptolemy.vergil.basic.DocAttribute or ptolemy.vergil.pdfrenderer.PDFRenderer instead of using DocumentationAttribute. 
ptolemy.backtrack.automatic.ptolemy.actor.lib.DoubleReader
          Use ExpressionReader instead. 
ptolemy.actor.lib.DoubleReader
          Use ExpressionReader instead. 
ptolemy.domains.sdf.lib.DoubleToMatrix
          Use SequenceToMatrix instead. 
ptolemy.domains.continuous.lib.EventSource
          Use with period set to Infinity 
ptolemy.kernel.attributes.FileAttribute
          Use FileParameter instead. 
ptolemy.actor.lib.FileWriter
          This actor is deprecated. Use ExpressionWriter instead. 
ptolemy.actor.util.FuzzyDoubleComparator
          As Ptolemy II 4.1, use GeneralComparator instead. 
ptolemy.moml.ImportAttribute
          The 'import' MoML element is deprecated, use the 'source' attribute instead. 
ptolemy.actor.lib.MathFunction
          This breaks the class mechanism. Generally, it is awkward to have the ports of an actor depend on parameter values. Use UnaryMathFunction instead. 
ptolemy.domains.sdf.lib.MatrixToDouble
          Use MatrixToSequence instead. 
ptolemy.actor.lib.MaxIndex
          Use Maximum instead. 
ptolemy.gui.MessageHandler
          Use ptolemy.util.MessageHandler. 
ptolemy.domains.modal.kernel.ModalDirector
          Use FSMDirector 
ptolemy.actor.gui.MoMLSimpleApplication
          Use MoMLSimpleApplication instead. MoMLSimpleApplication does not depend on anything in actor.gui 
ptolemy.actor.gui.MoMLSimpleApplication
          Use MoMLSimpleApplication instead. MoMLSimpleApplication does not depend on anything in actor.gui 
ptolemy.domains.de.lib.NonInterruptibleTimer
          Use ptolemy.actor.lib.ResettableTimer. 
diva.canvas.toolbox.PathFigure
          BasicFigure now does everything this class used to do. 
ptolemy.actor.gui.PortConfigurer
          This class is no longer used. Use PortConfigurerDialog. 
ptolemy.actor.gui.PortConfigurer
          This class is no longer used. Use PortConfigurerDialog. 
ptolemy.vergil.kernel.PortDialogFactory
          Use PortDialogAction. 
ptolemy.actor.lib.Reader
          Use ExpressionReader instead. 
ptolemy.actor.lib.hoc.RealTimeComposite
          Use ThreadedComposite instead 
ptolemy.vergil.kernel.RenameDialogFactory
          Use RenameDialogAction instead. 
ptolemy.domains.sdf.kernel.SDFIOPort
          It is preferable to declare the rate parameters directly in the actors, instead of using this class. This allows the dependence of rates to be understood by various SDF schedulers. 
ptolemy.backtrack.automatic.ptolemy.actor.lib.SequentialClock
          Use Clock instead. 
ptolemy.actor.lib.SequentialClock
          Use Clock instead. 
ptolemy.codegen.kernel.StaticSchedulingCodeGenerator
          This class is not needed, but is here for backward compatibility. 
ptolemy.domains.de.lib.Timer
          Use VariableDelay instead, which is essentially identical, or ResettableTimer for a more reasonable timer behavior. 
ptolemy.actor.TokenGotEvent
          Use IOPortEvent instead. 
ptolemy.actor.TokenSentEvent
          Use IOPortEvent instead. 
ptolemy.kernel.util.TransientSingletonConfigurableAttribute
          Use SingletonConfigurableAttribute instead with setPersistent(false). 
ptolemy.domains.sr.lib.Undefined
          This actor does not work. It returns false in prefire(), but that is interpreted by the director to mean that all outputs are absent. 
ptolemy.actor.lib.URLDirectoryReader
          Use DirectoryListing instead. 
ptolemy.actor.lib.VariableClock
          Use Clock instead. 
ptolemy.domains.de.lib.Wire
          Use Sampler instead. 
 

Deprecated Exceptions
ptolemy.gui.CancelException
          Use ptolemy.util.CancelException. 
ptolemy.domains.ct.kernel.NumericalNonconvergeException
          As Ptolemy II 4.1, this class is not used any more. 
 

Deprecated Fields
ptolemy.actor.IOPortEvent.SEND
          Use SEND_BEGIN or SEND_END instead. 
ptolemy.vergil.basic.BasicGraphFrame.VERGIL_USER_LIBRARY_NAME
          Use UserActorLibrary.USER_LIBRARY_NAME 
 

Deprecated Methods
ptolemy.actor.gui.PtolemyApplet._createRunControls(int)
          Use the control applet parameter. 
ptolemy.actor.gui.PtolemyApplet._createRunControls(int)
          Use the control applet parameter. 
ptolemy.kernel.ComponentPort._deepConnectedPorts(LinkedList)
          Use _deepConnectedPortList() instead. 
ptolemy.kernel.ComponentPort._deepInsidePorts(LinkedList)
          Use _deepInsidePortList() instead. 
ptolemy.gui.BasicJApplet._getBackground()
          Use the public method getBackground() instead. 
ptolemy.vergil.actor.IOPortController._getCardinality(Port)
          Use public getCardinality() method instead 
ptolemy.vergil.actor.IOPortController._getDirection(int)
          Use public getDirection() method instead 
ptolemy.actor.Manager._notifyListenersOfCompletion()
          Incomplete name, use Manager._notifyListenersOfSuccessfulCompletion() 
ptolemy.actor.gui.ConfigurationApplication._readConfiguration(URL)
          Use readConfiguration() instead. 
ptolemy.actor.gui.ConfigurationApplication._readConfiguration(URL)
          Use readConfiguration() instead. 
ptolemy.plot.PlotBox._setButtonsVisibility(boolean)
            
ptolemy.plot.Plot._writeOldSyntax(PrintWriter)
            
ptolemy.plot.PlotBox._writeOldSyntax(PrintWriter)
            
diva.gui.tutorial.AbstractApplication.addMenuItem(JMenu, Action, int, String)
          Use method in GUIUtilities instead. 
diva.gui.tutorial.AbstractApplication.addMenuItem(JMenu, String, Action, int, String, boolean)
          Use method in GUIUtilities instead. 
diva.gui.tutorial.AbstractApplication.addToolBarButton(JToolBar, Action, String, Icon)
          Use method in GUIUtilities instead. 
diva.gui.tutorial.AbstractApplication.addToolBarButton(JToolBar, Action, String, Icon, boolean)
          Use method in GUIUtilities instead. 
ptolemy.gui.Query.booleanValue(String)
          Use getBooleanValue(String name) instead. 
diva.canvas.CanvasUtilities.clone(Shape)
          Use ShapeUtilities.cloneShape() instead 
ptolemy.kernel.Port.connectedPorts()
          Use connectedPortList() instead. 
ptolemy.kernel.Entity.connectedPorts()
          Use connectedPortList() instead. 
ptolemy.data.MatrixToken.create(Token[], int, int)
          Use arrayToMatrix() instead. 
ptolemy.data.MatrixToken.createTokenSequence(Token, Token, int)
          Use createSequence() instead. 
ptolemy.math.SignalProcessing.decibel(double)
          Use toDecibels() instead. 
ptolemy.math.SignalProcessing.decibel(double[])
          Use toDecibels() instead. 
ptolemy.actor.IOPort.deepConnectedInPorts()
          Use deepConnectedInPortList() instead. 
ptolemy.actor.IOPort.deepConnectedOutPorts()
          Use deepConnectedInPortList() instead. 
ptolemy.kernel.ComponentPort.deepConnectedPorts()
          Use deepConnectedPortList() instead. 
ptolemy.kernel.CompositeEntity.deepGetEntities()
          Use deepEntityList() instead. 
ptolemy.kernel.ComponentPort.deepInsidePorts()
          Use deepInsidePortList() instead. 
ptolemy.kernel.ComponentRelation.deepLinkedPorts()
          Use deepLinkedPortList() instead. 
ptolemy.kernel.util.Workspace.directory()
          Use directoryList() instead. 
ptolemy.gui.Query.doubleValue(String)
          Use getDoubleValue(String name) instead. 
ptolemy.kernel.util.NamedList.elements()
          Use elementList() instead. 
ptolemy.actor.QueueReceiver.elements()
          Used elementList() instead. 
ptolemy.actor.util.TotallyOrderedSet.elements()
          Use elementList() instead. 
ptolemy.actor.util.FIFOQueue.elements()
          Used elementList() instead. 
ptolemy.data.expr.ASTPtRootNode.evaluateParseTree()
          Use a ParseTreeEvaluator instead. 
ptolemy.actor.Director.fireAt(Actor, double)
          Instead of using double as time argument, use a time object instead. As of Ptolemy 4.1, replaced by Director.fireAt(Actor, Time) 
ptolemy.kernel.util.NamedObj.getAttributes()
          Use attributeList() instead. 
ptolemy.data.expr.SimpleCharStream.getColumn()
            
ptolemy.moml.unit.SimpleCharStream.getColumn()
            
ptolemy.domains.gr.kernel.GRDirector.getCurrentTime()
          As of Ptolemy II 4.1, replaced by GRDirector.getModelTime() 
ptolemy.actor.AbstractReceiver.getCurrentTime()
          As of Ptolemy II 4.1, replaced by AbstractReceiver.getModelTime() 
ptolemy.actor.Director.getCurrentTime()
          As of Ptolemy II 4.1, replaced by Director.getModelTime() 
ptolemy.domains.dde.kernel.TimeKeeper.getCurrentTime()
          As of Ptolemy II 4.1, replaced by TimeKeeper.getModelTime() 
ptolemy.domains.dde.kernel.DDEDirector.getCurrentTime()
          As of Ptolemy II 4.1, replaced by DDEDirector.getModelTime() 
ptolemy.domains.dt.kernel.DTReceiver.getCurrentTime()
          As of Ptolemy II 4.1, replaced by DTReceiver.getModelTime() 
ptolemy.actor.IOPort.getCurrentTime(int)
          As Ptolemy II 4.1, replaced by IOPort.getModelTime(int). 
ptolemy.plot.PlotBox.getDataurl()
            
ptolemy.moml.MoMLChangeRequest.getDeferredToParent(NamedObj)
          No longer needed; just use the specified object as a context. 
ptolemy.math.FixPoint.Error.getDescription()
          This functionality is obsolete. 
ptolemy.plot.PlotBox.getDocumentBase()
            
ptolemy.kernel.CompositeEntity.getEntities()
          Use entityList() instead. 
ptolemy.math.FixPoint.getError()
          Overflow and rounding status no longer form part of the functionality. Use an overflow and rounding mode that gives the required behaviour or use Overflow.TRAP and/or Rounding.UNNECESSARY to throw exceptions if external interaction is required. 
diva.gui.DefaultStoragePolicy.getFileChooser()
          Use getOpenFileChooser() or getSaveFileChooser() 
diva.canvas.connector.AbstractConnectorTarget.getHeadSite(Site, double, double)
          Use getHeadSite that takes a connector. 
diva.canvas.connector.ConnectorTarget.getHeadSite(Site, double, double)
          Use getHeadSite that takes a connector. 
ptolemy.domains.dde.kernel.PrioritizedTimedQueue.getLastTime()
          Only used for testing purposes 
ptolemy.data.expr.SimpleCharStream.getLine()
            
ptolemy.moml.unit.SimpleCharStream.getLine()
            
ptolemy.plot.Plot.getMaxDataSets()
            
ptolemy.math.Quantization.getModuloUnscaledValue()
          ? 
ptolemy.actor.Director.getNextIterationTime()
          As of Ptolemy II 4.1, replaced by Director.getModelNextIterationTime() 
ptolemy.kernel.Entity.getPorts()
          Use portList() instead. 
ptolemy.data.expr.UtilityFunctions.getProperty(String)
          Use StringUtilities.getProperty(String) instead 
ptolemy.backtrack.automatic.ptolemy.actor.lib.Recorder.getRecord(int)
          This method is deprecated. Use getHistory(). 
ptolemy.actor.lib.Recorder.getRecord(int)
          This method is deprecated. Use getHistory(). 
ptolemy.kernel.CompositeEntity.getRelations()
          Use relationList() instead. 
ptolemy.domains.de.kernel.DEDirector.getStartTime()
          As Ptolemy II 4.1, use DEDirector.getModelStartTime() instead. 
ptolemy.actor.Director.getStartTime()
          As of Ptolemy II 4.1, replaced by Director.getModelStartTime() 
ptolemy.backtrack.automatic.ptolemy.actor.lib.PoissonClock.getStopTime()
          As of Ptolemy II 4.1, replaced by{ 
ptolemy.actor.lib.PoissonClock.getStopTime()
          As of Ptolemy II 4.1, replaced by PoissonClock.getModelStopTime() 
ptolemy.actor.lib.TimedSource.getStopTime()
          As of Ptolemy II 4.1, replaced by TimedSource.getModelStopTime() 
ptolemy.domains.de.kernel.DEDirector.getStopTime()
          As Ptolemy II 4.1, use DEDirector.getModelStopTime() instead. 
ptolemy.actor.Director.getStopTime()
          As of Ptolemy II 4.1, replaced by Director.getModelStopTime() 
diva.canvas.connector.AbstractConnectorTarget.getTailSite(Figure, double, double)
          Use getTailSite that takes a connector. 
diva.canvas.connector.AbstractConnectorTarget.getTailSite(Site, double, double)
          Use getTailSite that takes a connector. 
diva.canvas.connector.ConnectorTarget.getTailSite(Site, double, double)
          Use getTailSite that takes a connector. 
ptolemy.backtrack.automatic.ptolemy.actor.lib.Recorder.getTimeRecord()
          This method is deprecated. Use getTimeHistory(). 
ptolemy.actor.lib.Recorder.getTimeRecord()
          This method is deprecated. Use getTimeHistory(). 
ptolemy.data.expr.PtParser.getUndefinedList(String)
          Use a visitor with a ParseTreeFreeVariableCollector instead. 
ptolemy.actor.QueueReceiver.historyElementList()
          Used historyElementList() instead. 
ptolemy.actor.QueueReceiver.historyElements()
          Used historyElementList() instead. 
ptolemy.actor.util.FIFOQueue.historyElements()
          Use historyElementList() instead. 
ptolemy.plot.PlotBox.init()
            
ptolemy.kernel.ComponentPort.insidePorts()
          Use insidePortList() instead. 
ptolemy.gui.Query.intValue(String)
          Use getIntValue(String name) instead. 
ptolemy.actor.gui.JNLPUtilities.jarURLEntryResource(String)
          Use ptolemy.util.ClassUtilities#jarURLEntryResource(String) 
ptolemy.actor.gui.JNLPUtilities.jarURLEntryResource(String)
          Use ptolemy.util.ClassUtilities#jarURLEntryResource(String) 
ptolemy.actor.IORelation.linkedDestinationPorts()
          Use linkedDestinationPortList() instead. 
ptolemy.actor.IORelation.linkedDestinationPorts(IOPort)
          Use linkDestinationPortList(IOPort) instead. 
ptolemy.kernel.Relation.linkedPorts()
          Use linkedPortList() instead. 
ptolemy.kernel.Relation.linkedPorts(Port)
          Use linkedPortList(Port) instead. 
ptolemy.kernel.Entity.linkedRelations()
          Use linkedRelationList() instead. 
ptolemy.actor.IORelation.linkedSourcePorts()
          Use linkedSourcePortList() instead. 
ptolemy.actor.IORelation.linkedSourcePorts(IOPort)
          Use linkedSourcePortList(IOPort) instead. 
diva.graph.GraphUtilities.localEdges(Object, GraphModel)
          use totallyContainedEdges instead. 
ptolemy.copernicus.kernel.GeneratorAttribute.lookupClassAsResource(String)
          Call ptolemy.util.ClassUtilities.lookupClassAsResource() instead; 
ptolemy.vergil.kernel.VergilUtilities.macOSLookAndFeel()
          Use PtGUIUtilities.macOSLookAndFeel(). 
ptolemy.plot.PlotLive.makeButtons()
            
ptolemy.copernicus.kernel.Copernicus.newMap(NamedObj)
          See CodeGeneratorUtilities.newMap(NamedObj) 
ptolemy.kernel.CompositeEntity.numEntities()
          Use numberOfEntities 
ptolemy.kernel.CompositeEntity.numRelations()
          Use numberOfRelations. 
ptolemy.copernicus.kernel.Copernicus.openAsFileOrURL(String)
          See CodeGeneratorUtilities.openAsFileOrURL(String) 
ptolemy.vergil.VergilApplication.openLibrary(Configuration, File)
          Use UserActorLibrary.openLibrary(Configuration, File) 
ptolemy.moml.MoMLParser.parse(URL, InputStream)
          Use MoMLParser.parse(URL base, String systemID, InputStream input) for better error messages that include the name of the file being read. 
ptolemy.moml.MoMLParser.parse(URL, Reader)
          Use MoMLParser.parse(URL base, String systemID, Reader reader) for better error messages that include the name of the file being read. 
ptolemy.plot.PlotBox.parseFile(String)
            
ptolemy.plot.Plot.parseFile(String, URL)
            
ptolemy.plot.PlotBox.parseFile(String, URL)
          This method is deprecated. Use read() instead. 
ptolemy.actor.AtomicActor.pruneDependencies()
          There is no need to override this method anymore. Just call removeDependency() in preinitialize(). 
diva.gui.DefaultActions.quitAction(Application)
          The standard windows term is "Exit," so use exitAction() 
ptolemy.data.expr.UtilityFunctions.readMatrix(String)
          Use eval(readFile()) instead. 
ptolemy.data.expr.Variable.reset()
          This capability may be removed to simplify this class. It is not currently used in Ptolemy II, as of version 2.0. 
ptolemy.vergil.basic.BasicGraphFrame.saveComponentInLibrary(Configuration, Entity)
          Use UserActorLibrary.saveComponentInLibrary(Configuration, Entity) 
ptolemy.actor.Director.setCurrentTime(double)
          As of Ptolemy 4.1, replaced by Director.setModelTime(ptolemy.actor.util.Time) 
ptolemy.plot.PlotBox.setDataurl(String)
            
ptolemy.actor.gui.ModelPane.setDisplayPane(Container)
          It is no longer necessary to specify a display pane. The displays are handled by setModel(). 
ptolemy.actor.gui.ModelPane.setDisplayPane(Container)
          It is no longer necessary to specify a display pane. The displays are handled by setModel(). 
ptolemy.plot.PlotBox.setDocumentBase(URL)
            
ptolemy.plot.Plot.setNumSets(int)
            
diva.canvas.interactor.SelectionInteractor.setSelectionManipulator(Manipulator)
          Use setPrototypeDecorator instead 
ptolemy.data.ScalarToken.setUnitCategory(int)
          We need a better way of manufacturing the tokens for base units, since this method violates the immutability of tokens. 
ptolemy.actor.Manager.shortDescription(Throwable)
          Instead ptolemy.util.MessageHandler.shortDescription() 
ptolemy.data.expr.Variable.stringRepresentation()
            
ptolemy.util.StringUtilities.stringToURL(String, URI, ClassLoader)
          Use FileUtilities.nameToURL instead. 
ptolemy.gui.Query.stringValue(String)
          Use getStringValue(String name) instead. 
ptolemy.copernicus.kernel.Copernicus.substitute(BufferedReader, Map, String)
          See CodeGeneratorUtilities.substitute(BufferedReader, Map, String) 
ptolemy.copernicus.kernel.Copernicus.substitute(String, Map)
          See CodeGeneratorUtilities.substitute(String, Map) 
ptolemy.copernicus.kernel.Copernicus.substitute(String, Map, String)
          See CodeGeneratorUtilities.substitute(String, Map, String) 
ptolemy.copernicus.kernel.Copernicus.substitute(String, NamedObj)
          See CodeGeneratorUtilities.substitute(String, NamedObj) 
ptolemy.actor.util.TotallyOrderedSet.take()
          Use removeFirst() instead. 
ptolemy.actor.Manager.terminate()
            
ptolemy.actor.IOPort.transferInputs()
          Domains should use sendInside directly to implement their transferInputs method. 
ptolemy.actor.IOPort.transferOutputs()
          domains should use getInside directly to implement their transferOutputs method. 
diva.canvas.CanvasUtilities.transform(RectangularShape, AffineTransform)
          Use diva.util.java2d.ShapeUtilities.transformRectangle() or diva.util.java2d.ShapeUtilities.transformRectangularShape() 
diva.canvas.CanvasUtilities.transform(Shape, AffineTransform)
          Use ShapeUtilities.transformModify() 
diva.canvas.CanvasUtilities.transformInto(Point2D, TransformContext, TransformContext)
          Use local.getTransform(root) instead. 
diva.canvas.CanvasUtilities.translate(Shape, double, double)
          Use ShapeUtilities.translateModify() 
ptolemy.math.Quantizer.truncate(BigDecimal, Precision)
          Use roundToZero instead. 
ptolemy.math.Quantizer.truncate(double, Precision)
          Use roundToZero instead. 
ptolemy.math.Quantizer.truncate(FixPoint, Precision, Overflow)
          Use roundToZero instead. 
ptolemy.actor.TypedIOPort.typeConstraintList()
          Use typeConstraints(). 
ptolemy.actor.TypedCompositeActor.typeConstraintList()
          Use typeConstraints(). 
ptolemy.actor.TypedAtomicActor.typeConstraintList()
          Use typeConstraints(). 
ptolemy.data.expr.Variable.typeConstraintList()
          Use typeConstraints(). 
diva.util.xml.XmlWriter.write(XmlElement, Writer, String)
          Use XmlElement.writeXML instead. 
ptolemy.plot.PlotBox.writeOldSyntax(OutputStream)
            
ptolemy.data.expr.UtilityFunctions.zeroMatrix(int, int)
          Use zeroMatrixDouble instead. 
 

Deprecated Constructors
com.jgoodies.forms.builder.AbstractFormBuilder(Container, FormLayout)
          Replaced by AbstractFormBuilder.AbstractFormBuilder(FormLayout, Container). 
diva.canvas.toolbox.BasicFigure(Shape, int)
          Use the float constructor instead. 
ptolemy.actor.process.Branch(BranchController)
          Use this constructor for testing purposes only. 
ptolemy.math.Complex()
          Use Complex.ZERO instead. 
ptolemy.domains.csp.lib.CSPBuffer()
          Use ptolemy.domains.csp.lib.Buffer instead. 
ptolemy.kernel.DecoratedAttributesImplementation(NamedObj, String)
            
com.jgoodies.forms.builder.DefaultFormBuilder(JPanel, FormLayout)
          Replaced by DefaultFormBuilder.DefaultFormBuilder(FormLayout, JPanel). 
com.jgoodies.forms.builder.DefaultFormBuilder(JPanel, FormLayout, ResourceBundle)
          Replaced by DefaultFormBuilder.DefaultFormBuilder(FormLayout, ResourceBundle, JPanel). 
com.jgoodies.forms.builder.I15dPanelBuilder(JPanel, FormLayout, ResourceBundle)
          Replaced by I15dPanelBuilder.I15dPanelBuilder(FormLayout, ResourceBundle, JPanel). 
ptolemy.kernel.util.InvalidStateException(Enumeration, String)
          Use InvalidStateException(Collection, String) instead. 
ptolemy.actor.sched.NotSchedulableException(Enumeration, String)
          Use NotSchedulableException(Collection, Throwable, String) instead. 
com.jgoodies.forms.builder.PanelBuilder(JPanel, FormLayout)
          Replaced by PanelBuilder.PanelBuilder(FormLayout, JPanel). 
diva.canvas.toolbox.PathFigure(Shape, int)
          Use the float constructor instead.