SourceVoltageVertex

Voltage on a vertex excitation results generated by the Feko Solver.

Example

app = pf.GetApplication()
app:NewProject()
app:OpenFile(FEKO_HOME..[[/shared/Resources/Automation/MoM_PO_Misc_Example.fek]])

    -- Get the voltage vertex source and its label, configuration and type

voltageVertexSource = app.Models[1].Configurations[1].Excitations[5]

configurationName = voltageVertexSource.Configuration
sourceLabel = voltageVertexSource.Label
sourceType = voltageVertexSource.Type

    -- Get the DataSet for the source
    
sourceDataSet = voltageVertexSource:GetDataSet()

    -- Export the data for the source
    
voltageVertexSource:ExportData([[temp_Export]], pf.Enums.FrequencyUnitEnum.GHz,
    pf.Enums.NetworkParameterTypeEnum.Impedance, pf.Enums.NetworkParameterFormatEnum.RI, 50, 2)

Inheritance

The SourceVoltageVertex object is derived from the ExcitationData object.

Property List

Configuration
The result data's solution configuration in the model. (Read only SolutionConfiguration)
DataSetAvailable
Valid result data exist. (Read only boolean)
Label
The object label. (Read/Write string)
ReferenceImpedance
The reference impedance that was used at the port for this source to calculate reference impedance and realised gain. (Read only Expression)
Type
The object type string. (Read only string)

Method List

ExportData (filename string, frequencyunit FrequencyUnitEnum, networkparametertype NetworkParameterTypeEnum, networkparameterformat NetworkParameterFormatEnum, referenceimpedance number, samples number)
Export the result S-parameter data to the specified Touchstone file.
ExportData (filename string, frequencyunit FrequencyUnitEnum, networkparametertype NetworkParameterTypeEnum, networkparameterformat NetworkParameterFormatEnum, samples number)
Export the result S-parameter data to the specified Touchstone file.
GetDataSet ()
Returns a data set containing the source values. (Returns a DataSet object.)
GetDataSet (samplePoints number)
Returns a data set containing the source values. (Returns a DataSet object.)
GetDataSet (startFrequency number, endFrequency number, samplePoints number)
Returns a data set containing the source values. (Returns a DataSet object.)
StoreData ()
Creates a local stored version of the result data. (Returns a ResultData object.)

Property Details

Configuration
The result data's solution configuration in the model.
Type
SolutionConfiguration
Access
Read only
DataSetAvailable
Valid result data exist.
Type
boolean
Access
Read only
Label
The object label.
Type
string
Access
Read/Write
ReferenceImpedance
The reference impedance that was used at the port for this source to calculate reference impedance and realised gain.
Type
Expression
Access
Read only
Type
The object type string.
Type
string
Access
Read only

Method Details

ExportData (filename string, frequencyunit FrequencyUnitEnum, networkparametertype NetworkParameterTypeEnum, networkparameterformat NetworkParameterFormatEnum, referenceimpedance number, samples number)
Export the result S-parameter data to the specified Touchstone file.
Input Parameters
filename(string)
The name of the exported data file without its extension.
frequencyunit(FrequencyUnitEnum)
The frequency unit specified by the FrequencyUnitEnum, e.g. Hz, kHz, GHz, etc.
networkparametertype(NetworkParameterTypeEnum)
The network parameter type specified by the NetworkParameterTypeEnum, e.g. Scattering, Admittance or Impedance.
networkparameterformat(NetworkParameterFormatEnum)
The network parameter format specified by the NetworkParameterFormatEnum, e.g. DB, MA or RI.
referenceimpedance(number)
Specify the reference impedance.
samples(number)
The number of samples for continuous data. This value will be ignored if the data is discrete.
Example
-- Retrieve the current application and store it in a member
app = pf.GetApplication()
-- Close the current project
app:NewProject()
-- Add the startup.fek model
app:OpenFile(FEKO_HOME..[[/shared/Resources/startup_model/startup.fek]])
-- Add two Cartesian graphs to compare the results
app.Views[1]:Close()
graph = app.CartesianGraphs:Add()
graph2 = app.CartesianGraphs:Add()

-- Get the excitation result from the collection of source results of
-- the solution configuration
excitation = app.Models[1].Configurations[1].Excitations[1]

local fileName = "temp_excitation"
-- Export the excitation data to the current working directory
excitation:ExportData(
    fileName,                          -- The name of the Touchstone file that will be generated
    pf.Enums.FrequencyUnitEnum.Hz,     -- The frequency unit the data will be exported in
    pf.Enums.NetworkParameterTypeEnum.Scattering , -- The network parameter type
    pf.Enums.NetworkParameterFormatEnum.MA,        -- The network format
    50,                                -- The reference impedance
    51)                                -- The number of samples for continuous data. 
                                       -- This value will be ignored if the data is discrete.
-- Import the excitation results from the specified Touchstone (*.s1p) file
importSet = app:ImportResults(fileName..".s1p",pf.Enums.ImportFileTypeEnum.Touchstone)

-- Compare the excitation on the Cartesian graphs, they should look the same
graph.Traces:Add(excitation)
graph2.Traces:Add(importSet.ImportedData[1])
app:TileWindows()
ExportData (filename string, frequencyunit FrequencyUnitEnum, networkparametertype NetworkParameterTypeEnum, networkparameterformat NetworkParameterFormatEnum, samples number)
Export the result S-parameter data to the specified Touchstone file.
Input Parameters
filename(string)
The name of the exported data file without its extension.
frequencyunit(FrequencyUnitEnum)
The frequency unit specified by the FrequencyUnitEnum, e.g. Hz, kHz, GHz, etc.
networkparametertype(NetworkParameterTypeEnum)
The network parameter type specified by the NetworkParameterTypeEnum, e.g. Scattering, Admittance or Impedance.
networkparameterformat(NetworkParameterFormatEnum)
The network parameter format specified by the NetworkParameterFormatEnum, e.g. DB, MA or RI.
samples(number)
The number of samples for continuous data. This value will be ignored if the data is discrete.
GetDataSet ()
Returns a data set containing the source values.
Return
DataSet
The data set containing the source values.
GetDataSet (samplePoints number)
Returns a data set containing the source values.
Input Parameters
samplePoints(number)
The number of sample points used to sample the continuous frequency axis.
Return
DataSet
The data set containing the source values.
GetDataSet (startFrequency number, endFrequency number, samplePoints number)
Returns a data set containing the source values.
Input Parameters
startFrequency(number)
The start frequency used to sample the continuous frequency axis.
endFrequency(number)
The end frequency used to sample the continuous frequency axis.
samplePoints(number)
The number of sample points used to sample the continuous frequency axis.
Return
DataSet
The data set containing the source values.
StoreData ()
Creates a local stored version of the result data.
Return
ResultData
The new stored data.