| Name | segyrecover JSON |
| Version |
1.1.0
JSON |
| download |
| home_page | None |
| Summary | A Python tool for digitizing scanned seismic reflection sections and converting them to standard SEGY format. |
| upload_time | 2025-07-18 15:22:09 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | GNU GPL-3.0 |
| keywords |
seismic
digitization
segy
geophysics
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# SEGYRecover
[](https://doi.org/10.5281/zenodo.15053412)
[](https://pypi.org/project/segyrecover/)
[](https://github.com/a-pertuz/segyrecover/commits/main)
[](https://www.gnu.org/licenses/gpl-3.0.en.html)
[](https://www.python.org/downloads/)
A Python tool for digitizing scanned seismic reflection sections and converting them to standard SEG-Y format. SEGYRecover automatically removes timelines, detects trace baselines, extracts amplitude information for each trace, and produces usable SEG-Y files for modern interpretation software.
SEGYRecover is part of a collection of open source tools to digitize and enhance vintage seismic sections. See https://a-pertuz.github.io/REVSEIS/ for more information.
<details open>
<summary><h2>📖 Table of Contents</h2></summary>
- [Features](#features)
- [System Requirements](#system-requirements)
- [Installation](#installation)
- [Before You Begin](#before-you-begin)
- [Quick Start (5 Steps)](#quick-start-5-steps)
- [Complete Tutorial](#complete-tutorial)
- [Advanced Topics](#advanced-topics)
- [Citation](#citation)
- [References](#references)
- [License](#license)
</details>
<details open>
<summary><h2>✨ Features</h2></summary>
- **Digitization of seismic images** - Convert paper/raster seismic sections into SEGY files compatible with modern interpretation software
- **User-friendly GUI** - Simple interface for the entire digitization workflow
- **Perspective correction** - Handles skewed or distorted scanned images
- **Automatic trace line detection** - Identifies and digitized individual traces, preserving the original number of traces
- **Timeline detection and removal** - Detects and removes horizontal timelines
- **Amplitude extraction** - Converts pixel density to the right of each trace to seismic amplitude values for each trace
- **Frequency filtering** - Apply bandpass filters to clean up digitized data
- **Geospatial referencing** - Associates traces with real-world coordinates
</details>
<details>
<summary><h2>💻 System Requirements</h2></summary>
- **Operating System**: Windows 10/11
- **Memory**: At least 8GB RAM
- **Python**: 3.12+ (automatically handled if installing via pip)
- **Disk Space**: Sufficient space for images and output files
- **Image Requirements**:
- Binary images (black and white pixels only)
- Supported formats: TIF, JPG, PNG
- Variable area/wiggle display with positive amplitude filled in black
</details>
<details>
<summary><h2>⚙️ Installation</h2></summary>
### Windows Installation
1. **Install Python** (if not already installed):
- Download Python from [python.org](https://www.python.org/downloads/windows/)
- During installation, make sure to check **"Add Python to PATH"**
- Click "Install Now" and wait for installation to complete
2. **Install SEGYRecover**:
- Open Command Prompt (search for "cmd" in Windows search)
- Type the following command and press Enter:
```bash
pip install segyrecover
```
Alternatively, install the latest development version directly from GitHub:
```bash
python -m pip install git+https://github.com/a-pertuz/segyrecover.git
```
3. **Launch the program**:
After installation, simply type:
```bash
segyrecover
```
### First Run Setup
When you run SEGYRecover for the first time:
- You'll be prompted to choose a data storage location
- Choose a location with plenty of disk space
- Example files will be copied to your selected location
- The application will create the necessary folder structure
### Creating a Desktop Shortcut
1. Right-click on your desktop
2. Select "New" → "Shortcut"
3. Type `segyrecover` (if installed via pip)
4. Click "Next" and give the shortcut a name (e.g., "SEGYRecover")
5. Click "Finish"
</details>
<details>
<summary><h2>📁 Before You Begin</h2></summary>
### File Organization
SEGYRecover uses the following folder structure:
```
segyrecover/
├── IMAGES/ # Store input seismic images
├── GEOMETRY/ # Store .geometry files with trace coordinates
├── LOG/ # Store log files
├── ROI/ # Store region of interest points
├── PARAMETERS/ # Store processing parameters
└── SEGY/ # Store output SEGY files
```
### Prepare Your Data
1. **Place seismic images** in the `IMAGES` folder
2. **Create geometry files** (optional) in the `GEOMETRY` folder with format:
```
CDP_NUMBER X_COORDINATE Y_COORDINATE
100 500000.0 4500000.0
101 500025.0 4500020.0
```
- Files should have `.geometry` extension
- Same base name as corresponding image files
- Only first and last CDP points needed (software interpolates)
3. **Verify image quality**:
- Higher resolution images yield better results
- Minimal annotations overlapping seismic data
- Clear trace lines and timelines
</details>
<details>
<summary><h2>🚀 Quick Start (5 Steps)</h2></summary>
1. **Launch** → Run `segyrecover` and click "Start New Line"
2. **Load** → Select your seismic image file
3. **Configure** → Set parameters (trace coordinates, sample rate, frequency band)
4. **Select** → Mark three corners of your seismic section (ROI)
5. **Process** → Click "Start Digitization" and wait for completion
Your SEG-Y file will be saved in the `SEGY` folder and can be loaded into interpretation software.
</details>
<details>
<summary><h2>📚 Complete Tutorial</h2></summary>
### Step 1: Loading an Image
1. From the Welcome screen, click **"Start New Line"**
2. Click **"Load Image"** to select your seismic section file
3. Navigate to your image and click "Open"
4. The image displays in the preview area with coordinate file info
5. Click "Next" to proceed to Parameters
> **Note**: The console panel shows image details including dimensions and file path.
### Step 2: Setting Parameters
Configure how the software interprets your seismic image:
1. After loading, you're taken to the Parameters tab
2. Previously saved parameters load automatically if available
3. Fill in the parameter sections below
4. Click **"Save Parameters"** to store settings
5. Click **"Next"** to proceed to ROI Selection
#### Region of Interest Corner Points
Map image pixels to seismic coordinates:
- **P1 (Top Left)**: Trace number and TWT (Two-Way Time) value
- **P2 (Top Right)**: Trace number and TWT value
- **P3 (Bottom Left)**: Trace number and TWT value
**Example**:
- P1: Trace 100 at 0 ms (top left)
- P2: Trace 500 at 0 ms (top right)
- P3: Trace 100 at 3000 ms (bottom left)
> **Note**: Use negative time values for data above datum (e.g., -200 ms)
#### Acquisition Parameters
- **Sample Rate (ms)**: Time between data points (common: 2 or 4 ms)
- **Frequency Band (Hz)**: Four-value bandpass filter:
- F1: Start cutting below this frequency
- F2: Keep everything above this frequency
- F3: Keep everything below this frequency
- F4: Start cutting above this frequency
**Common Values**:
- Vintage data: F1=8, F2=12, F3=60, F4=80
- Modern data: F1=3, F2=5, F3=80, F4=100
#### Detection Parameters
- **TLT (Traceline Thickness)**: Vertical trace width in pixels (usually 1)
- **HLT (Timeline Thickness)**: Horizontal timeline height in pixels (4-8)
#### Advanced Parameters
*Default values work for most images*
- **HE (Horizontal Erode)**: Timeline removal aggressiveness (100+ px)
- **BDB/BDE**: Trace detection start/end rows from top
- **BFT**: Duplicate trace filtering strictness (0-100%, default 80%)
### Step 3: Selecting Region of Interest
Mark three corners to define the digitization area:
1. You're automatically taken to ROI Selection after parameters
2. Image displays with corner point selection prompt
3. Use **magnifier** 🔍 to zoom to **top-left** corner
4. Click **"Top-left (1)"** button, then click desired point
5. Use **Home** 🏠 to return to full view
6. Zoom to **top-right** corner, select **(2)** and click point
7. Repeat for **bottom-left** corner
8. Fourth corner calculates automatically
9. Verify result and click "Accept"
10. Click "Next" for Digitization
> **Note**: ROI points save automatically for future reuse
### Step 4: Processing
Automatic processing workflow:
1. Click **"Start Digitization"** to begin
2. Monitor console for step-by-step progress
3. Select CDP direction when prompted
4. Review processing in visualization window
#### Processing Steps
**1. Timeline Detection and Removal**
- Isolates horizontal timeline marks
- Removes timelines from original image
| Timeline Detection Failure | Timeline Detection Success |
|:--------------------------:|:---------------------------:|
|  |  |
| HE parameter too low (200) | Correct isolation (HE=600) |
**2. Baseline Detection**
- Identifies vertical trace lines
- Shows verification with green baseline overlay
**3. Amplitude Extraction**
- Counts black pixels per row between baselines
- Applies zero-value correction and smoothing
- Uses Akima interpolation for clipped values
**4. Data Processing**
- Resamples to specified sample rate
- Applies bandpass filtering
**5. SEG-Y Creation**
- Prompts for CDP direction (increasing/decreasing)
- Interpolates coordinates for all traces
- Creates standard SEG-Y with complete headers
### Step 5: Results
View and analyze your digitized data:
1. Digitized SEG-Y section displays in main view
2. Amplitude spectrum shows frequency content
3. Console provides digitization summary
4. Additional processing options are available via buttons
5. Click "Start New Line" for next image
#### Additional Processing Options
The Results tab provides several buttons for further processing and editing of your digitized SEG-Y data:
**Edit SEGY Header**
- Modify SEGY file headers including acquisition parameters and metadata
- Useful for adding extra information
**Mute Topography**
- Interactively define a muting surface by clicking on the seismic section
- Remove unwanted shallow data above a specified horizon
- Apply tapering to create smooth transitions
- Useful for removing noise above the topography, ground roll, or other unwanted noise
**Apply AGC RMS**
- Apply Automatic Gain Control using Root Mean Square method
- Balance trace amplitudes to enhance weaker signals
- Configurable gate length for amplitude averaging
- Helpful for improving visibility of deeper reflections
**Apply Trace Mixing**
- Enhance signal-to-noise ratio through trace averaging
- Choose between weighted average or median filtering methods
- Configurable mixing window size and weights
- Effective for attenuating random noise while preserving coherent signals
Each processing option opens a dedicated dialog with preview capabilities, allowing you to see the effects before applying changes. You can choose to save results as new files or overwrite the original.
#### Accessing SEG-Y Files
- **File → Open Data Directory** → navigate to SEGY folder
- File location shown in console panel
- Compatible with OpendTect, Petrel, Leapfrog, Kingdom
</details>
<details>
<summary><h2>🔧 Troubleshooting and FAQs</h2></summary>
### Troubleshooting
#### Poor Timeline Detection
- Increase HE (Horizontal Erode) parameter
- Ensure ROI aligns timelines horizontally
#### Missing/Extra Baselines
- Adjust TLT to match trace width
- Modify BDB/BDE for cleaner detection areas
- Increase BFT to filter false detections
#### Noisy/Spiky Data
- Adjust frequency filter parameters (F1-F4)
- Use narrower frequency band
- Check ROI excludes non-seismic elements
#### Coordinate Issues
- Verify geometry file format (CDP, X, Y)
- Match CDP numbers between geometry and parameters
- Use consistent coordinate system (UTM recommended)
#### Log Files
Check `LOG` folder for detailed process logs and error messages.
### Frequently Asked Questions
**How can I improve quality?**
- Use highest resolution scans possible
- Experiment with frequency filter settings
- Ensure proper timeline detection/removal
- Make precise ROI selections
**Batch processing available?**
Currently processes one image at a time. Use "Start New Line" sequentially and save parameters for similar images.
**No geometry data?**
Still digitizable but SEG-Y lacks real-world coordinates. Create placeholder file with first/last CDP numbers and arbitrary coordinates.
**Color images supported?**
Works best with black/white images. Convert color seismic to grayscale/binary before processing.
### Common Issues
- **Program not found**: Ensure Python added to PATH
- **Missing dependencies**: Run `pip install <package_name>`
</details>
<details>
<summary><h2>📄 Citation</h2></summary>
If you use this software in your research, please cite it as:
```
Pertuz, A., Benito, M. I., Llanes, P., Suárez-González, P., & García-Martín, M. (2025a). SEGYRecover: A Python GUI-based tool for digitizing vintage seismic reflection sections into SEG-Y files. Zenodo. https://doi.org/10.5281/zenodo.15053412
```
Find this software in the Zenodo Archive: [https://doi.org/10.5281/zenodo.15053412](https://doi.org/10.5281/zenodo.15053412)
</details>
<details>
<summary><h2>📖 References</h2></summary>
SEGYRecover uses several image processing and signal processing techniques. Some of them are covered by previous digitalization programs:
[1] Miles, P. R., Schaming, M., & Lovera, R. (2007). Resurrecting vintage paper seismic records. _Marine Geophysical Researches_, 28, 319-329.
[2] Farran, M. L. (2008). IMAGE2SEGY: Una aplicación informática para la conversión de imágenes de perfiles sísmicos a ficheros en formato SEGY. _Geo-Temas_, 10, 1215-1218.
[3] Sopher, D. (2018). Converting scanned images of seismic reflection data into SEG-Y format. _Earth Science Informatics_, 11(2), 241-255.
</details>
<details>
<summary><h2>⚖️ License</h2></summary>
This software is licensed under the GNU General Public License v3.0 (GPL-3.0).
You may copy, distribute and modify the software as long as you track changes/dates in source files.
Any modifications to or software including (via compiler) GPL-licensed code must also be made available
under the GPL along with build & installation instructions.
For the full license text, see [LICENSE](LICENSE) or visit https://www.gnu.org/licenses/gpl-3.0.en.html
</details>
---
*For questions, support, or feature requests, please contact Alejandro Pertuz at apertuz@ucm.es*
Raw data
{
"_id": null,
"home_page": null,
"name": "segyrecover",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "seismic, digitization, segy, geophysics",
"author": null,
"author_email": "Alejandro Pertuz <apertuz@ucm.es>",
"download_url": "https://files.pythonhosted.org/packages/34/72/6466aff2e2031a3c4aaa692f509606c8361be7f5403fe5e25916421b04b4/segyrecover-1.1.0.tar.gz",
"platform": null,
"description": "# SEGYRecover\r\n\r\n[](https://doi.org/10.5281/zenodo.15053412)\r\n[](https://pypi.org/project/segyrecover/)\r\n[](https://github.com/a-pertuz/segyrecover/commits/main)\r\n[](https://www.gnu.org/licenses/gpl-3.0.en.html)\r\n[](https://www.python.org/downloads/)\r\n\r\nA Python tool for digitizing scanned seismic reflection sections and converting them to standard SEG-Y format. SEGYRecover automatically removes timelines, detects trace baselines, extracts amplitude information for each trace, and produces usable SEG-Y files for modern interpretation software.\r\n\r\nSEGYRecover is part of a collection of open source tools to digitize and enhance vintage seismic sections. See https://a-pertuz.github.io/REVSEIS/ for more information.\r\n\r\n<details open>\r\n<summary><h2>\ud83d\udcd6 Table of Contents</h2></summary>\r\n\r\n- [Features](#features)\r\n- [System Requirements](#system-requirements)\r\n- [Installation](#installation)\r\n- [Before You Begin](#before-you-begin)\r\n- [Quick Start (5 Steps)](#quick-start-5-steps)\r\n- [Complete Tutorial](#complete-tutorial)\r\n- [Advanced Topics](#advanced-topics)\r\n- [Citation](#citation)\r\n- [References](#references)\r\n- [License](#license)\r\n\r\n</details>\r\n\r\n<details open>\r\n<summary><h2>\u2728 Features</h2></summary>\r\n\r\n- **Digitization of seismic images** - Convert paper/raster seismic sections into SEGY files compatible with modern interpretation software\r\n- **User-friendly GUI** - Simple interface for the entire digitization workflow\r\n- **Perspective correction** - Handles skewed or distorted scanned images\r\n- **Automatic trace line detection** - Identifies and digitized individual traces, preserving the original number of traces\r\n- **Timeline detection and removal** - Detects and removes horizontal timelines\r\n- **Amplitude extraction** - Converts pixel density to the right of each trace to seismic amplitude values for each trace\r\n- **Frequency filtering** - Apply bandpass filters to clean up digitized data\r\n- **Geospatial referencing** - Associates traces with real-world coordinates\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\ud83d\udcbb System Requirements</h2></summary>\r\n\r\n- **Operating System**: Windows 10/11\r\n- **Memory**: At least 8GB RAM\r\n- **Python**: 3.12+ (automatically handled if installing via pip)\r\n- **Disk Space**: Sufficient space for images and output files\r\n- **Image Requirements**: \r\n - Binary images (black and white pixels only)\r\n - Supported formats: TIF, JPG, PNG\r\n - Variable area/wiggle display with positive amplitude filled in black\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\u2699\ufe0f Installation</h2></summary>\r\n\r\n### Windows Installation\r\n\r\n1. **Install Python** (if not already installed):\r\n - Download Python from [python.org](https://www.python.org/downloads/windows/)\r\n - During installation, make sure to check **\"Add Python to PATH\"**\r\n - Click \"Install Now\" and wait for installation to complete\r\n\r\n2. **Install SEGYRecover**:\r\n - Open Command Prompt (search for \"cmd\" in Windows search)\r\n - Type the following command and press Enter:\r\n\r\n ```bash\r\n pip install segyrecover\r\n ```\r\n\r\n Alternatively, install the latest development version directly from GitHub:\r\n ```bash\r\n python -m pip install git+https://github.com/a-pertuz/segyrecover.git\r\n ```\r\n\r\n3. **Launch the program**:\r\n After installation, simply type:\r\n ```bash\r\n segyrecover\r\n ```\r\n\r\n### First Run Setup\r\n\r\nWhen you run SEGYRecover for the first time:\r\n\r\n\r\n\r\n- You'll be prompted to choose a data storage location\r\n- Choose a location with plenty of disk space\r\n- Example files will be copied to your selected location\r\n- The application will create the necessary folder structure\r\n\r\n### Creating a Desktop Shortcut\r\n\r\n1. Right-click on your desktop\r\n2. Select \"New\" \u2192 \"Shortcut\"\r\n3. Type `segyrecover` (if installed via pip)\r\n4. Click \"Next\" and give the shortcut a name (e.g., \"SEGYRecover\")\r\n5. Click \"Finish\"\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\ud83d\udcc1 Before You Begin</h2></summary>\r\n\r\n### File Organization\r\n\r\nSEGYRecover uses the following folder structure:\r\n\r\n```\r\nsegyrecover/\r\n\u251c\u2500\u2500 IMAGES/ # Store input seismic images\r\n\u251c\u2500\u2500 GEOMETRY/ # Store .geometry files with trace coordinates\r\n\u251c\u2500\u2500 LOG/ # Store log files \r\n\u251c\u2500\u2500 ROI/ # Store region of interest points\r\n\u251c\u2500\u2500 PARAMETERS/ # Store processing parameters\r\n\u2514\u2500\u2500 SEGY/ # Store output SEGY files\r\n```\r\n\r\n### Prepare Your Data\r\n\r\n1. **Place seismic images** in the `IMAGES` folder\r\n2. **Create geometry files** (optional) in the `GEOMETRY` folder with format:\r\n ```\r\n CDP_NUMBER X_COORDINATE Y_COORDINATE\r\n 100 500000.0 4500000.0\r\n 101 500025.0 4500020.0\r\n ```\r\n - Files should have `.geometry` extension\r\n - Same base name as corresponding image files\r\n - Only first and last CDP points needed (software interpolates)\r\n\r\n3. **Verify image quality**:\r\n - Higher resolution images yield better results\r\n - Minimal annotations overlapping seismic data\r\n - Clear trace lines and timelines\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\ud83d\ude80 Quick Start (5 Steps)</h2></summary>\r\n\r\n1. **Launch** \u2192 Run `segyrecover` and click \"Start New Line\"\r\n2. **Load** \u2192 Select your seismic image file\r\n3. **Configure** \u2192 Set parameters (trace coordinates, sample rate, frequency band)\r\n4. **Select** \u2192 Mark three corners of your seismic section (ROI)\r\n5. **Process** \u2192 Click \"Start Digitization\" and wait for completion\r\n\r\nYour SEG-Y file will be saved in the `SEGY` folder and can be loaded into interpretation software.\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\ud83d\udcda Complete Tutorial</h2></summary>\r\n\r\n### Step 1: Loading an Image\r\n\r\n\r\n\r\n1. From the Welcome screen, click **\"Start New Line\"**\r\n2. Click **\"Load Image\"** to select your seismic section file\r\n3. Navigate to your image and click \"Open\"\r\n4. The image displays in the preview area with coordinate file info\r\n5. Click \"Next\" to proceed to Parameters\r\n\r\n> **Note**: The console panel shows image details including dimensions and file path.\r\n\r\n### Step 2: Setting Parameters\r\n\r\n\r\n\r\nConfigure how the software interprets your seismic image:\r\n\r\n1. After loading, you're taken to the Parameters tab\r\n2. Previously saved parameters load automatically if available\r\n3. Fill in the parameter sections below\r\n4. Click **\"Save Parameters\"** to store settings\r\n5. Click **\"Next\"** to proceed to ROI Selection\r\n\r\n#### Region of Interest Corner Points\r\nMap image pixels to seismic coordinates:\r\n\r\n- **P1 (Top Left)**: Trace number and TWT (Two-Way Time) value\r\n- **P2 (Top Right)**: Trace number and TWT value \r\n- **P3 (Bottom Left)**: Trace number and TWT value\r\n\r\n**Example**: \r\n- P1: Trace 100 at 0 ms (top left)\r\n- P2: Trace 500 at 0 ms (top right) \r\n- P3: Trace 100 at 3000 ms (bottom left)\r\n\r\n> **Note**: Use negative time values for data above datum (e.g., -200 ms)\r\n\r\n#### Acquisition Parameters\r\n- **Sample Rate (ms)**: Time between data points (common: 2 or 4 ms)\r\n- **Frequency Band (Hz)**: Four-value bandpass filter:\r\n - F1: Start cutting below this frequency\r\n - F2: Keep everything above this frequency\r\n - F3: Keep everything below this frequency \r\n - F4: Start cutting above this frequency\r\n\r\n**Common Values**:\r\n- Vintage data: F1=8, F2=12, F3=60, F4=80\r\n- Modern data: F1=3, F2=5, F3=80, F4=100\r\n\r\n#### Detection Parameters\r\n- **TLT (Traceline Thickness)**: Vertical trace width in pixels (usually 1)\r\n- **HLT (Timeline Thickness)**: Horizontal timeline height in pixels (4-8)\r\n\r\n#### Advanced Parameters\r\n*Default values work for most images*\r\n\r\n- **HE (Horizontal Erode)**: Timeline removal aggressiveness (100+ px)\r\n- **BDB/BDE**: Trace detection start/end rows from top\r\n- **BFT**: Duplicate trace filtering strictness (0-100%, default 80%)\r\n\r\n### Step 3: Selecting Region of Interest\r\n\r\n\r\n\r\nMark three corners to define the digitization area:\r\n\r\n1. You're automatically taken to ROI Selection after parameters\r\n2. Image displays with corner point selection prompt\r\n3. Use **magnifier** \ud83d\udd0d to zoom to **top-left** corner\r\n4. Click **\"Top-left (1)\"** button, then click desired point\r\n\r\n\r\n\r\n5. Use **Home** \ud83c\udfe0 to return to full view\r\n6. Zoom to **top-right** corner, select **(2)** and click point\r\n7. Repeat for **bottom-left** corner\r\n8. Fourth corner calculates automatically\r\n9. Verify result and click \"Accept\"\r\n10. Click \"Next\" for Digitization\r\n\r\n> **Note**: ROI points save automatically for future reuse\r\n\r\n### Step 4: Processing\r\n\r\nAutomatic processing workflow:\r\n\r\n1. Click **\"Start Digitization\"** to begin\r\n2. Monitor console for step-by-step progress\r\n3. Select CDP direction when prompted\r\n4. Review processing in visualization window\r\n\r\n#### Processing Steps\r\n\r\n**1. Timeline Detection and Removal**\r\n- Isolates horizontal timeline marks\r\n- Removes timelines from original image\r\n\r\n| Timeline Detection Failure | Timeline Detection Success |\r\n|:--------------------------:|:---------------------------:|\r\n|  |  |\r\n| HE parameter too low (200) | Correct isolation (HE=600) |\r\n\r\n**2. Baseline Detection**\r\n- Identifies vertical trace lines\r\n- Shows verification with green baseline overlay\r\n\r\n\r\n\r\n**3. Amplitude Extraction** \r\n- Counts black pixels per row between baselines\r\n- Applies zero-value correction and smoothing\r\n- Uses Akima interpolation for clipped values\r\n\r\n\r\n\r\n**4. Data Processing**\r\n- Resamples to specified sample rate\r\n- Applies bandpass filtering\r\n\r\n**5. SEG-Y Creation**\r\n- Prompts for CDP direction (increasing/decreasing)\r\n- Interpolates coordinates for all traces\r\n- Creates standard SEG-Y with complete headers\r\n\r\n\r\n\r\n### Step 5: Results\r\n\r\n\r\n\r\nView and analyze your digitized data:\r\n\r\n1. Digitized SEG-Y section displays in main view\r\n2. Amplitude spectrum shows frequency content\r\n3. Console provides digitization summary\r\n4. Additional processing options are available via buttons\r\n5. Click \"Start New Line\" for next image\r\n\r\n#### Additional Processing Options\r\n\r\nThe Results tab provides several buttons for further processing and editing of your digitized SEG-Y data:\r\n\r\n**Edit SEGY Header**\r\n- Modify SEGY file headers including acquisition parameters and metadata\r\n- Useful for adding extra information\r\n\r\n**Mute Topography**\r\n- Interactively define a muting surface by clicking on the seismic section\r\n- Remove unwanted shallow data above a specified horizon\r\n- Apply tapering to create smooth transitions\r\n- Useful for removing noise above the topography, ground roll, or other unwanted noise\r\n\r\n**Apply AGC RMS**\r\n- Apply Automatic Gain Control using Root Mean Square method\r\n- Balance trace amplitudes to enhance weaker signals\r\n- Configurable gate length for amplitude averaging\r\n- Helpful for improving visibility of deeper reflections\r\n\r\n**Apply Trace Mixing**\r\n- Enhance signal-to-noise ratio through trace averaging\r\n- Choose between weighted average or median filtering methods\r\n- Configurable mixing window size and weights\r\n- Effective for attenuating random noise while preserving coherent signals\r\n\r\nEach processing option opens a dedicated dialog with preview capabilities, allowing you to see the effects before applying changes. You can choose to save results as new files or overwrite the original.\r\n\r\n#### Accessing SEG-Y Files\r\n- **File \u2192 Open Data Directory** \u2192 navigate to SEGY folder\r\n- File location shown in console panel\r\n- Compatible with OpendTect, Petrel, Leapfrog, Kingdom\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\ud83d\udd27 Troubleshooting and FAQs</h2></summary>\r\n\r\n### Troubleshooting\r\n\r\n#### Poor Timeline Detection\r\n- Increase HE (Horizontal Erode) parameter\r\n- Ensure ROI aligns timelines horizontally\r\n\r\n#### Missing/Extra Baselines\r\n- Adjust TLT to match trace width\r\n- Modify BDB/BDE for cleaner detection areas\r\n- Increase BFT to filter false detections\r\n\r\n#### Noisy/Spiky Data\r\n- Adjust frequency filter parameters (F1-F4)\r\n- Use narrower frequency band\r\n- Check ROI excludes non-seismic elements\r\n\r\n#### Coordinate Issues\r\n- Verify geometry file format (CDP, X, Y)\r\n- Match CDP numbers between geometry and parameters\r\n- Use consistent coordinate system (UTM recommended)\r\n\r\n#### Log Files\r\nCheck `LOG` folder for detailed process logs and error messages.\r\n\r\n### Frequently Asked Questions\r\n\r\n**How can I improve quality?**\r\n- Use highest resolution scans possible\r\n- Experiment with frequency filter settings \r\n- Ensure proper timeline detection/removal\r\n- Make precise ROI selections\r\n\r\n**Batch processing available?**\r\nCurrently processes one image at a time. Use \"Start New Line\" sequentially and save parameters for similar images.\r\n\r\n**No geometry data?**\r\nStill digitizable but SEG-Y lacks real-world coordinates. Create placeholder file with first/last CDP numbers and arbitrary coordinates.\r\n\r\n**Color images supported?**\r\nWorks best with black/white images. Convert color seismic to grayscale/binary before processing.\r\n\r\n### Common Issues\r\n- **Program not found**: Ensure Python added to PATH\r\n- **Missing dependencies**: Run `pip install <package_name>`\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\ud83d\udcc4 Citation</h2></summary>\r\n\r\nIf you use this software in your research, please cite it as:\r\n\r\n```\r\nPertuz, A., Benito, M. I., Llanes, P., Su\u00e1rez-Gonz\u00e1lez, P., & Garc\u00eda-Mart\u00edn, M. (2025a). SEGYRecover: A Python GUI-based tool for digitizing vintage seismic reflection sections into SEG-Y files. Zenodo. https://doi.org/10.5281/zenodo.15053412\r\n```\r\n\r\nFind this software in the Zenodo Archive: [https://doi.org/10.5281/zenodo.15053412](https://doi.org/10.5281/zenodo.15053412)\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\ud83d\udcd6 References</h2></summary>\r\n\r\nSEGYRecover uses several image processing and signal processing techniques. Some of them are covered by previous digitalization programs:\r\n\r\n[1] Miles, P. R., Schaming, M., & Lovera, R. (2007). Resurrecting vintage paper seismic records. _Marine Geophysical Researches_, 28, 319-329.\r\n\r\n[2] Farran, M. L. (2008). IMAGE2SEGY: Una aplicaci\u00f3n inform\u00e1tica para la conversi\u00f3n de im\u00e1genes de perfiles s\u00edsmicos a ficheros en formato SEGY. _Geo-Temas_, 10, 1215-1218. \r\n\r\n[3] Sopher, D. (2018). Converting scanned images of seismic reflection data into SEG-Y format. _Earth Science Informatics_, 11(2), 241-255.\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\u2696\ufe0f License</h2></summary>\r\n\r\nThis software is licensed under the GNU General Public License v3.0 (GPL-3.0).\r\n\r\nYou may copy, distribute and modify the software as long as you track changes/dates in source files. \r\nAny modifications to or software including (via compiler) GPL-licensed code must also be made available \r\nunder the GPL along with build & installation instructions.\r\n\r\nFor the full license text, see [LICENSE](LICENSE) or visit https://www.gnu.org/licenses/gpl-3.0.en.html\r\n\r\n</details>\r\n\r\n---\r\n\r\n*For questions, support, or feature requests, please contact Alejandro Pertuz at apertuz@ucm.es*\r\n",
"bugtrack_url": null,
"license": "GNU GPL-3.0",
"summary": "A Python tool for digitizing scanned seismic reflection sections and converting them to standard SEGY format.",
"version": "1.1.0",
"project_urls": {
"DOI": "https://doi.org/10.5281/zenodo.15053412",
"Documentation": "https://a-pertuz.github.io/REVSEIS/index.html",
"Source Code": "https://github.com/a-pertuz/SEGYRecover"
},
"split_keywords": [
"seismic",
" digitization",
" segy",
" geophysics"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0121e3a2c11ca12970c7b8473cd247a724cb7aabde022a1844868e4ad450b9e3",
"md5": "1306e83a69fb698f5fc68f011fcb3615",
"sha256": "b0fb3f694d87bf5d3ad135dc7202cb46874d1e861d57e2a0698dff15522296ef"
},
"downloads": -1,
"filename": "segyrecover-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1306e83a69fb698f5fc68f011fcb3615",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 3451241,
"upload_time": "2025-07-18T15:22:06",
"upload_time_iso_8601": "2025-07-18T15:22:06.943745Z",
"url": "https://files.pythonhosted.org/packages/01/21/e3a2c11ca12970c7b8473cd247a724cb7aabde022a1844868e4ad450b9e3/segyrecover-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "34726466aff2e2031a3c4aaa692f509606c8361be7f5403fe5e25916421b04b4",
"md5": "58a24a7fe516eb5e0cfbe6281de39395",
"sha256": "09823e64cb2a1c812c664532968d89e1054097e95c47e4dd971601d122bb3678"
},
"downloads": -1,
"filename": "segyrecover-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "58a24a7fe516eb5e0cfbe6281de39395",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 3433420,
"upload_time": "2025-07-18T15:22:09",
"upload_time_iso_8601": "2025-07-18T15:22:09.508198Z",
"url": "https://files.pythonhosted.org/packages/34/72/6466aff2e2031a3c4aaa692f509606c8361be7f5403fe5e25916421b04b4/segyrecover-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-18 15:22:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "a-pertuz",
"github_project": "SEGYRecover",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "segyrecover"
}
