Data Processing: Tromino - RJbalikian/SPRIT-HVSR GitHub Wiki

Tromino Yellow 3G+

Summary

A summary of the basic steps for downloading and processing Tromino data is below:

  1. Export data from instrument a) Open GRILLA with Tromino plugged into computer b) Import data from Tromino c) Find project/folder where data is stored
  2. Read data into SpRIT and process

Export steps

Grilla Database

Plug the Tromino instrument into a computer with the GRILLA license installed and open GRILLA.

Grilla Database View

The main GRILLA page is the database view (pictured above). This shows a list of data traces, usually organized by project. The first time GRILLA was opened (or manually later), a directory was selected to house the Grilla databse. This is stored as a folder called "GRILLADB"

That folder usually contains a folder called "Traces". In the traces is a series of folders, each corresponding to a "site" (site is the term used in Grilla, but this is generally better understood as a project). In each site/project folder is a series of folders, each corresponding to a single data point/trace/partition.

So, if you your GrillaDB folder is saved on the /home/data/ on your computer, and you have a "site"/project called "Urbana" and a trace collected in partition 25, you will have the following path/directory structure to your data (the numbers following the "GRILLA25" have to do with date and time of processing or acquisition):

/home/data/GrillaDB/Traces/Urbana/GRILLA25 11-Jun-2025 15-12-13 443/

In the folder with your data, you will usually find a .ass and a .trc file. The .trc file is the file that contains your data. This is the file that you will point to with your input_data parameter of sprit.run().

Import traces

Click the Import new recording button (far left button on the toolbar, circled in red in image below). Grilla Import New Recording Button

This will take you to a dialog where you can select which partitions to import. Select all applicable partitions. It is generally easier (i.e., you have more control to make sure your traces end up in the proper location) if you do NOT use the Import all traces button, but instead import one at a time. Check the Site name and the partition with your notes to ensure they are the sites/data expected.

These should then be populated in your database, one trace per record/line/row. The "Site" (i.e., project) column is usually highlighted by color and is a quick way to find and organize your points, so make sure to put in the proper site/project name when importing the traces. These traces will also be saved in the GrillaDB folder on your computer.

Processing Tromino 3G+ Data in SpRIT

Note: You may use the SpRIT (web) app to process Tromino data. To do so, visit the SpRIT Web app or run the streamlit GUI from your local computer. Instructions for either method of app access are located at the SpRIT app wiki/tutorial here.

Processing Tromino data in SpRIT is relatively straightforward. Currently, only Tromino Yellow (3G+) and Tromino Blue have been tested, and both are experimental. If using Tromino Blue, replace the instrument='tromino 3g' line below with instrument='tromino blue'.

To process the data, simply use the sprit.run() function as below:

import sprit
hvsrData = sprit.run(input_data="/path/to/your/tromino/file/Grillaxx.trc",
    instrument="tromino 3g",
    acq_date="2025-06-15",
    start_time="15:00",
    # You may choose to include other parameters as well, but these are the primary required parameters
)

Processing Tromino data in GRILLA

Find the trace of interest in your database and double-click on it. This will pull up a page with the traces laid out (see image below)

Grilla trace view

You may select windows to include in the analysis (it only works left to right) or you may move directly to the H/V analysis. To do the H/V analysis, click the H/V analysis button near the top left of the screen (see image below, button circled in red)

Grilla trace view with H/V analysis button circled

This will open a dialog with analysis settings. After adjusting setting and clicking Ok, Grilla will carry out H/V analysis. Three new dialogs will be opened with your results.

Results dialogs after H/V analysis in Grilla.

Go back to the window with the raw traces. Click the clipboard icon for "Analyses..."

Raw traces dialog with analyses button circled

Click the analysis of interest (there may only be one line, in which case make sure it is highlighted).

Then click the Create Report button at the bottom of the dialog.

Analyses dialog with Create Report button at bottom

This will open a word document with your H/V analysis test results.