NearFieldOptimisationGoal
A near field optimisation goal.
Example
application = cf.Application.getInstance() project = application:Load({FEKO_HOME..[[/shared/Resources/Automation/Horn_error_estimates.cfx]]}) nearField = project.Contents.SolutionConfigurations[1].NearFields[1] search = project.Optimisation.Searches:Add(cf.Enums.OptimisationMethodTypeEnum.GridSearch) -- Create a near field optimisation goal with focus on the near field request properties = cf.NearFieldOptimisationGoal.GetDefaultProperties() properties.FocusSource = nearField properties.GoalOperator = cf.Enums.OptimisationGoalOperatorEnum.Maximise properties.ProcessingSteps[1].Operation = cf.Enums.OptimisationGoalProcessingStepsEnum.Log nearFieldGoal = search.Goals:AddNearFieldGoal(properties) -- Set the directional component in the X direction properties = nearFieldGoal:GetProperties() properties.DirectionalComponent = cf.Enums.OptimisationNearFieldDirectComponentEnum.X properties.ProcessingSteps[1].Operation = cf.Enums.OptimisationGoalProcessingStepsEnum.Real nearFieldGoal:SetProperties(properties)
Inheritance
The NearFieldOptimisationGoal object is derived from the OptimisationGoal object.
Usage locations
The NearFieldOptimisationGoal object can be accessed from the following locations:
- Methods
- OptimisationGoalCollection collection has method AddNearFieldGoal(table).
Property List
- CoordinateSystem
- Sets the coordinate system. (Read/Write OptimisationNearFieldCoordSystemEnum)
- DirectionalComponent
- Sets the directional component. (Read/Write OptimisationNearFieldDirectComponentEnum)
- FocusSource
- Set the focus source to a specified source object. The intended usage is for when the source is defined in CADFEKO. (Read/Write NearField)
- FocusSourceLabel
- Set the source focus label. The intended usage is for when the source is defined only in EDITFEKO. (Read/Write string)
- FocusType
- Sets the focus type. (Read/Write OptimisationNearFieldFocusTypeEnum)
- GoalOperator
- The goal operator indicates the desired relationship between the goal focus and the objective. (Read/Write OptimisationGoalOperatorEnum)
- Label
- The object label. (Read/Write string)
- Objective
- The objective describes a state that the optimisation process should attempt to achieve. (Read only OptimisationGoalObjective)
- ProcessingSteps
- A number of conversion steps or mathematical operations to be carried out on the goal focus before the goal is evaluated. (Read/Write OptimisationGoalProcessingStepsList)
- Type
- The object type string. (Read only string)
- Weight
- Specify the optimisation weight. (Read/Write ParametricExpression)
Method List
- Delete ()
- Deletes the entity.
- 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
- Sets the coordinate system.
- Type
- OptimisationNearFieldCoordSystemEnum
- Access
- Read/Write
- DirectionalComponent
- Sets the directional component.
- Type
- OptimisationNearFieldDirectComponentEnum
- Access
- Read/Write
- FocusSource
- Set the focus source to a specified source object. The intended usage is for when the source is defined in CADFEKO.
- Type
- NearField
- Access
- Read/Write
- FocusSourceLabel
- Set the source focus label. The intended usage is for when the source is defined only in EDITFEKO.
- Type
- string
- Access
- Read/Write
- FocusType
- Sets the focus type.
- Type
- OptimisationNearFieldFocusTypeEnum
- Access
- Read/Write
- GoalOperator
- The goal operator indicates the desired relationship between the goal focus and the objective.
- Type
- OptimisationGoalOperatorEnum
- Access
- Read/Write
- Label
- The object label.
- Type
- string
- Access
- Read/Write
- Objective
- The objective describes a state that the optimisation process should attempt to achieve.
- Type
- OptimisationGoalObjective
- Access
- Read only
- ProcessingSteps
- A number of conversion steps or mathematical operations to be carried out on the goal focus before the goal is evaluated.
- Type
- OptimisationGoalProcessingStepsList
- Access
- Read/Write
- Type
- The object type string.
- Type
- string
- Access
- Read only
- Weight
- Specify the optimisation weight.
- Type
- ParametricExpression
- Access
- Read/Write
Method Details
- Delete ()
- Deletes the entity.
- 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.