From b89aa976ad1190c9b56f39f21d448e697bbfb755 Mon Sep 17 00:00:00 2001
From: watts <benjamin.watts@psi.ch>
Date: Tue, 4 Oct 2022 18:50:54 +0200
Subject: [PATCH] Update Zone Plate section of PixelatorControllerSettings

---
 PixelatorControllerSettings.md | 47 ++++++++++++++++++++--------------
 1 file changed, 28 insertions(+), 19 deletions(-)

diff --git a/PixelatorControllerSettings.md b/PixelatorControllerSettings.md
index 55e4631..784abc4 100644
--- a/PixelatorControllerSettings.md
+++ b/PixelatorControllerSettings.md
@@ -451,12 +451,15 @@ This file contains the zone plate and OSA settings.
 &emsp;Double value defines distance between the secondary source (i.e. exit slits) and the OSA. This is used for optical geometry calculations to position the zone plate correctly.
 
 **OSAs**::<BR>
-&emsp;JSON list
-
-**zonePlates**::<BR>
-&emsp;
+&emsp;JSON array of structures describing the set of OSA objects to be made available to select between. Each structure contains the following fields:
+* "diameter" : JSON structure with fields:
+   * "unit" : String defining the physical unit
+   * "value" : Double value defining the diameter of the OSA aperture
+* "name" : String label
 
+Further name-value pairs included in the structure will be included in the _/entry*/instrument/order_selecting_aperture/_ section of the NeXus data file.
 
+Example:
 ```json
   "OSAs" : [
       {
@@ -466,13 +469,6 @@ This file contains the zone plate and OSA settings.
          },
          "name" : "OSA 50"
       },
-      {
-         "diameter" : {
-            "unit" : "μm",
-            "value" : 60.0
-         },
-         "name" : "OSA 60"
-      },
       {
          "diameter" : {
             "unit" : "μm",
@@ -480,15 +476,26 @@ This file contains the zone plate and OSA settings.
          },
          "name" : "OSA 70"
       }
-   ],
-   "activeOSA" : "OSA 50",
-   "activeZonePlate" : "ZonePlate B",
-   "autoFocusDeadBand" : 0.5,
-   "dOsa" : 298.0,
-   "distance_exitSlit_OSA" : 1005000,
+   ]
+```
+
+**zonePlates**::<BR>
+&emsp;JSON array of structures describing the set of OSA objects to be made available to select between. Each structure must contain the following mandatory fields:
+* "name" : String label
+* "b" : array of floats defining coefficients of a polynomial that describe the energy dependent focal length of the zone plate (assuming infinite source distance). The first value is the constant of the polynomial and the next is the coefficient of of the energy, then the coefficient of the energy squared, etc. The length of the array is not limited, though a linear function (i.e. only the second value of "b" is non-zero) is typically sufficient.
+* "outer_diameter" : diameter of the outer edge of the zone plate
+* "outermost_zone_width" : width of the zone at the outer edge of the zone plate
+* "central_stop_diameter" : JSON structure with fields:
+   * "unit" : String defining units
+   * "value" : Double value defining diameter of the central stop
+* "zone_material" : String label describing the material that the zone walls are made of
+
+Further name-value pairs included in the structure will be included in the _/entry*/instrument/zone_plate/_ section of the NeXus data file.
+
+Example:
+```json
    "zonePlates" : [
       {
-         "NXgeometry" : "\"Engineering\" position of the fresnel zone plate",
          "b" : [ 0, 6.8750 ],
          "central_stop_diameter" : {
             "unit" : "μm",
@@ -513,5 +520,7 @@ This file contains the zone plate and OSA settings.
          "support_membrane_thickness" : 300,
          "zone_height" : 200,
          "zone_material" : "Pt",
-         "zone_support_material" : "air ;)"
+         "zone_support_material" : "none"
+      }
+   ]
 ```
\ No newline at end of file