scmapcut

Create image files containing maps of specific regions.

Description

scmapcut is a commandline tool to create image files containing maps of specific regions and for selected events. When plotting events given by their eventID, the event parameters must be provided in a SeisComP3 event XML file. The XML file can be retrieved from the database using scxmldump.

Examples

1. Draw a map for the event with event ID <eventID>. Plot a region of at least 3 degrees around the epicentre. The created image has 800x400 px.

   scmapcut -E <eventID> --ep <eventID>.xml -m 3 -d 800x400 -o <eventID>.png
   

   

   Image example.

2. Draw a map for a generic event with magnitude 4. The size of the event shown on the map scales with magnitude. Plot a region of at least 3 degrees around the epicentre. The created image has 800x400 px.

   scmapcut --lat 44 --lon 12 --depth 10 --mag 4 -m 0.5 -d 800x400 -o generic.png
   

   

   Generic example.

Configuration

etc/defaults/global.cfg

etc/defaults/scmapcut.cfg

etc/global.cfg

etc/scmapcut.cfg

~/.seiscomp3/global.cfg

~/.seiscomp3/scmapcut.cfg

scmapcut inherits global options.

Command-line

Generic

-h, --help

show help message.

-V, --version

show version information

--config-file arg

Use alternative configuration file. When this option is used the loading of all stages is disabled. Only the given configuration file is parsed and used. To use another name for the configuration create a symbolic link of the application or copy it, eg scautopick -> scautopick2.

--plugins arg

Load given plugins.

-D, --daemon

Run as daemon. This means the application will fork itself and doesn’t need to be started with &.

--auto-shutdown arg

Enable/disable self-shutdown because a master module shutdown. This only works when messaging is enabled and the master module sends a shutdown message (enabled with –start-stop-msg for the master module).

--shutdown-master-module arg

Sets the name of the master-module used for auto-shutdown. This is the application name of the module actually started. If symlinks are used then it is the name of the symlinked application.

--shutdown-master-username arg

Sets the name of the master-username of the messaging used for auto-shutdown. If “shutdown-master-module” is given as well this parameter is ignored.

Verbosity

--verbosity arg

Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info, 4:debug

-v, --v

Increase verbosity level (may be repeated, eg. -vv)

-q, --quiet

Quiet mode: no logging output

--component arg

Limits the logging to a certain component. This option can be given more than once.

-s, --syslog

Use syslog logging back end. The output usually goes to /var/lib/messages.

-l, --lockfile arg

Path to lock file.

--console arg

Send log output to stdout.

--debug

Debug mode: –verbosity=4 –console=1

--log-file arg

Use alternative log file.

Cities

--city-xml arg

Path to the cities.xml file. If undefined the data is read from @CONFIGDIR@/cities.xml@ or @DATADIR@/cities.xml@.

Options

-r, --region arg

Cut region ([lat_dim]x[lon_dim]+lat0+lon0 or +lat0+lon+lat1+lon1)

-m, --margin arg

Margin in degrees around origin (margin|margin_latxmargin_lon)

-d, --dimension arg

Output image dimension (wxh)

-o, --output arg

Output image, file name

--lat arg

Latitude of symbol

--long arg

Longitude of symbol

--depth arg

Depth of event

--mag arg

Magnitude of event

--layers arg

Draw polygonal layers

--ep arg

Name of XML file containing the event parameters to load

-E, --event-id arg

EventID of the event to plot on map

--html-area arg

Print html/area section