Technical Issues - FSPlot Tutorial III  - Annotations

FSPlot graphs include spectral data, legends, and annotations. Annotations include lines, text and other graphics elements independent of spectral data. Annotations are stored with DESIGN Graph Axes (*.axw) or FILM Archive files (*.faw) as well as MEASURE (Scantraq) Method files (*.scw).


Click on an FSPlot graph to bring up the Annotator. Edit coordinates if required. For example, if you click on a graph and get 636.4 nm you can change it to HeNe wavelength 632.8 before clicking Add. Alternatively you can return to the annotation and adjust later.


 


Short lines are Type = Line Segment

As shown above there are a number of annotation Types. What happens if you need to adjust thickness, text, color or position? Use the mouse to locate the annotation to be changed. When the cursor changes to a pointing finger, a click activates the Annotator again, but now Type is disabled and there are Replace and Delete buttons instead of the Add button (only Delete for rectangles).

FSPlot Annotator issues were resolved in DESIGN 2.61.3107 and MEASURE/Scantraq 2.51.1355 (19 Nov 2012). Please upgrade before modifying annotations with the Annotator.

Annotations might include lines marking various reflectance specifications over a wavelength range or denoting a bandpass filter envelope. Click here for an example built into FilmStar MEASURE. Such static annotations do not require further explanation and are well-handled with the Annotator.


Annotations can also be dynamic, i.e. computed from spectral data. While this useful and powerful capability requires a deeper understanding, the task is greatly simplified by the BASIC code generator in DESIGN and MEASURE. To start, open FILM Archive fnum.faw. This design is utilized for cone-angle calculations as well as computed annotations and is included in the FilmStar installation.

Run BASIC program c:\Winfilm\Basic32\BandwidthPlot.bas. to obtain the graph shown below.

Click Setup.. Annotations.. Edit <Ctrl+T> to view the annotations explained below.

Annotation
VERS3

vline 1639.999,9,|b  1640.00 nm,16711680;0

hline 96.703,9,|l96.70%,16711680;0
graph 1633.688,48.352,87,,16711680;0
graph 1646.31,48.352,45,,16711680;1
graph 1646.81,47.652,0,12.62 nm,16711680;2
Type
Header - do not remove
Vertical Line - 1640 nm
Horizontal Line - 96.70%
Line Segment
 
Text & Symbol - 12.62 nm

How to set this up? 1. Use the Annotator to draw required elements. 2. Click Setup.. Annotations.. Create BASIC Code and paste into the BASIC editor. 3. Replace appropriate numbers with functions in your BASIC code. See this page for further discussion on the same example.


Finally we return to the first graph showing all annotation types. Open FILM Archive fnum.faw or adjust axes range in Graph Axes. Highlight the left column (starting with line VERS3), copy to the clipboard, and paste into the Annotation Editor dialog.

Annotation
VERS3
graph 1625.05,86.3,8,Text & Symbol,215;0
hline 71.5,9,|lHorizontal Line,8421376;0
xaxis 1625,X Axis Label,8421376;0
yaxis 50.0,Y Axis Label,8421376;0
graph 1623,63,110,,16711935;1
graph 1644.67,63,45,,;2
graph 1631.26,26.7,43,,16711680;3
graph 1643.92,52.5,45,,;4
vline 1648,9,|b Vertical Line,255;0
graph 1651.51,59.6,46,,;5
graph 1657.74,27.4,47,,;6
graph ,,54,,16711935;7
Type
Header - do not remove
Text & Symbol

Horizontal Line

X Axis Label
Y Axis Label
Line Segment - Magenta
 
Line Segment - Blue
 
Vertical Line
Rectangle

 

Here's the graph again:

You can now practice modifying the graph with the Annotator.