Skip to content

Latest commit

 

History

History
105 lines (65 loc) · 3.69 KB

README.md

File metadata and controls

105 lines (65 loc) · 3.69 KB
Raw

2023 Marine Seismology Workshop - OBS data processing

Instructors: Pascal Audet

When: Wednesday/Thursday, May 23/24, 2023 at 8:30 AM (ADT).

Where: Room LSC2012 in Life Sciences Centre, Dalhousie University

What: This tutorial will provide hands-on experience to process broadband ocean-bottom seismic (BBOBS) data using the Automatic Tilt and Compliance Removal (ATaCR, pronounced "attacker") software. This software is designed to automate, as best as possible, the process of characterizing and removing tilt and compliance noise from vertical component BBOBS data. The tutorial will use the Python implementation of ATaCR.

Installing the Python version

The software has been pre-installed on the computers in Room LSC2012, therefore there is no need to follow these steps. The following steps provide instructions to install the software on your personal computer.

ATaCR is implemented as a separate module in the open-source Python package OBStools:

To install obstools, we strongly recommend installing and creating a conda environment (either from the Anaconda distribution or mini-conda) where the code can be installed alongside its dependencies. This significantly reduces the potential conflicts in package versions. In a bash (or zsh) terminal, follow these steps:

  • Create a conda environment (here we call it mss for the name of the symposium) and install python=3.8 and obspy:
conda create -n msw python=3.8 obspy -c conda-forge
  • Activate the environment:
conda activate msw
  • Install the required stdb package using pip:
pip install stdb

Now you're ready to install obstools. You might consider one of two options: 1) you want to look at the source code and are considering contributing (awesome!!); 2) you are only interested in using the software and are not interested in the source code.

1) Developer mode: Installing from source

  • Navigate on the command line to a path where the software will be installed

  • Clone the OBStools repository (fork it first, if you are serious about contributing):

git clone https://github.com/paudetseis/OBStools.git
cd OBStools
  • Install using pip:
pip install -e .
2) User mode: Installing from the Python Package Index (PyPI):
pip install obstools

Getting the demo data

Finally, download the demo data provided on this github repository by navigating to some work folder (where the data and results of the processing will be located) and typing:

git clone https://github.com/nfsi-canada/MSW2023.git
cd MSW2023

The DATA and EVENTS folders should now be on your computer and you are ready to start the tutorial.

Testing your installation

If you want to make sure everything is installed properly, make sure your conda environment has been activated and open a python window by typing in a terminal:

python

which will produce something like:

Python 3.8.16 (default, Feb  1 2023, 16:05:36) 
[Clang 14.0.6 ] :: Anaconda, Inc. on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>

Then type:

>>> import stdb
>>> import obstools

If nothing happens, you're good to go! If you run into a problem, let us know by raising an issue.