Module for locating local earthquakes and man-made seismicity by DBSCAN cluster search. Default source depth used for locating origins. The range of supported values depends on the configured travel-time interface and locator. When origin depth after locating is 0.0 or undefined, the depth is corrected to "defaultDepth" without relocating since the situation indicates issues. Note: A similar parameter may require configuration for score plugins. Maximum depth of an origin to be sent. Note: A similar parameter may require configuration for score plugins. Compute distances in 3D for cluster search, phase association and internal event association. Otherwise, distances are measured from geographic coordinates ignoring elevation. Maximum allowed overall residual of an origin to be sent. Minimum score of an origin to be sent. Defines the score processor to be used for ranking origins of events. Additional configuration of the plugin and the plugin parameters is required. The level up to which compare stream IDs of multiple picks in order to avoid origins with multiple picks from identical stream level, e.g., station (sta), sensor location (loc) or channel (cha). The level is derived from the NET.STA.LOC.CHA stream representation. Picks with equal stream IDs on the given level are treated as originating from the same stream no matter of the ID on a lower level. Clusters having picks on streams equal on the given level are split into new clusters with unique streams. During association picks equal on the given level are ignored - the first assigned pick is considered. Define buffering of picks and origins. scanloc only treats picks and origins kept in the buffer. Time to keep picks. Time comparison is based on the pick times. In non-real time playbacks the time to keep picks is usually compressed. Ignore picks created on given stream ID(s). Stream IDs may contain wildcards. Separate multiple IDs by comma. Generally, all available picks are added to the buffer and made available for processing. Use this option to ignore new picks made on the same data stream within the given time difference to a previously buffered pick. A value of 0.0 s ignores all picks with identical times. Time to keep origins. Time comparison is based on the origin times. In non-real time playbacks the time to keep orgins is usually compressed. Ignore and do not buffer external origins received from messaging or from XML files. Default: Accept external origins from messaging or XML and associate more phases. Ignore and do not buffer manual external origins received from messaging or from XML files. The parameter "buffer.ignoreOrigins" must be inactive for this option to be effective. Ignore an external origin if its status has any of the given states. The option is ignored for manual origins if buffer.ignoreManualOrigins = false. Only buffer picks or origins from the given authors. Separate multiple authors by comma. Picks and origins from other authors will be ignored. Wildcards are supported. This parameter overrides "buffer.originAuthorWhiteList". Manual origins are treated regardless of the author as defined by "buffer.ignoreManualOrigins". The parameter allows operation of scanloc based on picks and origins from a specific module, e.g., in a pipeline. Deprecated parameter which will be removed in 2025. Use "buffer.authorWhiteList" instead which overrides this parameter! Only buffer external origins from the given authors to the. Separate multiple authors by comma. Manual origins are treated regardless of the author as defined by "buffer.ignoreManualOrigins". The parameter "buffer.ignoreOrigins" must be inactive for this option to be effective. The time delta to the future. Positive values allow objects with times in the future to be buffered when the difference to current time or to creation time is not larger than the given value. Normally, objects like picks and origins are created after their actual times and all other objects are spurious and should be ignored. In case of wrong sensor timing or faster-than-real-time waveform playbacks, objects may be generated with actual times (pick time or origin time) in the future. If less or equal to 0.0, then all objects created before time of the object or with object times in the future are ignored. Parameters controlling the cluster search based on phase picks of configured phase type. Phase type of considered picks. Valid types: P or Is. Minimum number of core points (picks) to form a cluster. Maximum number of picks in a cluster when stopping clustering. Eventual clusters may still be larger from core points. Using values < 0 deactivates the feature. The parameter is meant to support large-N networks where the high network density results in very many clusters with high computational load effectively slowing down the processing of picks. Using reasonable values such as 10 or 15 will reduce the number of clusters while maintaining high quality initial origins. Maximum allowed difference between considered picks and cluster reference time (latest pick time). Optimum values can be derived from travel times.The cluster search ignores all picks which exceed the value. Using "-1" enables all picks regardless of the delay. Mode to set the cluster reference time. Read the documentation for the details. Available modes: LastPick: The pick time of the last incoming P pick is the cluster reference time. MaxPickDelay: Setting the cluster reference time is delayed until clusterSearch.minSize and association.minPhase picks are available. Cluster only picks which sensor locations are inside the defined region. The region is defined by latitude, longitude and a radius in km. By default the region filter is disabled. Example: 50.1,12.3,20 Average velocity used for distance calculation. Maximum allowed distance over all core points and maximum allowed distance for neighborhood search. Both account for travel-time difference, inter-station distance and the configured averageVelocity. Maximum allowed origins derived from cluster search. Set this option to zero to disable the cluster search completely. Send origins based on cluster search as preliminary origins if the location fails. Otherwise those origins are ignored. Consider activating "checkOrigins". Check, if derived origins fulfill the cluster search criteria anymore. Activating this option may lower the number of events and suppress fake events. Parameters controlling the association of P and S phases to cluster origins or external origins. Number picks in cluster origin to be reached for starting to associate more P and S picks. Maximum distance from origin to stations for associating P and S picks. The station configuration file contains lines consisting of network code, station code, weight (0 or 1) and maximum association distance given in degree. The maximum association distance is the distance in degrees from the origin up to which this station may contribute to a new origin. This parameter overrides the global parameter "association.maxDist". If this distance is 180 deg, this station may contribute to new origins world-wide. However, if the distance is only 10 degree, the range of this station is limited. This is a helpful setting in case of mediocre stations in a region where there are numerous good and reliable stations nearby. The station will then not pose a risk for locations generated outside the maximum association distance. The last item found in the list overrules previous ones. Network and station codes may be wildcards (*) for convenience. Example: * * 1 10 GE * 1 180 Maximum allowed difference between measured and predicted arrival times for associating P phases to origin. Larger values allow significant correction of initial locations. Allow S-type picks without checking for a reference pick. References to P picks are typically added to S picks by scautopick but picks from other modules may not have this feature. When this option is active, the reference pick is not tested at all. Manual picks are always considered without a reference check. Maximum allowed difference between measured and predicted arrival time for associating S phases to origins. Larger values allow significant correction of initial locations. Maximum allowed time residuals of picks after association and relocation. Picks will be removed at exceedence starting with largest residual and origins will be relocated. The number of arrivals of an origin for controlling the association of more picks. Beyond this number, the minimum of maxPResidual or maxSResidual and maxResidual for associating P or S phases, respectively, is tested before association. The parameter also speeds up the evaluation of origins with more arrivals than configured: Instead of testing residuals of arrivals individually and relocating thereafter, all arrivals not passing the residual check are removed in a bulk. The parameter is meant to support large-N networks where the high network density results in very many picks and high computational load, effectively slowing down the quality check of picks. Setting a reasonable value, e.g., >20 will only associate the best picks to origins already well constraint. Using values <= 0 deactivates the feature. Type of travel-time tables for phase association. May be different from locator. Name of travel-time table used for phase association. May be different from locator profile. Using a different table/profile may result in increased runtime. zeroWeight-profile name for associating the configured phases with zero weight to origins. Multiples profile names may be set separated by comma. The order of names determines order of checked phases. Each profile can have different parameters. Zero-weight profiles containing the parameters for associating phases with zero weight to origins. One phase type to be associated with zero weight. Examples: PKP or Pdiff. Minimum distance from origin to stations. Maximum time residual of the associated phase. Parameters controlling the locator for locating scanloc origins. The locator type to be used. The locator profile to be used. Using a different profile/table for locating and associating may result in increased runtime. If enabled, the locator fixes the depth to the configured default value "defaultDepth" in case that all previous attempts to relocate fail. This option may result in many more origins. It prevents "ignoreDepth" from beeing effective if "defaultDepth" < "ignoreDepth". If enabled, the locator is forced to fix the depth to the value configured by "defaultDepth". Free-depth solutions are thus excluded. Activating this option may be useful for sources with known depths or in case of sparse networks. Parameters controlling the association of interval scanloc origins to internal scanloc events. This parameter is only used in conjunction with "eventAssociation.maximumMatchingArrivalTimeDiff". If a station has multiple associated arrivals for a particular event, this flag defines if the time distance of a new pick to all arrivals must be within "eventAssociation.maximumMatchingArrivalTimeDiff" or if one matching arrival is enough. Minimum number of matching picks between two origins to be associated to the same event. If this time window in seconds is negative, pickIDs are compared to find matching arrivals. A non negative value (including 0) compares pick times regardless of the pickID. Pass: |pick1.time - pick2.time| <= threshold. Allowed difference in epicenter between an incoming origin compared with preferred origins to get associated. Associates an origin with an existing event if the origin time differs not more than 60 seconds unless the minimumMatchingArrivals criteria matches. Parameters controlling the publication delay of origin for internal events to the messaging system. The delay time, t, is calculated as t = a x N + b where N is the number of arrivals of the origin. After t seconds, the best origin is published. The first origin is always published. Parameter "a" in the equation t = a x N + b. Increasing the value reduces the amount of sent origins. With the option --ep (playback mode) this value is set to 0. Parameter "b" in the equation t = a x N + b. Increasing the value reduces the amount of sent origins. With the option --ep (playback mode) this value is set to 0. Integer interval to check the origin buffer for sending origins if no other origins have been created. Reducing the value may be required in EEW: it increases the load on scanloc but allows to send origins more rapidly. scanloc [options] generic#help generic#version generic#config-file generic#plugins generic#daemon verbosity#verbosity verbosity#v verbosity#quiet verbosity#print-component verbosity#print-context verbosity#component verbosity#syslog verbosity#lockfile verbosity#console verbosity#debug verbosity#trace verbosity#log-file messaging#user messaging#host messaging#timeout messaging#primary-group messaging#subscribe-group messaging#encoding messaging#start-stop-msg database#db-driver-list database#database database#config-module database#inventory-db Do not use the database at all. Name of input XML file (SCML) with all picks and origins for offline processing. The database connection is not received from messaging and must be provided. Results are sent as XML to stdout. Timing reference in offline processing with --ep: Use pickTime and creationTime for sorting picks according to pick time and creation time, respectively. pickTime is assumed if no timing is specified. Note: In real-time processing picks are treated as they arrive corresponding to creationTime and this option is irrelevant. Allow processing of picks with evaluation status 'rejected'. Otherwise these picks are ignored and not buffered. Only consider picks and origins created by the given author(s). Separate multiple authors by comma. Wildcards are supported.Empty strings allow all authors. Manual origins are treated regardless of the author as defined by "buffer.ignoreManualOrigins". The option allows operating scanloc based on picks and origins from a specific module, e.g., in a pipeline. List all registered locators. Limit result set to final origins only. This option is available for non-real-time (--ep) processing only. Don't publish origins, write them to stdout. Useful for tuning. File name to output detailed cluster search information. Useful for tuning. Use formatted XML output along with '--ep'. Otherwise XML is unformatted.