NAME mask - Create a two dimensional maskpattern. SYNOPSIS * mask * mask -p [options] config esizex esizey eosizex eosizey mskfile The program can be started with no arguments at all, in which case the parameter values are taken from the parameterfile. Alternatively, values can be passed via the commandline, the required items as command arguments, the optional ones as valued switches. The table lists all the parameters used by mask, the second column lists the paramater key names used in the parameterfile, the first column gives the corresponding switch letter. iros parameters switch key value IO description config string i mask pattern configuration string, syntax esizex real i mask element length, x axis. esizey real i mask element length, y axis. eosizex real i length of transparent part of open mask element, x axis. eosizey real i length of transparent part of open mask element, y axis. mskfile string o mask pattern file .msk p debug int i only as first commandline argument: ignore parameterfile, set debuglevel. general i title string i file title, description cq. comments. general L logfile string i redirect diagnostic and informational messages. see general mode "ql" i has meaning for (some) parameterfile parsers/readers only. DESCRIPTION mask creates a 2-dimensional pattern of transparent (1) and opaque (0) elements. class prN pseudorandom pattern, overall transparancy is N %. N can be either 25, 33 or 50 (integral N). rN random pattern, overall transparancy is N % (real N). tN test pattern (integral N) N= 1 -> all elements opaque (0). N= 2 -> all elements transparent (1). N= 3 -> elements alternating, checker board pattern. N= 4 -> horizontal, centered line of transparent elements. N= 5 -> vertical, centered line of transparent elements. N= 6 -> centered cross of transparent elements. N= 7 -> one transparent element in center. size gives the number of elements along the x (nx) and y (ny) axis and optional repeat factors (rx, ry) for the mask pattern. if ny is not given, it defaults to the nx value (note. cf class pr50). the repeat factors default to 1, otherwise they give a repetition of the basic nx*ny patterns into an array of (rx.nx) by (ry.ny) elements. fold folding method to 2 dimensions, either linear or diagonal. code either simple or repeated. shift shift array before folding to 2D. mirror mirror 2D pattern. rotate rotate 2D pattern. EXAMPLE mask -p "pr33,[256,256],my" 1.0 1.0 wfc.msk produces a file 'wfc.msk', with the mask pattern as used in the SAX-WFC camera's. mask -p "pr50,[255,257],shift 18456,diag" 1.0 1.0 comis.msk produces a file 'comis.msk', with the mask pattern as used in the TTM/COMIS-WFC camera. mask -p "r23.4,[200,200],mi x,ro 90" 1.0 1.0 ran.msk produces a file 'ran.msk', a random pattern, overall tranparancy aproximately. 23.4 %, pattern is mirrored in the X-axis, then rotated through 90 deg. ---------------------------------------------------------------------------- mask pattern configuration string syntax term expansion config ::= class "," size [","fold] [","code] [","shift] [","mirror] [","rotate] class ::= "pr25" | "pr33" | "pr50"["("int")"] | "r"real["("int")"] | "t"int size ::= "[" int[,int[,int[,int]]] "]" fold ::= ("diagonal" | "linear") code ::= ("simple" | "repeated") shift ::= "shift" int mirror ::= "mirror" ("x"|"y"|"xy") rotate ::= "rotate" 0|1|2|3 NOTE SEE ALSO