This is part of the HicEst documentation

Panel: Easy-Update Screen: Numeric, Text, Graphics

PaNeL is an optional keyword of HicEst's WINDOW() function. It will exactly display the template defined in the APPENDIX section of the script.

PaNeL is an optional keyword of HicEst's WINDOW() function, e.g.
- WINDOW(WINdowhandle=wh, PaNeL='test', PoinT=pt)
- Window layout is defined in a template ( APPENDIX section of the script).
- Template placeholders define the output types
- To display output variable changes, call:
  - WINDOW(WIN=wh, UPDAtepanel)
size_of_panel
is automatic:
- the window will exactly display the template from the APPENDIX section
- The font used for text output is "fixed font" and can be set as font nr 4 from the options section
initialize
: display a template as defined in the scripts APPENDIX section. This requires to
- define the variables to be displayed in the template, e.g.:
  - CHARACTER name*60, text*60
  - DIMENSION vector(10)
  - name = 'numeric and text'
  - text = 'scalar has value pi'
  - scalar = 4* ATAN(1) ! == pi
  - vector = $ ^ 0.5 ! the square roots of 1, 2, 3, ...
- template_definition
  (e.g. "Num+Text") for screen output:
  The template name must start in column 1 of the script's APPENDIX section.
- choose arbitrary placeholders for the variables, like ?, $, and @.
- placeholder=variable expressions follow the template name.
- The number following the placeholder is for strings the character position to start with. For arrays the number is the array element, for numeric scalars the number must be 0.
- The printed width is defined by the number of digits following the placeholder.
  - Num+Text ?=scalar $=vector @=text
  - text( 1:10) = 000001 scalar = ?000
  - text(11:19) = 00011
  - vector(2) = $0002, vector(5) = $0005
  - scalar = ?00000 6 chars wide
  - scalar = ?000000 7 chars wide
  - the nextchapter starts in column 1 again
- The xy-graph hides any text below it. Commands may be anywhere within the graph (no spaces allowed).
open_panel
with its initial values by a call to WINDOW with the template name
- WINDOW(WIN=wh, PaNeL="Num+Text", TItle=name, PoinT=8)
This writes an image of the template to window wh and fills the placeholders defined in template (numbers, strings and graphs). The font size determines the window size. It can be set by the PoinT option. Panel always uses a fixed font.
update_panel
with changed variables is by subsequent calls to WINDOW(WINdowhandle=wh, UPDAtepanel):
- text = 'scalar has value e'
- scalar = EXP(1)
- vector = $ ^ 2 ! the squares of 1, 2, 3, ...
- WINDOW(WIN=wh, UPDAtepanel)
mark_selected_variable
by changing its foreground and/or background color: Colors 0...31 are predefined, but 32-bit RGB() values can be used instead.
- WINDOW(WIN=wh, UPDAtepanel=variable, ForeColor=15, BaCkColor=1)

is added to a template by defining an arbitrary placeholder in the 1st line of the template (# in the example below) for every xy-system.

Options as in AXIS(...)	# stands here for any character i is integer f is float	examples
#i	i = number of xy system 1...8. Must be noted in the template definition line	#7 = xy graph number 7
##	Double placeholders mark the corners of graphs Upper left and right corners suffice for a graph to extend over the full height of the panel. Diagonal corners are needed for a partial window graph	Test #1 ## #XB79 #Xx0 #XX4 #YB96 #Yy1 #YY100 #x # #y try it # ##
#XBi (use to set foreground_colors ) and #YBi (use to set background_colors ) (see also AXIS)	i is a sum of color and scale properties: 0=black 1=blue 2=green 4=red 8=bright 16=soft 32=LoG 64=Grid 128=FixmiN 256=FixmaX 512=TiMe 1024=Scroll 2048=noAxis	WINDOW(WIN=wh, PaNeL="Test", TItle="Profile") #XB79 = 1 + 64 = blue+grid #YB96 = black + log + grid #Xx0 = Xmin=0 #Yy1 Ymin=1 #XX4 = Xmax=4 #YY100 = Ymax=100 #x abscissa text# #y ordinate text#
#Xxf	set abscissa minimum to f	#Xx0 = Xmin=0
#XXf	set abscissa maximum to f	#XX1.5 = Xmax=1.5
#Yyf	set ordinate minimum to f	#Yy-1 = Ymin=-1
#YYf	set ordinate maximum to f	#YY2 = Ymax=2
#xtext#	set abscissa text	#x #
#ytext#	set ordinate text	#y try it #

profile_graph

is added to a template by defining arbitrary placeholders for x-vector (~ in the table below) and for the y-vectors (? in the table below) in the 1st line of the template.

Options as in LINE(...)	# stands again for the xy system ~ is placeholder for x-vector ? stands for y-vector i is an integer number
~=xvec	assign xvec to ~, xvec is defined in the script and is noted in the template definition line. To plot e.g. yvec versus xvec in graph 3 the first line of this APPENDIX chapter may look like: Profile #3 ~=xvec ?=yvec
?=yvec	assign yvec to ?, yvec defined in script and noted in template definition line
#X~0	assign ~ (xvec) to abscissa of xy-system #
#Y?0	assign ? (yvec) to ordinate of xy-system #
#Y?Bi	i is the sum of properties for curve ?: 0=black, 1=blue, 2=green, 4=red, 8=bright, 16=soft, 32=STeps, 64=NoLine, 256=NoZero.
#Y?Si	i is the symbol number for curve ?: 1=square, 2=diamond, 3=octagon, 4=Xsquare, 5=+diamond, 6=+octagon, 7=triangle up, 8=triangle down, 9=arrow up, 10=arrow down, 11=/, 12=\, 13=X, 14=-, 15=l, 16=+, 17=*
#Y?Di	i is the symbol diameter for curve ?
#Y?Wi	i is the line width for curve ?

DIMENSION xvec(30), sin(30), cos(30)
xvec = ( $ - 1) / 3 ! make xvec = 0, 1/3, 2/3, ...
sin = SIN(xvec)
cos = COS(xvec)
WINDOW(PaNeL="Profile", TItle='Profile', WIN=wh)

Profile %3 ~=xvec $=sin ?=cos
xvec(3)=~0003, cos(3)=?0003
%% %XB66G3 the scales are
B66 green(2)+Xgrid(64)
G3 Xgrid 3's-steps
%YB6 dark yellow backgr(B6)
%X~0 is the x-vector
%Y$0B32D0W1 the sin-vector
B32 black(0)+ steps(32)
D0 symbol diameter 0
W1 line width 1
%Y?0B9D1S1W3 the cos-vector
B9 is bright(8)+blue(1)
D1 symbol diameter 1
S1 symbol 1 square
W2 line width 2
%xup to 32 curves/8 graphs%
~00000003 ?00000003 %%

history_graph

works like 'panel profile graph' above.

past profiles are shown with decreasing color intensity.
Useful to visualize small changes without cluttering the graph.
If the length of the y-vector is N times the length of the x-vector, a total of N history values of y-vector are plotted.
Maximum N is 255.

DIMENSION xH(30), sinH(300), cosH(300)
xH = ( $ - 1) / 3 ! make xH = 0, 1/3, 2/3, ...
WINDOW(PaNeL="History", TItle='History plot', WIN=wh)
DO i = 0, 10
sinH = SIN(xH) * i/10
cosH = COS(xH) * i/10
WINDOW(WIN=wh, UPDAtepanel)
ENDDO

History #1 %2 ~=xH $=sinH ?=cosH
## %%
#YB10 %YB2062
#X~0 %X~0
#Y$0B1D0 %Y?0B2D0
#xthe most recent#
%xcurves are darkest%
#yno y-axis for graph 2#
## %%

scrolling_axes

allow automatic updates of up to 8 graphs. Both axes can be made to scroll. Input y-data must be bundled in a vector, the x-value may be a scalar or it may an element of the data vector.

Options as in AXIS and LINE	# stands again for the xy system " is placeholder for the current x-value * stands for a vector of y-values i is an integer number
"=xvalue	assign xvalue to the placeholder ", xvalue must be defined in the script and is noted in the template definition line along with the vector of y-values (and possibly definitions of other axes, variables, and vectors to display)
*=yvector	assign yvector to the placeholder , yvector is defined in the script and noted in the template. To plot x-value sec and yvector infoVec to xy-graph 1 in chapter TimeSeries this is: TimeSeries #1 "=sec =infoVec

infoVec = ALIAS(sec, y1, y2) ! VECTOR needed at least for y-values
WINDOW(PaNeL='TimeSeries', Ti='200 msec updates', WIN=wh)
DO i = 1, 1E6 ! loop 1 million times
sec = TIME() ! seconds since midnight
y1 = SIN(sec)
y2 = COS(sec) * RAN(0.3) ! 0 <= RAN(0.3) <= 0.3 random values
WINDOW(WIN=wh, UPDAtepanel)
SYSTEM(WAIT=200) ! wait for 200 msec
ENDDO

200msec

TimeSeries #1 "=sec *=infoVec
## The AXIS options are:
#XB1088 #Xx0 #XX20
B1088=scroll(1024)+grid(64)
Xx0 = xmin(0)
XX20 xmax(20)
#xX-axis scrolls with sec#
The LINE options are:
#X"0 assigns sec to x-Axis
#Y*2W2D0 y1 is 2 wide
#Y*3W2D1B12 y2 is red
Di i = symbol diameter
##
"0000000 sec since midnight

flow_lines
add horizontal and/or vertical lines to a graph.
- Line placeholders in the same row or same column are connected by lines of color c, dash d, and width w.
- in the chapter definition line a set of lines for a placeholder * is defined by the sequence *Line=c.sw, e.g. *Line=12.09 for bright red, solid , 9 pixels wide
- It is sufficient to write L for Line.
- Placeholders are blanked out for display.
- text = 'comes handy for charts'
- WINDOW(PaNeL='Lines', Title='Lines', WIN=wh)
Lines *Line=12.29 +L=17.09 "=Text

+ +* *

"0001 "00006

+

* *

"13 "00017

* *+ +
rectangles
: add all kinds of rectangles to a graph. The syntax in the panel definition line for rectangle placeholder * is *Display:RA=color.
Rectangles +D:RA=1.05,BC=3.24,W=4,H=3 *D:RA=-1,BC=14

+        *1 a

        *2 b

      *3 c

        *4 d

          *5 e

geometrical_shapes

all use the same syntax:

*D:XY=c.sw,BC=c.sh,W=4,H=3

* is the placeholder of the shape
XY is the shape (PO, EL, or BE)
c=color
s=outline-style
w=outline-width
BC=background with c=color, s=style, h=hatch
W=outline-width
H=outline-height

polygons

x,y coordinates in the form x1,y2;x2,y2;... are scaled to width W=.. and height H=.. as noted in the definition line
for missing W and/or H the shapes extend over the full window W and/or H

Po .D:RA=4 #D:PO=0,0;1,1;0,1;W=8,H=3,BC=12,FC=0.03
.............................
.# # #
.
.
.
. # #
.
.
.

ellipses
:
Ellipses have 2 extra options to display arcs:
A1=Angle1 (0...360)
A2=Angle2, default angles are 0

for x,y see polygons
- El #D:EL=11.05,W=9,H=4,BC=17 +D:EL=9.09,A1=0,A2=180,W=8,H=5,BC=14
- # # # .
- +
- A# B# C
- D E

cubic_beziers

Cubic Beziers fit cubic curves to 4 points.
interpolation starts at P0 toward P1 and ends at P3
subsequent curves (3 points) use the end point of the previous interpolation as a start point
for x,y see polygons

PB .D:RA=0 $D:BE=0,0;0,1;1,1;1,0;W=8,H=4,FC=4.09
..................
. $ $
.
.
.