Installation Guide

New to command line?
Don't worry! We'll explain each step. The command line is just a text interface where you type commands instead of clicking buttons.
Step 1

Install Python

Python is the programming language of our tools. As these tools are not built as executable files, you need to install it first:

  1. Go to python.org and download the "Windows Installer (64-bit)" for the latest stable version
  2. Run the downloaded file
  3. Before going forward with the installation, in the first step, make sure to check the box that says "Add Python to PATH" during installation
What does "Add Python to PATH" do?
It allows you to run Python commands from any folder on your computer. This is essential for our tools to work properly.
Step 2

Installing the tools:

Open Command Prompt (search "cmd" in Windows Start menu or press Win + R) and run each command to install the tools:

pip install segyrecover
pip install velrecover
pip install inseis

Alternative: Install from GitHub

If you want to try the latest development version:

pip install git+https://github.com/a-pertuz/segyrecover.git
pip install git+https://github.com/a-pertuz/velrecover.git
pip install git+https://github.com/a-pertuz/inseis.git
The git+ prefix instructs pip to install directly from the GitHub repository's latest version.
Step 3

Launch the Tools

Open Command Prompt and run any of these commands to start the programs. Check the tutorials to learn how to use each tool effectively.

segyrecover
velrecover
inseis

Creating a Desktop Shortcut

  1. Right-click on your desktop
  2. Select New → Shortcut
  3. Type python -m segyrecover or just segyrecover (if installed via pip)
  4. Click Next and give the shortcut a name (e.g., "SEGYRecover")
  5. Click Finish
First run tip: Each tool will guide you through selecting a data directory when first launched.
Important: To use InSeis, you must also install WSL (Windows Subsystem for Linux) and Seismic Unix. Please follow steps 4 below before running InSeis for the first time.
Step 4

Step 4: Install WSL and Seismic Unix (for InSeis only)

InSeis requires Windows Subsystem for Linux (WSL) to run. This allows you to use Linux tools directly on Windows.

Follow these steps to set up WSL:

  1. Open Command Prompt as Administrator (right-click, select "Run as administrator")
  2. Run the following command: wsl --install
  3. Wait for the installation to complete.
  4. Restart your computer when prompted.
  5. After restart, search for "Ubuntu" in the Start menu and launch it.
  6. Follow the prompts to set up your new Linux environment. You may be asked to create a user account and password.
  7. Run sudo apt update to ensure all packages are up to date.
Note: If you encounter any issues, please refer to the official WSL installation guide.

Now you have to install Seismic Unix. To do this, follow these steps:

  1. Open the Ubuntu terminal (search for "Ubuntu" in Windows Start menu)
  2. Copy and paste this entire command:
    3. bash -c "$(wget -qO- https://gist.githubusercontent.com/a-pertuz/2b341bc8af2a37cde820d829f2789d99/raw/install_seismic_unix.sh)"
  3. Press Enter and wait for the installation to complete. It may take several minutes.
  4. Important: Read and accept the license agreement when prompted.
All done? You can now run InSeis by typing inseis in the Ubuntu terminal.