BP) Details concerning the DESL
print command.The DESL "print" function allows the user to display, for each SIF file specified, a report of the desired variable names and data.
The display can be in either one of two styles.
The first style might be more applicable for quick data review. This style is characterized by having to specify, in addition to the "files" option and argument list, only the "names" option and argument list.
The second style is more applicable to the production of a publishable report and is characterized by having to specify, in addition to the "files" option and argument list, the "nameset" and "page" options and argument lists. This second style can be produced in a PostScript format instead of a line-printer image format.
The default "page" size is that which is currently in effect as a result of the "page" command or in effect as the default (22 lines, 80 columns).
Any names enclosed in brackets are required or are in a set of options, one of which must be specified. Any non-blinking names enclosed in brackets are optional or are in a set of options, only one of which can be specified.
In cases where the option name is one of a set each different set number is indicated by a red numeric set number superscript trailing the respectiveright bracket :
BPall)
(Command :print) Details for the all option. BPaltvars)
(Command :print) Details for the altvars option. BPat)
(Command :print) Details for the at option.at name tol (val val ...) [tcode (tnum)]..[repeat
For non-"pressure" type output, if it is desired that one or more titles are to be printed when (1) the value of some SIF variable ("name", above), which is being printed or not, changes by more than the absolute magnitude of a specified tolerance value ("tol", above) from the value the same variable had in the preceding SIF record, or when (2) the value of some SIF variable ("name", above), being printed or not, matches, within plus/minus the specified tolerance value ("tol", above) at least one of the values ("val", above) also specified, then those titles, specified via a title code ("tcode", above) and optional title number ("tnum", above), are printed just ahead of (if "tol" < 0) or after (if "tol" > 0) the SIF record which triggered the print.
The permissible title codes are the same as for the title codes allowed to be used for the "page" option : "t", "l", "c", and "r". These codes imply, respectively, that the specified or implied (= 1) title number is to be printed "as is", left justified, centered, or right justified. A code of "s" without a following value indicates that the first occurrence of the pertinent at-triggered line(s) is to be SKIPPED.
If the special code of 's' is specified, which has no applicable following value, the FIRST "at"-triggering SIF record is ignored.
Also, a special code of "f", which has no applicable following value, can be specified. This special code implies a form-feed. Since this form-feed will be made AT THE POINT OF ENCOUNTER, relative to any other title(s) being printed, care must be taken to insure that sections of titles which are intended to be printed together are, indeed, printed together and not separated by a page boundary. It is suggested that the "f" code be included in "at" argument lists (1) at the BEGINNING of the set of title code which will be triggered to be printed BEFORE the triggering record and (2) at the END of the set of title codes which will be triggered to be printed AFTER the triggering record.
Up to 20 "at" option/argument lists can be specified. For each "at", up to 20 title code and associated title number sets can be specified. If the structure of the "at" argument list includes values to be checked for a match with a SIF variable value, up to 19 values can be included.
Example : at run -.5 c 1 t 6 s c 2
BPbackward)
(Command :print) Details for the backward option. BPblankval)
(Command :print) Details for the blankval option.Example : blankval -99
BPcntld)
(Command :print) Details for the cntld option. BPcset)
(Command :print) Details for the cset option.
The item immediately following "cset" is the file sequence number in the "files" list for which the following up-to-20 conditions will be applicable.
Each file-specific 3-item condition, like its global 3-item condition counterpart, is made up of (1) a SIF variable name, (2) a 2-character logical conjunction, and (3) a second SIF variable name or a constant.
Example : cset 3 alpha gt phi mach lt 1.2
Here, the user has indicated that, along with whatever
other GLOBAL conditions may have been specified, the
pertinent DESL function, for the THIRD file specified
or implied by the "files" list, will have its application
ALSO limited to records which satisfy BOTH of the two
conditions :
All file-specific conditions are implicitly joined by
an "and" conjunction; ie, by default, all file-specific
conditions would have to be true SIMULTANEOUSLY for
the applicable record to be retained.
If one or more file-specific conditions following
the file sequence number is to be connected to other
file-specific conditions for the same file number by
an "or" conjunction, then the 2-character item "or"
must immediately follow the file number.
Example : cset 2 or alpha lt 0 alpha gt 4
Here, the user has indicated that, along with whatever
other GLOBAL conditions may have been specified, the
pertinent DESL function, for the SECOND file specified
or implied by the "files" list, will have its application
ALSO limited to records in which the value of the SIF
variable "alpha" satisfies at least ONE of the conditions :
Additionally, if the file number following the "cset"
option is negative, the absolute value of this negative
file number is used for the actual file number and the
associated "and" or "or" condition(s) are NOT used in the
traditional sense of filtering the records read but
are ONLY used to indicate when READING of the associated
file is to STOP. This ability is useful in preventing
the reading of a long file when it is known that the
data required is relatively near the beginning of the
file.
Example : cset -1 or run eq 3 alpha gt 24
Here, the user has indicated that when a record is
encountered for which either or both of the two conditions
is/are TRUE, reading of the current SIF file should end.
BPcols)
(Command :print) Details for the cols option.Example : cols 110
BPdformat)
(Command :print) Details for the dformat option.Example : dformat ?(20(3x,f12.
BPeqtol)
(Command :print) Details for the eqtol option.Example : eqtol .5
BPfiles)
(Command :print) Details for the files option.
This list of files can be implicitly extended via use of the <list argument which can appear among the specified file names. If one or more of the <list-type arguments are specified, where "list" is a currently defined file name list, the file names contained in the indicated file name list(s) will be included, at their respective point(s) of encounter, in the current file list. The referenced list(s) must have been produced by the "newfiles" and/or "newfilex" argument lists associated with one or more previously executed DESL commands. Each "list" name can be up to 15 characters long. File names can also include the {...} construct. This type specification within a file name implies that the list name given between the curly brackets ( {} ), is to be used to have each of its elements substituted in turn for the { ... }, inclusively, such that an implicit lengthening of the file list is accomplished, up to the maximum number of files allowed. Any time such a {...} usage occurs, all lists mentioned must exist; i.e., must have been previously defined in the current DESL session. Only one {...} construct can be included in a file name. Including more than one such construct will result in unpredictable results.
An example of this type of file name specification is the following :
t43r{runs}.sif
Here, the list "runs" will have its elements used, in turn, in place of the {runs} substring.
| . |
(Begin modifications on 052102)
Each file name, whether it includes the {...} or not,
can be a maximum of 256 characters long.
If a file name is more than 16 characters long it
must be enclosed in question marks (?) .
(End modifications on 052102) |
Up to 200 files can be explicitly or implicitly specified.
Example : files run16
Y :
1 ... Normal
2 ... Oblique / Italic
3 ... Bold
4 ... Bold-Oblique / Bold-Italic
The default font = Times-Roman (11).
After any string is drawn, the current font ALWAYS reverts
back to the default font.
Example : font 63
Example : format g12.5
Example : integer on
Example : justify -1
An example of such a file is the following :
*
* Example label file for test xxx
*
* item 1 = name to be translated : MUST
* match VERBATIM with name given
* specified/implied via "nameset"
*
* item 2 = resulting name translation
*
cl C$DL
beta ?$41b$11, deg?
clalfsq C$DL$L$41a$31$U2
Explanations for the use of the $-type font selectors
and subscript/superscript selectors can be found in the
"Fonts" section of this document.
Example : labfile labf1
Example : landscape off
Example : lines 44
(Begin modifications on 032506)
If it is desired that a variable name be specified that
would look to DESL as if it was a format specification, then
a substitution of a semicolon for a period can be made in
the specified name. The switch back to a period will be
made by DESL before the printing occurs.
Example Use F6;3 to have the variable F6.3 printed.
(End modifications on 032506)
To display alternate names for specified SIF variables, the
type argument list construct can be used. All names on
the left of the equal (=) sign will be displayed "as is"
(ie, no case conversion) in place of the corresponding
specified or implied SIF variable on the right side of
the equal sign. Additionally, to force a blank name to
be displayed in place of a SIF variable, name(s) on the
left side of the equal sign can be blank; ie, the construct
" ... ? ? = alpha ..." will force a blank to be displayed
in place of the SIF variable name "ALPHA". If "type" is
"postscript", then the names on the left side of the equal
sign can contain any legal PostScript character(s). See
"type" below.
Example : names Alpha = alpha
(Begin modifications on 032506)
If it is desired that a variable name be specified that
would look to DESL as if it was a format specification, then
a substitution of a semicolon for a period can be made in
the specified name. The switch back to a period will be
made by DESL before the printing occurs.
Example Use F6;3 to have the variable F6.3 printed.
(End modifications on 032506)
To display alternate names for specified SIF variables, the
type argument list construct can be used. All names on
the left of the equal (=) sign will be displayed "as is"
(ie, no case conversion) in place of the corresponding
specified or implied SIF variable on the right side of
the equal sign. Additionally, to force a blank name to
be displayed in place of a SIF variable, name(s) on the
left side of the equal sign can be blank; ie, the construct
" ... ? ? = alpha ..." will force a blank to be displayed
in place of the SIF variable name "ALPHA". If "type" is
"postscript", then the names on the left side of the equal
sign can contain any legal PostScript character(s). See
"type" below.
If the type of output is PostScript, then
tabbing can be achieved by inclusion, in the expressed or
implied new_name, of the "$^c", "$Tc", or "$Cc"
strings, where "c" represents an upper-case letter,
A to Z, implying tab settings 1 to 26, respectively. Once
set, a tab remains set and referenceable. Tabs can be set
implicitly by tab-setting strings in "titles", "nameset"
lists, or explicitly via the "tabs" option.
The "^" character indicates a tab to set. A "T" or "C"
indicates a tab to use, either left-justified or centered,
respectively. If a tab was set EXPLICITLY, the location
which was set is the location of the left edge or center
of the tab when a "T" or "C" tab-use construct is
encountered. If a tab was set implicitly via the "^"
tab-setting construct in either a "title" or list of
names after "nameset", the left edge or center,
respectively, of the associated string is used when the
"T" or "C" tab-use construct is encountered.
A substring which is used to establish a tab position
for a centered ("C") type tab extends to the next tab
definition ("T" or "C") or to the end of the string,
whichever is encountered first.
Example : nameset 3 $T2Alpha = alpha CL = cl
Example : nformat ?(20(1x ,a),3x, a8)?
Example : nocc
Example : output out1
The item immediately after "page" is the page number.
The order in which the pages are specified is not
important. However, the total number of occurrences of
"page" IS the total number of pages defined. The page
numbers associated with these "page" occurrences must
be no more than the total number of pages defined or 10,
whichever is less. Also, ALL pages, up to the total
number of pages specified, MUST be defined.
Following the page number, file sequence numbers - values
from 1 to the number of files to print - can be specified;
are optional.
Normally, if no values are specified, the page in question
is printed for EVERY file specified. However, if file
sequence numbers are specified, the page in question will
ONLY be printed for files whose sequence number
has been specified. Example : ... page 3 1 2 5 ... will
cause the third page to be printed ONLY for the first,
second, and fifth file specified.
The fields following the page number or following the
optional file sequence numbers are the codes
representing the types of lines to be displayed on the
page being defined as well as other page attributes.
Any of the following "types" of lines can be included
in such a report : "titl", allowing arbitrary text, date
and time strings, or variable values to be displayed in
an "as-is" justification; "ctitl", like "titl" except
justification of title is centered; "lftitl", like "titl"
except the applicable title is left-justified; "rtitl",
like "titl" except the applicable title is right-justified;
"blank", allowing the insertion of one or more blank
lines; "pgno", allowing the page number
to be printed at some specified horizontal position; "gap",
forcing other than default spacing between columns of
variable names/data; "space", indicating "data" horizontal
line spacing; "name", indicating the page's names from the
associated "nameset" argument list; "e", indicating which
"textfiles" text file to read in; and "data", indicating
the data values.
All line types which can be included in a report except the
"data" type line imply that only one line of text or names
will be inserted in the report. The number of "data" type
lines which will be printed is a function of the current page
length and the total lines required for printing all other
types of lines on the current page, including those implied
by the optional "at" option; "data" lines can take
whatever space is left on a page after everything else has
been accounted for.
The particular forms of the "type" codes and their optional
sub-arguments are as follows. Parenthetical type code
suffixes and following sub-argument values (#) are optional.
. (1) t(itl) (#) "#" is a title id number. (default = 1)
. (2) c(titl) (#) "#" is a title id number. (default = 1)
. (3) r(titl) (#) "#" is a title id number. (default = 1)
. (4) l(ftitl) (#) "#" is a title id number. (default = 1)
. (5) b(lank) (#) "#" is number blank lines. (default = 1)
. (6) e # "#" is a "textfiles" file sequence no.
. (7) p(gno) (#) , where "#" is a positive or negative
. number of columns. If positive,
. # = offset from left margin. If
. negative, # = offset from right
. margin. ( default = 1)
. (8) g(ap) (#) , where "#" is the minimum spacing
. between adjacent columns of values
. being displayed
. (min = 1, default = 5 )
. (9) s(pace) (#), where "#" is the desired spacing
. between successive "data" lines.
. 2 = double, etc. ( default = 1 )
. (10) n(ame) , indicates "nameset" names for this page
. are to be inserted.
. (11) d(ata) , indicates that as many lines as possible
. of the variables" values are to be
. printed at the respective relative
. position on the page.
. (12) x forces the CURRENT page to CONTINUE at
. the end of the PREVIOUS page, if space
. remains on the PHYSICAL page. Normally
. a different page causes a new physical
. page.
Example : page 1 p -3 c 4 b n b d g 2
An example of such a file is the following :
Example : pathfile pathA
Example : paths ..\ ..\Main\ sub1\
Example : pscale .75
Example : psl 90
Example : psw 160
Example : scale .5
The rules governing structure of a substitution file
are the following :
The strings to be substituted for values can
contain any valid PostScript forms, including
font changes, subscripting/sup and
tabbing.
An example of a substitution file is the following :
Example : subsfile subf1
Example : tabs A 2.3 T 1.1 R 5.444
Example : textfiles unitrec1 unitrec3
Also included in this string of characters can be up to
10 asterisk- or exclamation point-delimited constructs
of the type :
In the second case, when the title is printed on the
appropriate "page" of output,
this type of asterisk- or exclamation point-delimited
string is replaced by
a value, which is the value of the variable named within
the string. The value of each variable indicated is set
according to the position of the corresponding title
on the output page with respect to the current record
position in the SIF file being printed or, for "pressure"
type output, is set each time the title is printed; ie,
possibly once per SIF record.
If the delimiter used is an asterisk (*) and a substitution
file has been specified via "subsfile", then for each such
expressed or implied value to be printed a search through
the substitution file is made to check for exact matches
or range matches for the value of THE SIF VARIABLE
IN QUESTION or, if a specific value was given, FOR ANY
VARIABLE. If such a match is found the corresponding string
in the substitution file is made in the title in place of the
value in question. If, instead of the asterisk (*), the
exclamation point (!) is used as a delimiter no search
will be made for a string to substitute for the value in
the applicable title EVEN IF A SUBSTITUTION FILE HAS BEEN
SPECIFIED.
Only one variable is allowed per asterisk- or exclamation
point-delimited string. If that variable is not found in the
SIF file being printed, that delimited string is effectively
eliminated from the title. The values
displayed in a title are either in the current default
format or can be printed in an optionally-speci other
real format. Since the asterisk and/or exclamation point
is used in the above-mentioned context for the "title"
option/argument list, it should NOT be used for any other
purpose in a title.
Since the characters "*" and "!" are used to imply a
substitution, they MUST be specified via a backslash and
three-digit octal number if they are included in normal
text. (See the "text" option.)
If a title is being printed having been TRIGGERED BY AN
"at", then this title can contain, as its body, the word
"header" or "headers" to imply that the LATEST line of
SIF names, or headers, (via "n" at "page") should be repeated
as this title. Example : "....title 3 headers ..."
If the title contains "header(s)" as its body and is being
printed NOT having been triggered by an "at" then there
is NO SUBSTITUTION for the word "header" or "headers".
Example : title 1 ?This is a title. ?
Example : translate 2 2
Indicates that, if a "page" style output is to be
produced AND that the output is going to be written to
an ALTERNATE file, then it will be generated to be
compatible with a PostScript printer. Titles and
alternate names (via "nameset") can contain characters
which are meaningful to the DESL PostScript processor
and can effect both output character sizes and styles.
The case of ALL characters are "as entered".
There are 9 fonts which can be accessed. (See "font".)
The default font is no. 11, Times-Roman.
As a name or title string is processed from left to right
any one of these fonts can be activated by including
the font number preceded by a dollar sign ($).
All subsequent characters in the same name or title will
also be displayed in this font until it is changed again.
An example of the use of the font changing characters is :
Here, the word "wind" will be printed in Times-RomanItali font.
Since the font is changed back to the default of 11 again,
though, from the word "has" to the end of the title all
characters will be in Times-Roman font.
Some characters in each of the fonts cannot be implied by
entering their character in a name or title; ie, some
characters which a PostScript printer can print are NOT
on a keyboard. To print a character which is not on a
keyboard, a 3-digit octal number corresponding to that
character in the desired font can be entered, PRECEDED BY
AN ESCAPING BACKSLASH, \\ .
(See the
The capability to print characters at 1 superscript level
and 3 subscript levels also exists. If a character is
preceded by either $N (default), $U, $D, $L, or $B then
the size and position of that character, as well as
remaining characters in the string in question until
changed, will be affected. If a character is preceded
by either $H or $P then the position only of that
character, as well as remaining characters in the string
in question until changed, will be affected.
The following explains the effect of each of these "$"
prefixes :
An example of a title with the above type changes follows :
Again, the "$" prefixes remain in effect until the
name/title string ends or until explicitly changed again.
A format wherein, for the record(s) satisfying any
global and/or file-specific conditions in effect,
a report is issued in which EACH
NAME-VALUE pair is printed. If "checkpoint" then ONLY the
FIRST satisfying record is printed from each file. If
"checkpoints" then ALL satisfying records are printed
from each file. The current number of columns per page,
whether in effect by default, from a "page" command execution,
or temporarily as a result of having included the "cols"
print option, determines the width of a locigal page.
The width of a logical page, in turn, determines how many
name/value columns of checkpoint listings can appear per
physical page of output. Each name/data column pair
requires 29 physical page columns. A minimum of 1
name/data column pair and a maximum of 4 name/data column
pairs will be printed.
All titles defined will be printed AT THE TOP of each
checkpoint report page. Blank lines can be forces by
defining a title's body to be "blank".
Example : type checkpoint
DESL Manager at ViGYAN, Inc.
BPfont)
(Command :print) Details for the font option.
X :
1 ... Times-Roman
2 ... Helvetica
3 ... Helvetica-Narrow
4 ... Symbol (Style code = 1 ONLY!)
5 ... Courier ("Monaco") (characters "equally" spaced)
6 ... AvantGarde
7 ... Bookman
8 ... Palatino
9 ... NewCenturySchlbk
BPformat)
(Command :print) Details for the format option. BPinteger)
(Command :print) Details for the integer option. BPjustify)
(Command :print) Details for the justify option. BPlabfile)
(Command :print) Details for the labfile option.
BPland)
(Command :print) Details for the land option. BPlandscape)
(Command :print) Details for the landscape option. BPlines)
(Command :print) Details for the lines option. BPnames)
(Command :print) Details for the names option..
" new_name = old_name " ,
" new_name1 thru new_name2 = old_name " , or
" new_name = old_name1 thru old_name2 "
BPnameset)
(Command :print) Details for the nameset option..
" new_name = old_name " ,
" new_name1 thru new_name2 = old_name " , or
" new_name = old_name1 thru old_name2 "
BPnformat)
(Command :print) Details for the nformat option. BPnocc)
(Command :print) Details for the nocc option. BPnoop)
(Command :print) Details for the noop option. BPoutput)
(Command :print) Details for the output option. BPpage)
(Command :print) Details for the page option.
. type sub
. code arg discussion
BPpathfile)
(Command :print) Details for the pathfile option.
*
* Example path file for test xxx
*
* item 1 = path to be translated : MUST
* match VERBATIM with name given
* specified/implied via "paths"
*
* item 2 = resulting name translation
*
data56 ? \usr\home2\ people\test56\ ?
up ?..\?
way-up ? ..\..\..\ Temp46\?
BPpaths)
(Command :print) Details for the paths option. BPpressure)
(Command :print) Details for the pressure option. BPpscale)
(Command :print) Details for the pscale option. BPpsl)
(Command :print) Details for the psl option. BPpsw)
(Command :print) Details for the psw option. BPscale)
(Command :print) Details for the scale option. BPsubsfile)
(Command :print) Details for the subsfile option.
*
* Example substitution file for test ###
*
* item 1 = name to be match for substitution
* item 2 = either exact-match value OR
* LOWER bound of value range
* item 3 = either the UPPER bound of value range
* OR the (beginning of the) substitution
* string
* item 4 = If value range was specified, the
* (beginning of the) substitution string
* If exact match was specified, this item
* is optional and is a string continuation
* flds 5-> = Optional string continuation
*
run 2. ?Blunt body with vertical tail off?
run 3. 7. ?Blunt body, vertical tails A thru E?
CONFIG 1 ?Config 1 : Ogive with lex ?
BPtabs)
(Command :print) Details for the tabs option. BPtextfiles)
(Command :print) Details for the textfiles option. BPtitle)
(Command :print) Details for the title option.
BPtranslate)
(Command :print) Details for the translate option. BPtype)
(Command :print) Details for the type option.
(1) postscript ...
...title 1 ?The word $12wind$11 has 2 meanings.? ...
$N ... default base level, standard size
$U ... superscript level, smaller size 1
$D ... subscript level 1, smaller size 1
$L ... subscript level 2, smaller size 2
$B ... subscript level 3, smaller size 3
$H ... higher than $U , standard size
$P ... higher than $H , standard size
...title 1 ?C$DL$L $41a$11 $U12$N as a function of $41a?
(2) checkpoint(s)
30 Research Drive
Hampton, VA 23666
Voice: (757) 865-1400
Toll Free: (800) 288-3998
FAX: (757) 865-8177
© 1998 ViGYAN, Inc.
