# Imaging Plotting Commands

All of the commands below are given for a given Source. The format for the commands are as follows: src\[src#,CMD].

Below are commands for a given set of Fields, Wavelengths, Polarization States, Temperatures, Configurations given a particular source:

<table><thead><tr><th width="174.66796875">Command</th><th>Description</th></tr></thead><tbody><tr><td>rx</td><td>x - Pupil coordinate in Pupil Units (un-normalized)</td></tr><tr><td>ry</td><td>y - Pupil coordinate in Pupil Units (un-normalized)</td></tr><tr><td>pkx</td><td>x - Ray slope in x direction in Image Space</td></tr><tr><td>pky</td><td>y - Ray slope in y direction in Image Space</td></tr><tr><td>px</td><td>x - Ray position at Image Surface</td></tr><tr><td>py</td><td>y - Ray position at Image Surface</td></tr><tr><td>opls</td><td>Total Optical Path length to the Exit Pupil</td></tr><tr><td>opds</td><td>Optical Path Difference to the Exit Pupil from given ray to the Field-Chief Ray</td></tr><tr><td>psf_x</td><td>x - coordinate for PSF</td></tr><tr><td>psf_y</td><td>y - coordinate for PSF</td></tr><tr><td>psf</td><td>Amplitude for PSF</td></tr><tr><td>mtf_sx</td><td>x - Spatial frequency</td></tr><tr><td>mtf_sy</td><td>y - Spatial frequency</td></tr><tr><td>mtf</td><td>Amplitude for MTF</td></tr></tbody></table>

Additionally associated constants for a given source group ( format: src\[src#,CONSTANT] )

<table><thead><tr><th width="175.21484375">Constant</th><th>Description</th></tr></thead><tbody><tr><td>centroid_x</td><td>x - coordinate for Centroid</td></tr><tr><td>centroid_y</td><td>y - coordinate for Centroid</td></tr><tr><td>chief_x</td><td>x - coordinate for Chief Ray</td></tr><tr><td>chief_y</td><td>y - coordinate for Chief Ray</td></tr><tr><td>chiefpri_x</td><td>x - coordinate for Chief Ray at primary wavelength</td></tr><tr><td>chiefpri_y</td><td>y - coordinate for Chief Ray at primary wavelength</td></tr><tr><td>opl_center</td><td>OPL of the Chief Ray to Exit Pupil</td></tr><tr><td>total_energy</td><td>Total Flux of Source Rays</td></tr><tr><td>detector_energy</td><td>Total Flux of Rays on Detector</td></tr><tr><td>strehl</td><td>Strehl ratio at Detector</td></tr><tr><td>piston</td><td>Zernike Piston Term</td></tr><tr><td>tilt</td><td>Zernike Tilt Term</td></tr><tr><td>tilt_axis_angle</td><td>Zernike Tilt Axis Angle</td></tr><tr><td>focus</td><td>Zernike focus/defocus</td></tr><tr><td>defocus</td><td>Zernike focus/defocus</td></tr><tr><td>astigmatism</td><td>Zernike Astigmatism</td></tr><tr><td>asti</td><td>Zernike Astigmatism</td></tr><tr><td>astigmatism_angle</td><td>Zernike Astigmatism Angle</td></tr><tr><td>coma</td><td>Zernike Coma</td></tr><tr><td>coma_angle</td><td>Zernike Coma Angle</td></tr><tr><td>spherical</td><td>Zernike Spherical</td></tr></tbody></table>

For Axial Color related commands for Polarization States, Temperatures, Configurations given a particular source:

<table><thead><tr><th width="175.265625">Command</th><th>Description</th></tr></thead><tbody><tr><td>axial_color_min</td><td>Minimum Focus for Axial Color</td></tr><tr><td>axial_color_avg</td><td>Average Focus for Axial Color</td></tr><tr><td>axial_color_max</td><td>Max Focus for Axial Color</td></tr><tr><td>axial_lambda</td><td>Wavelength for Axial Color</td></tr><tr><td>axial_zone</td><td>Zone for Axial Color</td></tr></tbody></table>

For our Particular Wavelengths vs Field: for a given Wavelength, Polarization States, Temperatures, Configurations given a particular source:

<table><thead><tr><th width="175.31640625">Command</th><th>Description</th></tr></thead><tbody><tr><td>lateral_x</td><td>x - coordinate for Lateral Color</td></tr><tr><td>lateral_y</td><td>y - coordinate for Lateral Color</td></tr><tr><td>lateral_field</td><td>Field Angle</td></tr><tr><td>parabasal_avg</td><td>Parabasal Ray Trace focus Average Value</td></tr><tr><td>parabasal_max</td><td>Parabasal Ray Trace focus Max Value</td></tr><tr><td>parabasal_min</td><td>Parabasal Ray Trace focus Min Value</td></tr><tr><td>rms_spot</td><td>RMS Spot size</td></tr><tr><td>rms_spot_x</td><td>RMS Spot size in x direction</td></tr><tr><td>rms_spot_y</td><td>RMS Spot size in y direction</td></tr><tr><td>geo_spot</td><td>Max Spot size</td></tr><tr><td>geo_spot_x</td><td>Max Spot size in x direction</td></tr><tr><td>geo_spot_y</td><td>Max Spot size in y direction</td></tr><tr><td>vig_frac</td><td>Fraction of Rays that are vignetted</td></tr><tr><td>nominal_cr_x</td><td>x - coordinate for Chief Ray</td></tr><tr><td>nominal_cr_y</td><td>y - coordinate for Chief Ray</td></tr><tr><td>etendue</td><td>Etendue at Image surface</td></tr><tr><td>area</td><td>Area of spot made on the Image surface</td></tr><tr><td>solid_angle</td><td>Solid angle subtended at Image surface</td></tr><tr><td>flux</td><td>Flux at the Image surface</td></tr><tr><td>costheta</td><td>cosine of Angle relative to surface normal at Image surface</td></tr><tr><td>src_etendue</td><td>Etendue at the source</td></tr><tr><td>src_area</td><td>Area at the source</td></tr><tr><td>src_solid_angle</td><td>Solid angle at the source</td></tr><tr><td>src_flux</td><td>Flux at the Source</td></tr><tr><td>src_costheta</td><td>cosine of Angle relative to surface normal at Object surface</td></tr></tbody></table>

Constants for our Particular Wavelengths vs Field:

<table><thead><tr><th width="175.30859375">Constant</th><th>Description</th></tr></thead><tbody><tr><td>linear_cr_offset</td><td>Offset position for Chief Ray position for Linear Fit</td></tr><tr><td>linear_cr_slope</td><td>Slope of parabasal Chief Ray for Linear Fit</td></tr><tr><td>linear_cr_nslope</td><td>Slope of parabasal Chief Ray passing through zero</td></tr><tr><td>min_geo</td><td>Minimum Geometric Spot Size</td></tr><tr><td>min_rms</td><td>Minimum RMS Spot Size</td></tr><tr><td>min_area</td><td>Minimum Area of Spot</td></tr><tr><td>max_flux</td><td>Maximum Flux at the Image Surface</td></tr><tr><td>min_solid_angle</td><td>Minimum Solid Angle at the Image Surface</td></tr><tr><td>min_src_area</td><td>Minimum Source Area</td></tr><tr><td>max_src_flux</td><td>Maximum Source Flux</td></tr><tr><td>min_src_solid_angle</td><td>Minimum Source Solid Angle</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kostacloud.com/kostacloud/imaging-plotting-commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.