MathTrace
A 2D math trace.
Example
app = pf.GetApplication() app:NewProject() app:OpenFile(FEKO_HOME..[[/shared/Resources/Automation/startup.fek]]) -- Create a graph with a trace graph = app.CartesianGraphs:Add() farFieldTrace = graph.Traces:Add(app.Models[1].Configurations[1].FarFields[1]) -- Add a math trace that performs some calculation mathTrace = graph:AddMathTrace() mathTrace.Expression = string.format("%s * 1.5", farFieldTrace.Label) graph:ZoomToExtents()
Inheritance
The MathTrace object is derived from the ResultTrace object.
Usage locations
The MathTrace object can be accessed from the following locations:
- Methods
- PolarGraph object has method AddMathTrace().
- CartesianGraph object has method AddMathTrace().
Property List
- Axes
- The trace axes properties. (Read only TraceAxes)
- AxisNames
- The names of all the axes on the ResultPlot. (Read only List of string)
- CommonRangeEnabled
- Specifies whether the range is limited to the range common to all traces used in the expression. (Read/Write boolean)
- DataSource
- The source of the trace. (Read/Write ResultData)
- Expression
- The math expression used to calculate this trace, e.g. “ramp(0,1,100)”. (Read/Write string)
- IndependentAxesAvailable
- The list of available independent axes. (Read only List of string)
- IndependentAxis
- The independent axis of the plot to be displayed, e.g., Frequency, X, Y, Z, etc. (Read/Write string)
- Label
- The object label. (Read/Write string)
- Legend
- The trace legend properties. (Read only TraceLegendFormat)
- Line
- The trace line format properties. (Read only TraceLineFormat)
- Markers
- The trace marker format properties. (Read only TraceMarkersFormat)
- Sampling
- The continuous trace sampling settings. These settings only apply to traces when the independent axis is continuously sampled. (Read only TraceSamplingFormat)
- Type
- The object type string. (Read only string)
- Values
- The values that are plotted on the graph for this trace. The first column represents the independent axis and the second column represents the scalar quantity being displayed on the graph. Each row represents a sampled coordinate pair. (Read only Matrix)
- Visible
- Specifies whether the trace must be shown or hidden. (Read/Write boolean)
Method List
- Delete ()
- Delete the trace.
- Duplicate ()
- Duplicate the trace. (Returns a ResultTrace object.)
- GetProperties ()
- Returns a table of properties representing the state of the object. The properties table can be used with the SetProperties method to change multiple properties of the object in one step. (Returns a table object.)
- Lower ()
- Lower the trace.
- Raise ()
- Raise the trace.
- SetProperties (properties table)
- Modifies the state of the object using the provided table of properties. This method is used to modify multiple properties of the object in a single step.
Property Details
- Axes
- The trace axes properties.
- Type
- TraceAxes
- Access
- Read only
- AxisNames
- The names of all the axes on the ResultPlot.
- Access
- Read only
- CommonRangeEnabled
- Specifies whether the range is limited to the range common to all traces used in the expression.
- Type
- boolean
- Access
- Read/Write
- DataSource
- The source of the trace.
- Type
- ResultData
- Access
- Read/Write
- Expression
- The math expression used to calculate this trace, e.g. “ramp(0,1,100)”.
- Type
- string
- Access
- Read/Write
- IndependentAxesAvailable
- The list of available independent axes.
- Access
- Read only
- IndependentAxis
- The independent axis of the plot to be displayed, e.g., Frequency, X, Y, Z, etc.
- Type
- string
- Access
- Read/Write
- Label
- The object label.
- Type
- string
- Access
- Read/Write
- Legend
- The trace legend properties.
- Type
- TraceLegendFormat
- Access
- Read only
- Line
- The trace line format properties.
- Type
- TraceLineFormat
- Access
- Read only
- Markers
- The trace marker format properties.
- Type
- TraceMarkersFormat
- Access
- Read only
- Sampling
- The continuous trace sampling settings. These settings only apply to traces when the independent axis is continuously sampled.
- Type
- TraceSamplingFormat
- Access
- Read only
- Type
- The object type string.
- Type
- string
- Access
- Read only
- Values
- The values that are plotted on the graph for this trace. The first column represents the independent axis and the second column represents the scalar quantity being displayed on the graph. Each row represents a sampled coordinate pair.
- Type
- Matrix
- Access
- Read only
- Visible
- Specifies whether the trace must be shown or hidden.
- Type
- boolean
- Access
- Read/Write
Method Details
- Delete ()
- Delete the trace.
- Duplicate ()
- Duplicate the trace.
- Return
- ResultTrace
- The duplicated trace.
- GetProperties ()
- Returns a table of properties representing the state of the object. The properties table can be used with the SetProperties method to change multiple properties of the object in one step.
- Return
- table
- A properties table.
- Lower ()
- Lower the trace.
- Raise ()
- Raise the trace.
- SetProperties (properties table)
- Modifies the state of the object using the provided table of properties. This method is used to modify multiple properties of the object in a single step.
- Input Parameters
- properties(table)
- A table of properties defining the new state of the object.