Defining a Far Field Request

Create a far field request (0°≤θ≤90°, with 0°≤ϕ≤360°). Sample the far field at θ=5° and ϕ=5° steps. The far field request is added to the default configuration, StandardConfiguration1.

myFarField = myProject.Contents.SolutionConfigurations[1].FarFields:Add(0, 0, 90, 360, 5, 5)
myFarField.Label = "FarField1"

Figure 1. A far field request is added to the model.

A far field request is a object and since there may be multiple objects in the model, it is part of the FarFieldCollection.
Search for FarFieldCollection in the Help¹.
In the Help, under FarFieldCollection > Method List, search for methods that are applicable to adding a fra field request:
- Add (properties table)
- Add (starttheta Expression, startphi Expression, endtheta Expression, endphi Expression, thetaincrement Expression, phiincrement Expression)
- Add3DPattern ()
- AddHorizontalCutUVPlane ()
- AddRequestInPlaneWaveIncidentDirection ()
- AddSquareGrid ()
- AddVerticalCutUNPlane ()
- AddVerticalCutVNPlane ()
To create a far field request, we will use the method:
```
Add(starttheta Expression, startphi Expression, endtheta Expression, endphi Expression, thetaincrement Expression, phiincrement Expression)
```
Fill in the $θ$ and $ϕ$ values and increments:
```
Add(0, 0, 90, 360, 5, 5)
```
Determine the syntax to prepend to Add:
1. Since Add is a method, it is indicated by prepending a : (colon).
```
:Add(0, 0, 90, 360, 5, 5)
```
2. In the Help, under FarFieldCollection > Usage locations (collections), note that the following objects contain the FarFieldCollection collection:
```
SolutionConfigurations(.FarFields)²
```
  Since we know that Contents is one of the top levels in the configuration tree, the result is:
```
Contents.SolutionConfigurations.FarFields:Add(0, 0, 90, 360, 5, 5)
```
  But we also know that a far field request is added per configuration, the result is then:
```
Contents.SolutionConfigurations[1].FarFields:Add(0, 0, 90, 360, 5, 5)
```
3. Since the project is the highest level, we prepend our reference to the project:
```
myProject.Contents.SolutionConfigurations[1].FarFields:Add(0, 0, 90, 360, 5, 5)
```

Add a reference to the newly created far field request:

myFarField = myProject.Contents.SolutionConfigurations[1].FarFields:Add(0, 0, 90, 360, 5, 5)

Set the far field request label to Source1:
```
myFarField.Label = "FarField1"
```
Tip: View the FarField (object) in the Help for a short example.

¹ The API is available in the Feko Scripting and API Reference Guide (PDF) or Feko WebHelp.

² The part that is prepended to the method, maps to the CADFEKO model tree structure.