`SourceCoaxial`

Coaxial approximation excitation results generated by the Feko Solver.

Example

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

    -- Get the coaxial source and its label, configuration and type

coaxialSource = app.Models[1].Configurations[1].Excitations[1]

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

Inheritance

The SourceCoaxial object is derived from the ExcitationData object.

Property List

Configuration: The result data's solution configuration in the model. (Read only SolutionConfiguration)
ContinuousFrequencyAxis: Continuous frequency axis exists. (Read only boolean)
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

ContinuousFrequencyAxis

Continuous frequency axis exists.

Type: boolean
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.