invokeTool, with no agent and no
model charges:
Both read the same evaluator as the result view, the agent and a code object’s
study.optics() and study.plot(), so a Strehl ratio read here is the simulation’s
strehl QoI and an exported table is the one in the view. Invoking tools requires the
projects:write scope.
Read The Optics At A Point
structuredContent holds the whole result; content.text says the same in prose.
The sections:
summary:rmsWavefrontNm,rmsWavefrontWaves,strehl(from the PSF, as thestrehlQoI composes it),strehlMarechal,fwhmandee50/ee80(inlod, andmas/uradwhen the train carries its telescope constants),lineOfSight(detectorUm,magnitudeUm,skyUrad,magnitudeUrad,magnitudeMas),changeRmsNmagainst the reference.zernike: every term with itsindexin the convention, itsnollandfringeindices,n,m,nameandvalue.surfaces: per optic and per segment,dx,dy,despace(m; a segment’s despace is its piston) andtip,tilt,clock(rad) in the surface’s local frame, the figure’sfigureRmsNmand Zernike terms, andcommanded, the part the declared pose axes command.cases: every field and wavelength case with its RMS wavefront, Maréchal Strehl and line of sight.mtf:fractionof the cutoff with theradial,x,yanddiffractionLimitedcurves,cutoffCyclesPerMmand the detector’snyquistFractionwhen known.encircledEnergy:radiusLod,energy,diffractionLimited,ee50Lod,ee80Lod.coronagraph: forraw,dugandheld, the mean contrast and the contrast against separation (λ/D).wavefrontandpsf:rowsof the map (row 0 is the lowest y;nulloutside the pupil), with the grid, extent and units.
Any Display As Data And Files
structuredContent.record is the display’s data; the PNG comes back as an image part
(source.data is base64), and the CSV or JSON text in content.text. With save: true
the files are added to the project Library (or to parentId); exporting the same display
under the same name again replaces them.
A simulation offers the displays its physics can draw; asking for another answers
422 with the list it has.
The record format
Every record carriesformat: "davinci-simulation-plot/v1", a kind, a title and
details (what the display’s caption says: the case, the wavelength, the Strehl…).
line,bars,polylines:xLabel,yLabel,logX,logY,series([{name, x, y, dash?}]; bars also carrylabelsandhover),polylines({x: [[...]], y: [[...]]}for a ray fan),markerXandmarkerLabel.map:xandy(label,min,maxat the cell edges,centers),value(label,unit),rows(row 0 is the lowest y;nulloutside the data) and thedisplayrange, colour map and stretch.table:columns(key,label,unit) androwskeyed by column.