[installation] Change to nightly
This commit is contained in:
@ -27,58 +27,68 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "INVEXTR" "1" "Sep 22, 2025" "6.9.0" "SeisComP"
|
||||
.TH "INVEXTR" "1" "Oct 29, 2025" "7.0.0" "SeisComP"
|
||||
.SH NAME
|
||||
invextr \- SeisComP Documentation
|
||||
.sp
|
||||
\fBExtract channels from inventory.\fP
|
||||
\fBExtract and clean or remove streams from inventory.\fP
|
||||
.SH DESCRIPTION
|
||||
.sp
|
||||
invextr reads and modifies inventory XML provided as file or on stdin:
|
||||
.INDENT 0.0
|
||||
.IP \(bu 2
|
||||
Extract or remove networks, stations and channels based on
|
||||
Extract or remove networks, stations, sensor locations and channels based on
|
||||
.INDENT 2.0
|
||||
.IP \(bu 2
|
||||
channel IDs
|
||||
stream IDs,
|
||||
.IP \(bu 2
|
||||
geographic region
|
||||
geographic region,
|
||||
.IP \(bu 2
|
||||
time
|
||||
time.
|
||||
.UNINDENT
|
||||
.IP \(bu 2
|
||||
Clean inventories from unused objects such as data loggers, sensors or
|
||||
instrument responses.
|
||||
Clean inventories from unreferenced objects such as data loggers, sensors or
|
||||
instrument responses when extracting.
|
||||
.sp
|
||||
\fBNOTE:\fP
|
||||
.INDENT 2.0
|
||||
.INDENT 3.5
|
||||
Cleaning inventory may also be achieved by merging inventories with
|
||||
\fI\%scinv\fP\&.
|
||||
.UNINDENT
|
||||
.UNINDENT
|
||||
.UNINDENT
|
||||
.sp
|
||||
The important parameters are:
|
||||
.INDENT 0.0
|
||||
.IP \(bu 2
|
||||
Channel ID list (required)
|
||||
Stream ID list (\fB\-\-chans\fP, \fB\-\-nslc\fP). Without a stream ID,
|
||||
only unreferenced objects are removed when extracting.
|
||||
.IP \(bu 2
|
||||
Input file or stdin
|
||||
.IP \(bu 2
|
||||
Output file or stdout
|
||||
Output file (\fB\-\-output\fP) or stdout
|
||||
.IP \(bu 2
|
||||
Region bounding box (optional)
|
||||
Region bounding box (\fB\-\-region\fP, optional)
|
||||
.UNINDENT
|
||||
.sp
|
||||
whereas the output file defaults to stdout and the input file to
|
||||
where the output XML defaults to stdout and the input file to
|
||||
stdin if not given.
|
||||
.sp
|
||||
The optional region box will be used to filter the read inventory based on the
|
||||
coordinates of sensor locations. Only stations with sensor locations within the
|
||||
region will be considered. All others will be ignored.
|
||||
.sp
|
||||
A channel ID is a simple string that is matched against the final channel ID
|
||||
in the inventory. This final channel ID is constructed by joining the codes of
|
||||
A stream ID is a simple string that is matched against the final stream ID
|
||||
in the inventory. This final stream ID is constructed by joining the codes of
|
||||
all stages with a dot where the stages are network, station, location and
|
||||
channel.
|
||||
.sp
|
||||
The content of the resulting inventory may be listed using \fI\%scinv\fP\&.
|
||||
.SS Examples
|
||||
.sp
|
||||
Suppose an inventory with network GE, a station MORC and several channels:
|
||||
Suppose an inventory with network GE, a station MORC with one sensor locations
|
||||
and several channels:
|
||||
.INDENT 0.0
|
||||
.INDENT 3.5
|
||||
.sp
|
||||
@ -99,13 +109,26 @@ network GE
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.IP \(bu 2
|
||||
The IDs are matched against streams passed with \-\-chans.
|
||||
Just clean inventory from unreferenced objects such as data loggers, sensors
|
||||
or instrument responses.
|
||||
.INDENT 2.0
|
||||
.INDENT 3.5
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
invextr \-\-chans \(dqGE*\(dq inv.xml
|
||||
invextr inventory.xml \-o inventory\-cleaned.xml
|
||||
.ft P
|
||||
.fi
|
||||
.UNINDENT
|
||||
.UNINDENT
|
||||
.IP \(bu 2
|
||||
The IDs are matched against streams passed with \fB\-\-chans\fP:
|
||||
.INDENT 2.0
|
||||
.INDENT 3.5
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
invextr \-\-chans \(dqGE*\(dq inventory.xml
|
||||
.ft P
|
||||
.fi
|
||||
.UNINDENT
|
||||
@ -120,7 +143,7 @@ useful here at all.
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
invextr \-r 0,\-180,90,180 inv.xml
|
||||
invextr \-r 0,\-180,90,180 inventory.xml
|
||||
|
||||
All streams located in the northern hemisphere are passed as commanded by the
|
||||
region bounding box.
|
||||
@ -135,7 +158,7 @@ Nothing is filtered again because \fIMORC\fP matches all available IDs.
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
invextr \-\-chans \(dq*MORC*\(dq inv.xml
|
||||
invextr \-\-chans \(dq*MORC*\(dq inventory.xml
|
||||
.ft P
|
||||
.fi
|
||||
.UNINDENT
|
||||
@ -148,7 +171,7 @@ work, an asterisk needs to be appended: GE.MORC* or GE.MORC.*.
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
invextr \-\-chans \(dqGE.MORC\(dq inv.xml
|
||||
invextr \-\-chans \(dqGE.MORC\(dq inventory.xml
|
||||
.ft P
|
||||
.fi
|
||||
.UNINDENT
|
||||
@ -160,25 +183,23 @@ To extract all vertical components, use:
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
invextr \-\-chans \(dq*Z\(dq inv.xml
|
||||
invextr \-\-chans \(dq*Z\(dq inventory.xml
|
||||
.ft P
|
||||
.fi
|
||||
.UNINDENT
|
||||
.UNINDENT
|
||||
.IP \(bu 2
|
||||
To extract BHN and LHZ, use:
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.INDENT 2.0
|
||||
.INDENT 3.5
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
invextr \-\-chans \(dq*BHN,*LHZ\(dq inv.xml
|
||||
invextr \-\-chans \(dq*BHN,*LHZ\(dq inventory.xml
|
||||
.ft P
|
||||
.fi
|
||||
.UNINDENT
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.IP \(bu 2
|
||||
To remove all HH and SH channels, use:
|
||||
.INDENT 2.0
|
||||
@ -186,7 +207,7 @@ To remove all HH and SH channels, use:
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
invextr \-\-rm \-\-chans \(dq*HH?,*SH?\(dq inv.xml
|
||||
invextr \-\-rm \-\-chans \(dq*HH?,*SH?\(dq inventory.xml
|
||||
.ft P
|
||||
.fi
|
||||
.UNINDENT
|
||||
@ -319,11 +340,15 @@ that time will be ignored.
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-chans arg
|
||||
A comma separated list of channel IDs to extract
|
||||
which can contain wildcards. Default: *.*.*.* meaning
|
||||
all streams.
|
||||
A comma separated list of streams to extract or remove (\-\-rm)
|
||||
which can contain wildcards. Avoiding confusion with files
|
||||
names due to SHELL extension requires to enclose stream codes
|
||||
by quotes. Default: *.*.*.* meaning all streams. Unreferenced
|
||||
sensors, data loggers and resonses are removed when extracting.
|
||||
A comma separated list of channel IDs to extract which may
|
||||
contain wildcards. Default: *.*.*.* meaning all streams.
|
||||
.sp
|
||||
Example: invextr \-\-chans \(dqGE.*.*.BHZ,GE.MORC.*.*\(dq inv.xml
|
||||
Example: invextr \-\-chans \(dqGE.*.*.BHZ,GE.MORC.*.*\(dq inventory.xml
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
@ -335,7 +360,7 @@ Wildcards can be used. \-\-chans is ignored.
|
||||
.TP
|
||||
.B \-r, \-\-region arg
|
||||
Filter streams by geographic region given as
|
||||
\(dqSouth, East, North, West\(dq. Region is unused by default.
|
||||
\(dqSouth,West,North,East\(dq. Region is unused by default.
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
@ -345,10 +370,17 @@ extracting them.
|
||||
.sp
|
||||
Example: invextr \-\-rm \-\-chans \(dqGE.*\(dq inv.xml
|
||||
.UNINDENT
|
||||
.SS Output
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-f, \-\-formatted
|
||||
Enables formatted XML output.
|
||||
Enable formatted XML output.
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-o, \-\-output
|
||||
Name of output file. If not given or \(aq\-\(aq, output is sent to
|
||||
stdout.
|
||||
.UNINDENT
|
||||
.SH AUTHOR
|
||||
gempa GmbH, GFZ Potsdam
|
||||
|
||||
Reference in New Issue
Block a user