Templates

Templates are the backbone of RGSM, they allow to create user-defined reports. The latex templates make use of Jinja2 which integrates Python into latex, therefore the templates can recognize Python variables. Contact gempa for assistance if needed.

Adding a new template

To add a new template, either copy, rename and modify one of the provided templates or create your own templates and move them into the directory $SEISCOMP_ROOT/share/[shard|sigma]/templates/. Only templates in this directory can be used by RGSM.

Note

Be aware that any changes to the provided templates will be overwritten once RGSM is updated.

Usage of variables in templates

There are specific variables that can be used in the latex templates. They offer the chance to use post-processed results in the report. The list differs between SHARD and SIGMA/AUTOSIGMA. To use variables, put the variable name inside of double curly brackets, e.g. {{ magnitude }}.

Use option --print-vars to get the list of usable variables for your current incident and template. This list might differ, depending on the used template, used module and available content in the report directory.

For an exemplary SHARD incident, the variable smParameters and sub-variables can be utilized in a template:

\begin{table}[h]
    \begin{tabular}{|l|l|l|l|l|l|l|l|l|l|}
        \hline
        Net & Sta  & Loc & max PGA  & max PGV  & max PGD  & max EDA & max CAV & max T & max Tp\\
        & & & [m/s\textsuperscript{2}] & [m/s] & [m] & [m/s\textsuperscript{2}]  & [m/s] & [s] & [s]\\
        \hline
        {% for key, value in smParameters.items() %}
            {{ value.networkCode }} & {{ value.stationCode }} & {{ value.locationCode }} & {{ value.valuePGA_max }} & {{ value.valuePGV_max }} & {{ value.valuePGD_max }} & {{ value.EDA_max }} & {{ value.CAV_max }} & {{ value.duration_max }} & {{ value.Tp_max }}\\ \hline
        {% endfor %}
    \end{tabular}
\end{table}

Figure 39: Exemplary result of the latex code above

Alert level

The variable {{alertLevel}} for SHARD is calculated based on the highest exceed PGA-level of any sensor.

The variable {{alertLevel}} for SIGMA/AUTOSIGMA is calculated based on the highest MMI found for any given Point Of Interest (POI).

Display plots

RGSM can create waveform, reference- and spectrum plots based on the files the modules, i.e. SHARD and SIGMA/AUTOSIGMA, provide. For that, the templates have to contain the path to the files-to-create. Only if these specific path names are found in the template, the corresponding plots will be created and displayed in the report. This procedure reduces the creation time of reports in cases certain plots are unwanted.

Waveform + Spectrum

To enable plotting the waveform + spectrum, the template needs to include [Unit]-1C-wav+spec, whereas unit is one of acc, vel or disp. Only the corresponding units will be plotted. E.g. if only acc-1C-wav+spec is found the acceleration traces are plotted, if acc-1C-wav+spec and disp-1C-wav+spec both are plotted.

Exemplary:

\section{Waveforms and Fourier spectra of station with peak values}
{% for key, value in smParameters.items() %}
    {% for component in value.components %}
        \begin{figure}[th]
            \centering
            \includegraphics[width=0.9\textwidth]{ {{inputPath}}/{{value.waveformIDmod}}{{component}}{{value.unit}}-acc-1C-wav+spec.pdf }
        \end{figure}
    {% endfor %}
{% endfor %}

Figure 40: Waveform + spectrum plot of one station

Response Spectrum

Similar, to enable plotting the response spectra the template needs to include -resp.pdf.

Exemplary:

{% for key, value in smParameters.items() %}
    \begin{figure}[th]
        \centering
        \includegraphics[width=0.9\textwidth]{ {{inputPath}}/{{value.waveformIDmod}}-resp.pdf }
    \end{figure}
{% endfor %}

In addition to the response spectrum, the design spectrum can be visualized as well. RGSM checks the directory @DATADIR@/stations/design if a corresponding design spectrum for a displayed stations exists. As SHARD and SIGMA/AUTOSIGMA use the same directory, usually station-specific design spectra should exist already.

Figure 41: Response and design spectrum of one station

Fragility curve

If the template includes fragility-curve.pdf, a fragility curve per station with its maximum measured ground motion value can be plotted.

Exemplary:

\section{Fragility curve}
    {% for key, value in smParameters.items() %}
        \begin{figure}[th]
          \centering
          \includegraphics[width=0.85\textwidth]{ {{inputPath}}/{{value.waveformIDmod}}-fragility-curve.pdf }
        \end{figure}
    {% endfor %}

RGSM checks the directory @DATADIR@/stations/fragility if a corresponding fragility curve for each station exists. As SHARD and SIGMA/AUTOSIGMA use the same directory, usually station-specific fragility curve should exist already.

Figure 42: Exemplary fragility curve for PGA of 1g for a transformer.

Special functions in templates

There are some special and useful functions that can be used in the templates.

Translations (trans)

The variable content is in English. Hence, latex templates can include custom translations, using the trans function by providing a list of key values pairs. Hereby, the keys are the values of Python variables (see Usage of variables in templates).

The syntax is one line per word/phrase:

{# trans: "English word/phrase" = "translation" #}

List of text-keys that can be translated, might not be complete

{# trans: "Not felt" = "..." #}
{# trans: "None" = "..." #}
{# trans: "Weak" = "..." #}
{# trans: "Very light" = "..." #}
{# trans: "Light" = "..." #}
{# trans: "Slight" = "..." #}
{# trans: "Moderate" = "..." #}
{# trans: "Strong" = "..." #}
{# trans: "Very strong" = "..." #}
{# trans: "Severe" = "..." #}
{# trans: "Violent" = "..." #}
{# trans: "Extreme" = "..." #}
{# trans: "Moderate/Heavy" = "..." #}
{# trans: "Heavy" = "..." #}
{# trans: "Very heavy" = "..." #}
{# trans: "\textcolor{red}{ALERT ON}" = "\textcolor{red}{...}" #}
{# trans: "\textcolor{green}{NO ALERT}" = "\textcolor{green}{...}" #}
{# trans: "N" = "..." #}
{# trans: "E" = "..." #}
{# trans: "S" = "..." #}
{# trans: "W" = "..." #}

Translation of Flinn-Engdahl Regions

Additionally, the Flinn-Engdahl regions can be translated. One way is to translate each region manually as described in Translations (trans), or, which might be more convenient as is does not need to be defined in every template, by putting a file named translation.map in the corresponding directory seiscomp/share/rgsm/[shard|sigma]. This file needs to have the following syntax:

...

[Regions]
FE1=FE1_translation
FE2=FE2_translation
...

Point Of Interest (POI)

Only used by SIGMA/AUTOSIGMA

SIGMA/AUTOSIGMA generates a MMI grid based on the applied GMPE. In the template multiple point of interest (POI) can be defined, e.g., cities or structures. For these POIs the MMI is extracted and can be displayed in the report.

The syntax is one line per POI:

{# poi: NAME, LON, LAT #}

Exemplary, the following code uses the POIs to create a table:

\begin{tabular}{|l|c|c|c|c|}
    \hline
    \multicolumn{5}{|c|}{\textcolor{red}{Intensity at Main Cities}}\\
    \hline
    \textbf{City} & \textbf{Distance (km)} & \textbf{Intensity (MMI)} & \textbf{Perceived Shaking} & \textbf{Potential Effect/Damage} \\
    \hline
    {% for key, value in POI.items() %}
        {% if key != "epicentre" %}
            \hline
            {{value.name}} & {{value.repi}} & {{value.intensity_roman}} & {{value.shaking}} & {{value.damage}} \\
        {% endif %}
    {% endfor %}
    \hline
\end{tabular}

Media

The directory $SEISCOMP_ROOT/share/[shard|sigma]/media/ contains pictures that RGSM can use. Although, latex templates are able to use absolute paths to any directory or file, we suggest to put all static pictures related to the report, e.g., agency logo, in this directory. Additionally, some latex variables won’t work if the files in this directory are not correctly defined.

E.g., the latex variable {{agencylink}} corresponds to the file name $SEISCOMP_ROOT/share/[shard|sigma]/media/agency.png. If it does not exists, the file agency_default.png is used instead.