LoadCollection

A collection of loads.

Example

application = cf.Application.getInstance()
project = application:NewProject()

    -- Get the 'LoadCollection' from the 'SolutionConfiguration'

loadCollection = project.Contents.SolutionConfigurations.GlobalLoads

    --  Add a complex load to the collection.
dielectric = project.Definitions.Media.Dielectric:AddDielectric()
cube = project.Contents.Geometry:AddCuboid(cf.Point(0, 0, 0), 1, 1, 1)
cube.Regions[1].Medium = dielectric
cube.Regions[1].SolutionMethod = cf.Enums.RegionSolutionMethodEnum.FEM
femLinePort = project.Contents.Ports:AddFEMLinePortBetweenPoints(cf.Point(0,0,0) ,cf.Point(1,1,0) )
complexLoad = loadCollection:AddComplex(femLinePort,"220","0")

    --  Query the number of loads in the collection

numberOfLoads = #loadCollection

Inheritance

The LoadCollection object is derived from the Object object.

Usage locations

The LoadCollection object can be accessed from the following locations:

Property List

Label
The object label. (Read/Write string)
Type
The object type string. (Read only string)

Method List

AddComplex (portterminal Port, real Expression, imaginary Expression)
Create a load on the specified terminal with complex impedance. (Returns a Load object.)
AddLoad (properties table)
Create a load using the table of properties. (Returns a Load object.)
AddParallel (portterminal Port, resistance Expression, capacitance Expression, inductance Expression)
Create a load on the specified terminal with parallel circuit configuration. (Returns a Load object.)
AddSeries (portterminal Port, resistance Expression, capacitance Expression, inductance Expression)
Create a load on the specified terminal with series circuit configuration. (Returns a Load object.)
AddSinglePortTouchstone (portterminal Port, filename string)
Create a load on the specified terminal from data stored in a 1-port Touchstone file. (Returns a Load object.)
AddSpiceCircuit (portterminal Port, filename string)
Create a load on the specified terminal from data stored in a SPICE circuit file. (Returns a Load object.)
Delete ()
Deletes the entity.
DeleteEntities ( List of Object)
Delete the given list of entities from the collection.
Duplicate ()
Duplicates the entity. (Returns a Object 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.)
SetProperties (properties Object)
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.

Static Function List

GetDefaultProperties ()
Creates a table containing the default settings to create an object. (Returns a table object.)

Property Details

Label
The object label.
Type
string
Access
Read/Write
Type
The object type string.
Type
string
Access
Read only

Method Details

AddComplex (portterminal Port, real Expression, imaginary Expression)
Create a load on the specified terminal with complex impedance.
Input Parameters
portterminal(Port)
The terminal to create the load on.
real(Expression)
The real part of the complex impedance (Ohm).
imaginary(Expression)
The reactive part of the complex impedance (Ohm).
Return
Load
The load.
AddLoad (properties table)
Create a load using the table of properties.
Input Parameters
properties(table)
The table of properties.
Return
Load
The load.
AddParallel (portterminal Port, resistance Expression, capacitance Expression, inductance Expression)
Create a load on the specified terminal with parallel circuit configuration.
Input Parameters
portterminal(Port)
The terminal to create the load on.
resistance(Expression)
The resistive part of the parallel circuit load definition (Ohm).
capacitance(Expression)
The capacitive part of the parallel circuit load definition (F).
inductance(Expression)
The inductive part of the parallel circuit load definition (H).
Return
Load
The load source.
AddSeries (portterminal Port, resistance Expression, capacitance Expression, inductance Expression)
Create a load on the specified terminal with series circuit configuration.
Input Parameters
portterminal(Port)
The terminal to create the load on.
resistance(Expression)
The resistive part of the series circuit load definition (Ohm).
capacitance(Expression)
The capacitive part of the series circuit load definition (F).
inductance(Expression)
The inductive part of the series circuit load definition (H).
Return
Load
The load source.
AddSinglePortTouchstone (portterminal Port, filename string)
Create a load on the specified terminal from data stored in a 1-port Touchstone file.
Input Parameters
portterminal(Port)
The terminal to create the load on.
filename(string)
The Touchstone filename.
Return
Load
The load source.
AddSpiceCircuit (portterminal Port, filename string)
Create a load on the specified terminal from data stored in a SPICE circuit file.
Input Parameters
portterminal(Port)
The terminal to create the load on.
filename(string)
The SPICE circuit filename.
Return
Load
The load source.
Delete ()
Deletes the entity.
DeleteEntities ( List of Object)
Delete the given list of entities from the collection.
Input Parameters
(List of Object)
Duplicate ()
Duplicates the entity.
Return
Object
The new (duplicated) entity.
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 table defining the properties.
SetProperties (properties Object)
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(Object)
A table of properties defining the new state of the object.

Static Function Details

GetDefaultProperties ()
Creates a table containing the default settings to create an object.
Return
table
A table containing the default properties.