Документ взят из кэша поисковой машины. Адрес оригинального документа : http://www.stsci.edu/spst/lrpg/man_txt/cwisr.txt Дата изменения: Fri Apr 8 22:30:13 2011 Дата индексирования: Sat Mar 1 09:01:07 2014 Кодировка: Поисковые слова: reflection nebula

User Commands IFILT(1)



NAME
cwisr - Filters the available list on instruments, special
requirements, and constraint windows, and program charac-
teristics by user request.


SYNOPSIS:
cwisr [filter options]


INTRODUCTION:
PURPOSE: filter available reports by selected instrument,
special requirements, and constraint-windows characteris-
tics.

Usage: cwisr [filter options] < STDIN

Usage: STDIN | cwisr [filter options]

More than one filtering option can be specified. For exam-
ple, the following constructs are valid:

Examples:

prompt> currav | ifilt -nonic3prime -phiders=2 -nolinks

prompt> ifilt -sbc "^O" < ~lrp/current_available_list.rpt


OPTIONAL COMMAND LINE ARGUMENTS:
There are 4 "classes" of command-line arguments:

o Instrument filter requests.
o Special Requirement filter requests.
o Constraint Window filter requests.
o Program and visit-type filter requests.

"Classes" of requests refer to the different sections of
the available file formatting that are scanned, and are
reflected in the genesis of the tool's name:

cw = constraint window

i = instrument

sr = special requirement

The 4th 'class' of requests, program/visit type is an add-on
and not integral to core functionality, but works in an
available report anyway. Requests from the 4th class in
non-available reports may or may not work properly because
of unresolved formatting and output issues.



SunOS 5.10 Last change: 27 08 2005 1






User Commands IFILT(1)



Requests of more than one class can be done
in a single request, and when so, the filtering of the
different classes is logically ANDed. For example,
if an instrument filtering request and a special
requirement request are both specified, only visits
passing each of the requests are printed.



SPECIAL REQUIREMENTS:
-links, -nolinks, -timinglinks, -notiminglinks,
-orientlinks, -noorientlinks, -orients, -noorients,
-weakconstraints

or a group of special requirements enclosed within double
quotes. If the first character within the doublequotes
is a caret (^), then the search will be negated and any
visits containing any of the enclosed special
requirements will be filtered out.

prompt> cat avail_file | cwisr
"[^][.PC~
Filtering on the special requirements fields as defined
in the
available documentation:

Special Reqs Special Requirements:

P = PAR

C = CVZ

~n = PERIOD AND ZERO PHASE (n =
int(log10(argument_1*86400) + 0.5))

< = BEFORE

Bn = BETWEEN (n = int(log10((argument_2 - argu-
ment_1)*86400) + 0.5))

Gn = GROUP WITHIN (n = int(log10(argument_1) + 0.5))

Sn = SEQUENTIAL WITHIN (n = int(log10(argument_1) +
0.5))

A = AFTER

+n = AFTER BY (n = int(log10(argument_2) + 0.5))

O = ORIENT




SunOS 5.10 Last change: 27 08 2005 2






User Commands IFILT(1)



F = ORIENT FROM

R = ORIENT RANGES

= = SAME ORIENT

H = ON HOLD

h = ON HOLD FOR

U = REQ UPLINK

Q = SEQ NON-INT

a = RT ANALYSIS

e = SAVE OFFSET

E = USE OFFSET

-n = in another SUs AFTER BY (n = int(log10(argument_2)
+ 0.5))

f = in another SUs ORIENT FROM

L = part of an executing linkset



Any number of the special requirements may be specified in
a single filtering request. When so, the filter acts as
an "OR" filter--if a visit has ANY of the specified spe-
cial
requirements, the visits then pass the filter. This
contrasts with requests between different "classes" work-
ing
logically in an AND fashion.



INSTRUMENTs:
-[no]
[acs{wfc|hrc|sbc}]|nic{123}|wfpc[2]|fgs|stis{fuv|nuv|mama|ccd}|cos{nuv|fuv}|wf3{uv|ir}]|[prime|par]

Some options do not filter on the instrument and special
requirement fields and instead key on some related fields
in the available formatting. If those fields are not
present or are malformed, then the options will have
deleterious effects to the tool's behaviour, however,
they are included because they do allow superceding of
the existing filter tools.




SunOS 5.10 Last change: 27 08 2005 3






User Commands IFILT(1)



PROGRAM TYPES:
-[no][cal|gocar|gto|go|eflat|prime], -anysci

These options replace the following filters:
noeflat, anysci, prime, nogto, nocal, nogocar
and extend the filtering capability to a broader
selection. There are a number of important filters
which it does not replace:
gethiders, nospecificearthcals .


CONSTRAINT WINDOW INFORMATION:
-anyhider, -onlyfree,
-phider[s]?=, -[sS]hider[s]?=,
-hider[s]?=
-anycw=
-nocw=



HISTORICAL MOTIVATION:
"One tools to rule them all, one tool to find them;
One tool to bring them all, and in the LRP bind them."

This tool was written to replace the plethora of filters
in the lrp toolkit such as: getlinks, gettiminglinks,
getnolinks, getorientlinks, getweakconstraints, and extend
the capability of the special requirement filtering to
search for or exclude any set of desired special
requirements.

This tool is known to replace the following filters:
noacs, nofgs, nonic, nonic3, nostisprime, getsrs, nopars.
nonicprime, stismamaprime, stisccdprime, wfpcprime,
nomama, nofoc, nicprime, getweakconstraints,
gettiminglinks, getorientlinks, getnolinks, getlinks,
focprime, anywfpc, anystisccd, anystis, anynic, anymama,
anyfoc, anyfgs, anyacs, nowfpc, nostis, gethiders.

Support is also added to replace:
nogto, nocal, nogocar, noeflat, anysci, prime, anyhiders,
onlyfree, and some others. The tool extends the filtering
capability to a generic level on instruments and special
requirements by use of character classes, and atomic
instrument specification.

There is one important filter which it does not replace:
nospecificearthcals .







SunOS 5.10 Last change: 27 08 2005 4






User Commands IFILT(1)



FUNCTIONAL PARADIGM:
The tool operates on 'available format' LRP reports,
filtering visits by the user's chosen special requirement
characteristics. It operates using a bash shell wrapper
around awk which is the main filtering engine. The
wrapper and awk assume that the
'instrument-plus-special-requirement' section of the
available report are intact and contiguous, but
arbitrarily positioned within the record (i.e., not
starting at a fixed column). The tool keys on the
instrument segment for position identification and
registration. Without these two intact and contiguous,
the tool will not function properly.

There are differences between the VMS and UNIX formats:
VMS contained STIS, while UNIX does not and contains
some COS fields. The VMS special requirements section
was 'fixed-format', while the UNIX special requirements
is concatenated, 'floating-format'. The VMS special
requirements format was 1 column shorter than the UNIX
special requirements section.


BUGS AND SHORTCOMINGS:
o Tool properly aborts on unrecognized command-line
option matches, but some command-line input errors can
allow unintended matches to leak through, such as
(note the lack of separation between the SR filter and
the instrument filter requests):
prompt> cwisr -nowfpcpar"C5G"
o Filtering on STIS is coded and functional, but not
operationally tested.


EXAMPLES:
Any number of filtering options can be specified in one
command. For example, the following constructs are
valid:

prompt> cwisr "S~R" < move_it.rpt

this filters the move_it report by selecting only
the visits which contain Sequence Withins OR
Period-phase OR Orient ranges.

prompt> cat move_it.rpt | cwisr -notiminglinks

This example excludes all visits without a timing link.

prompt> cwisr "^CGRO~" < move_it.rpt

This example reports only visits which DO NOT include



SunOS 5.10 Last change: 27 08 2005 5






User Commands IFILT(1)



CVZ, Group Within, Orient range, ORIENTS, and period-
phase.

prompt> cat move_it.rpt | cwisr "C5G" -nonic3par -nohrc


prompt> cwisr -nowfc -noacspar -weakconstraints "O" <
move_it.rpt


prompt> cat move_it.rpt | cwisr -nowfpcpar "C5G"
-acsprime -nonic3par -noorientlinks


prompt> cwisr -nowfc -noacspar -weakconstraints
"^.~<+=-" < move_it.rpt




REVISION HISTORY:
Date Dev'r Version Comments
------- ----- ------- ----------------------------------

050801-5 ijej 1.0 Tool written

050819 ij 2.0 converted to bash, case handling of
SR class options.

050820 ij 2.1 solved the negation problem, simple
logic switch. MacOSX compatible
(awk ';'). I/O Error handling.

050821 ij 3.0 Both SRs and Instruments filtering
are supported, multiple command
line filter requests.

050821 ij 3.1 Support for existence of STIS added,
COS fields allowed but not enabled.

050823 ij 3.2 Add awk/nawk autodetect.

050825 ij 3.3 Added support for some
non-instrument/specrec fields
such as [no][go|gto|cal|eflat]
and anysci

050826 ij 3.4 Added anyhider and onlyfree support

050827 ij 3.5 Added full hider/free support.

07/01/31 ij 3.6 Fixed bug preventing



SunOS 5.10 Last change: 27 08 2005 6






User Commands IFILT(1)



-noacssbc, -noacswfc, -noacshrc from working.

07/07/10 ij 3.7 implement versions of
-nocw= and -anycw=

08/08/04 ij 3.8 update instrument documentation follow-
ing implementation of new instruments.


CALLS USED:
bash script which extensively uses awk and egrep


AUTHOR
I. Jordan








































SunOS 5.10 Last change: 27 08 2005 7