NMRPipe Processing Functions
TRI: Triangle Window.
| Flag |
Argument |
Default |
Description |
-loc |
aLoc |
TSIZE/2 |
Point Loc of Apex (APOD Parameter Q1). |
-lHi |
lHi |
0.0 |
Left Edge Starting Height (APOD Parameter Q2). |
-rHi |
rHi |
0.0 |
Right Edge Starting Height (APOD Parameter Q3). |
-size |
aSize |
TSIZE |
Number of Points in Apodize Window. |
-start |
aStart |
1 |
Start Location for Applying Apodize Window. |
-c |
fScale |
1 |
Scale Factor for First Point (C1 Parameter). |
-one |
|
|
Set window points outside apodize region to 1. |
-hdr |
|
|
Use Q1,Q2,Q3,C1 Values from Header as Defaults. |
-inv |
|
|
Invert Window. |
|
TRI applies a triangle window. The window is specified in
terms of the location of the triangle apex, and the heights
of the window at the first and last points of the FID.
The window is seldom if ever used with biomolecular NMR spectra,
but might be of use for time-domain data which has its
largest amplitudes near the center, as is commonly found in
time-domain image data.
In addition to function-specific options, each of the
nmrPipe window functions provides the following features:
-
Optional scaling of the first point of each FID.
-
Automatic recording of window parameters and first point
scaling in the data header during processing.
-
Automatic adjustment of the default size of the window
function to match the valid time-domain size recorded in
the header.
-
Optional extraction and use of window parameters recorded
in the header, rather than from the command-line.
-
An inverse mode, which divides by the window function and
first point scale rather than multiplying by them.
-
Options to adjust the size or starting point of the window
function via command-line arguments.
TRI OPTIONS
-loc apexLoc
(Q1) Specifies the point location of the triangle
function's apex on the FID. The triangle function will
have a height of 1.0 at this location.
-lHi lHi
(Q2) Specifies the height of the triangle function at
the first point of the window. The window will vary
linearly from this height to 1.0 between the first
point and the apex of the window.
-rHi rHi
(Q3) Specifies the height of the triangle function at
the last point of the window. The window will vary
linearly from 1.0 to this height between the apex of
the window and the last point.
GENERIC OPTIONS
-size aSize
Specifies the number of points in the window function.
The default value is the valid time-domain size
recorded in the data header.
-start aStart
Specifies the starting point of the window function.
The default value is 1, which means the window function
starts at the first point of the FID. This option is
intended for creation of composite windows by application
of different functions to different regions of the
FID.
-c fScale
Specifies the scaling applied to the first point of the
FID, which influences the zero-order offset in the
corresponding spectrum. The default value is 1.0,
which means no first point adjustment is applied. A
value of 0.5 is usually appropriate in cases where no
substantial first-order phase correction will be
applied.
-one
This flag influences the values used "outside" the window
function, in cases where the window size is smaller
than the actual number of data points. By default,
data values outside the window region are multiplied by
zero when the window is applied. However if the -one
flag is used, data values outside the window region
will be multiplied by 1.0 when the window is applied.
This flag is intended to assist creation of composite
windows by application of different functions to different
regions of the FID.
-hdr
When this flag is used, default window parameters
(Q1,Q2, and Q3) will be extracted from the data header,
along with the first point scaling. This requires that
all of these parameters have already been recorded, for
instance during previous processing or format conversion
(see EXAMPLES below). Additional command-line can
be used to override values restored from the header.
The window parameters stored in the data header can be
viewed using the showhdr program, for example:
showhdr -verb test.ft2
-inv
When this flag is used, the inverse (1/window) of the
selected window and first point scale will be applied.
This option is intended for removing a
previously-applied window in inverse processing
schemes. This option should generally only be used on
window functions which have no values close or equal to
zero. In cases where the window does have a zero
value, the inverse window is also given as zero.
EXAMPLES
A triangle window which goes from 0.05 to 1.0 and back to 0.05,
so that it contains no zero values:
| nmrPipe -fn TRI -lHi 0.05 -rHi 0.05 \
HEADER VALUES
The nmrPipe window functions use the recorded time-domain
size (NDAPOD) to establish their default length.
When the -hdr flag is used, default window parameters are
extracted from header values NDAPODCODE, NDAPODQ1, NDAPODQ2,
and NDC1.
The header values NDAPODCODE, NDAPODQ1, NDAPODQ2,
and NDC1 are updated according to the values applied during
processing.
|