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.

1. A far field request is a object and since there may be multiple objects in the model, it is part of the FarFieldCollection.
2. Search for FarFieldCollection in the Help¹.
3. 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)

4. Fill in the $\theta$ and $\varphi$ values and increments:

   Add(0, 0, 90, 360, 5, 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)2

      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)

6. Add a reference to the newly created far field request:

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

7. Set the far field request label to Source1:

   myFarField.Label = "FarField1"

   Tip: View the FarField (object) in the Help for a short example.