# NearFieldOptimisationGoal

A near field optimisation goal.

## Example

application = cf.Application.GetInstance()
nearField = project.Contents.SolutionConfigurations[1].NearFields[1]

-- 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

-- 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:

## Property List

CoordinateSystem
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
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

CoordinateSystem
Sets the coordinate system.
Type
Access
DirectionalComponent
Sets the directional component.
Type
OptimisationNearFieldDirectComponentEnum
Access
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
FocusSourceLabel
Set the source focus label. The intended usage is for when the source is defined only in EDITFEKO.
Type
string
Access
FocusType
Sets the focus type.
Type
OptimisationNearFieldFocusTypeEnum
Access
GoalOperator
The goal operator indicates the desired relationship between the goal focus and the objective.
Type
OptimisationGoalOperatorEnum
Access
Label
The object label.
Type
string
Access
Objective
The objective describes a state that the optimisation process should attempt to achieve.
Type
OptimisationGoalObjective
Access
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
Type
The object type string.
Type
string
Access
Weight
Specify the optimisation weight.
Type
ParametricExpression
Access

## 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.