[installation] Change to nightly
This commit is contained in:
@ -27,7 +27,7 @@ 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 "SCRELOC" "1" "Sep 22, 2025" "6.9.0" "SeisComP"
|
||||
.TH "SCRELOC" "1" "Oct 29, 2025" "7.0.0" "SeisComP"
|
||||
.SH NAME
|
||||
screloc \- SeisComP Documentation
|
||||
.sp
|
||||
@ -151,29 +151,47 @@ NonLinLoc.profile.global.controlFile = ${NLLROOT}/NLL.global.conf
|
||||
.SH EXAMPLES
|
||||
.INDENT 0.0
|
||||
.IP \(bu 2
|
||||
Run screloc to with a specific velocity model given in a profile by \fI\%NonLinLoc\fP\&.
|
||||
Use a specific userID and authorID for uniquely recognizing the relocation.
|
||||
Changing the priority in \fI\%scevent\fP before running the example, e.g. to
|
||||
TIME_AUTOMATIC, sets the latest origin (which will be created by screloc) to preferred.
|
||||
Relocate all origins given in an \fI\%SCML\fP file according to the
|
||||
configuration of \fBscreloc\fP\&. Write all output to unformatted SCML.
|
||||
.INDENT 2.0
|
||||
.INDENT 3.5
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
# set specific velocity profile defined for NonLinLoc
|
||||
profile=<your_profile>
|
||||
# set userID
|
||||
userID=\(dq<your_user>\(dq
|
||||
# set authorID
|
||||
authorID=\(dq<screloc>\(dq
|
||||
screloc \-d localhost \-\-ep origins.xml > origins_screloc.xml
|
||||
.ft P
|
||||
.fi
|
||||
.UNINDENT
|
||||
.UNINDENT
|
||||
.IP \(bu 2
|
||||
Relocate the previously preferred origins of all events (\fI\%scevtls\fP)
|
||||
within some period of time using a specific \fI\%locator\fP
|
||||
and locator profile.
|
||||
Use some userID and authorID for uniquely recognizing the relocation.
|
||||
Configuring the ref:\fIscevent\fP parameter \fI\%eventAssociation.priorities\fP
|
||||
to TIME_AUTOMATIC before running the example will prefer the latest origin
|
||||
(which will be created by screloc) for the event the new origin is associated
|
||||
to. The new origins are automatically sent to the messaging.
|
||||
.INDENT 2.0
|
||||
.INDENT 3.5
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
#!/bin/bash
|
||||
|
||||
for i in \(gascevtls \-d mysql://sysop:sysop@localhost/seiscomp \-\-begin \(aq2015\-01\-01 00:00:00\(aq \-\-end \(aq2015\-02\-01 00:00:00\(aq\(ga; do
|
||||
|
||||
orgID=\(gaecho \(dqselect preferredOriginID from Event,PublicObject where Event._oid=PublicObject._oid and PublicObject.publicID=\(aq$i\(aq\(dq |\e
|
||||
mysql \-u sysop \-p sysop \-D seiscomp \-h localhost \-N\(ga
|
||||
|
||||
screloc \-O $orgID \-d localhost \-\-locator NonLinLoc \-\-profile $profile \-u $userID \-\-debug \-\-author=$authorID
|
||||
# locator type
|
||||
locator=[your_locator]
|
||||
# locator profile
|
||||
profile=[your_profile]
|
||||
# set some userID
|
||||
userID=[your_user]
|
||||
# set some authorID
|
||||
authorID=[screloc]
|
||||
|
||||
IFS=\(aq,\(aq read \-ra events <<< \(gascevtls \-d localhost \-p \-D , \-\-begin 2025\-01\-01 \-\-end 2025\-02\-01\(ga
|
||||
for event in \(dq${events[@]}\(dq; do
|
||||
preferredOrigin=$(echo $event | awk \(aq{print $2}\(aq)
|
||||
screloc \-d localhost \-O $preferredOrigin \-\-locator $locator \-\-profile $profile \-u $userID \-\-author=$authorID
|
||||
done
|
||||
.ft P
|
||||
.fi
|
||||
@ -293,6 +311,30 @@ helps to identify pairs of origins before and after relocation.
|
||||
However, new publicIDs are unrelated to the time of creation.
|
||||
If not defined, a new publicID will be generated automatically.
|
||||
.UNINDENT
|
||||
.sp
|
||||
\fBNOTE:\fP
|
||||
.INDENT 0.0
|
||||
.INDENT 3.5
|
||||
\fBpicks.*\fP
|
||||
\fIParameters specific to picks.\fP
|
||||
.UNINDENT
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B picks.streamsSetUnused
|
||||
Type: \fIlist:string\fP
|
||||
.sp
|
||||
List of streams from which picks are set to unsed by their
|
||||
referencing arrivals before locating. The concerned arrivals
|
||||
are kept but the picks will not be used for locating.
|
||||
Streams take the format NET.STA.LOC.CHA. Wildcards * and ?
|
||||
are supported.
|
||||
.sp
|
||||
Example:
|
||||
.sp
|
||||
GE.MOX.*.HH? : All arrivals on any HH stream of station MOX
|
||||
will be kept but not used for locating.
|
||||
.UNINDENT
|
||||
.SH COMMAND-LINE OPTIONS
|
||||
.SS Generic
|
||||
.INDENT 0.0
|
||||
@ -430,10 +472,14 @@ This option can be given more than once.
|
||||
.TP
|
||||
.B \-\-content\-type arg
|
||||
Overrides configuration parameter \fI\%connection.contentType\fP\&.
|
||||
.sp
|
||||
Default: \fBbinary\fP
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-start\-stop\-msg arg
|
||||
Default: \fB0\fP
|
||||
.sp
|
||||
Set sending of a start and a stop message.
|
||||
.UNINDENT
|
||||
.SS Database
|
||||
@ -469,37 +515,56 @@ Do not use the database at all
|
||||
.SS Mode
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-dump
|
||||
Dump processed origins as XML to stdout. Use in combination
|
||||
with \-O.
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-test
|
||||
Test mode, do not send any message
|
||||
Test mode, do not send any message.
|
||||
.UNINDENT
|
||||
.SS Input
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-O, \-\-origin\-id arg
|
||||
Reprocess the origin and send a message unless test mode is activated
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-locator arg
|
||||
The locator type to use
|
||||
Overrides configuration parameter \fI\%reloc.locator\fP\&.
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-use\-weight arg
|
||||
Use current picks weight
|
||||
.B \-\-profile arg
|
||||
Overrides configuration parameter \fI\%reloc.profile\fP\&.
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-evaluation\-mode arg
|
||||
set origin evaluation mode: \(dqAUTOMATIC\(dq or \(dqMANUAL\(dq
|
||||
.B \-\-ep arg
|
||||
Event parameters XML file for offline processing of all
|
||||
contained origins. This option should not be mixed with
|
||||
\-\-dump.
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-ep file
|
||||
Defines an event parameters XML file to be read and processed. This
|
||||
implies offline mode and only processes all origins contained
|
||||
in that file. Each relocated origin is appended to the list
|
||||
of origins unless \-\-replace is given.
|
||||
.B \-O, \-\-origin\-id arg
|
||||
Reprocess the origin and send a message unless test mode is
|
||||
activated.
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-use\-weight
|
||||
Overrides configuration parameter \fI\%reloc.useWeight\fP\&.
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-streams\-set\-unused arg
|
||||
Overrides configuration parameter \fI\%picks.streamsSetUnused\fP\&.
|
||||
.sp
|
||||
Type: \fIlist:string\fP
|
||||
.sp
|
||||
List of streams from which picks are set to unsed by their
|
||||
referencing arrivals before locating. The concerned arrivals
|
||||
are kept but the picks will not be used for locating.
|
||||
Streams take the format NET.STA.LOC.CHA. Wildcards * and ?
|
||||
are supported.
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
@ -509,6 +574,23 @@ that an output has been generated is replaced by the result
|
||||
of relocation. In other words: two LocSAT origins in, two
|
||||
NonLinLoc origins out. All other objects are passed through.
|
||||
.UNINDENT
|
||||
.SS Output
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-evaluation\-mode
|
||||
Evaluation mode of the new origin (AUTOMATIC or MANUAL).
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-f, \-\-formatted
|
||||
Use formatted XML output. Otherwise XML is unformatted.
|
||||
.UNINDENT
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-origin\-id\-suffix
|
||||
Create origin ID from that of the input origin plus the
|
||||
specfied suffix.
|
||||
.UNINDENT
|
||||
.SS Profiling
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
@ -518,7 +600,9 @@ Measure the time spent in a single relocation
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-repeated\-relocations arg
|
||||
improve measurement of relocation time by running each relocation multiple times. Specify the number of relocations, e.g. 100.
|
||||
Improve measurement of relocation time by running each
|
||||
relocation multiple times. Specify the number of relocations,
|
||||
e.g. 100.
|
||||
.UNINDENT
|
||||
.SH AUTHOR
|
||||
gempa GmbH, GFZ Potsdam
|
||||
|
||||
Reference in New Issue
Block a user