| Name | velrecover JSON |
| Version |
1.1.0
JSON |
| download |
| home_page | None |
| Summary | A tool for building velocity models from the interpolation of sparse velocity analyses |
| upload_time | 2025-07-18 15:22:38 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | GNU GPL-3.0 |
| keywords |
seismic
digitization
velocity
geophysics
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# VelRecover
[](https://doi.org/10.5281/zenodo.15053268)
[](https://www.gnu.org/licenses/gpl-3.0.en.html)
[](https://www.python.org/downloads/)
A Python tool for building velocity models from the interpolation of sparse velocity picks found in seismic sections. VelRecover provides multiple interpolation algorithms in an intuitive GUI for visualization and quality control.
VelRecover 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 (6 Steps)](#quick-start-6-steps)
- [Complete Tutorial](#complete-tutorial)
- [Interpolation Methods](#interpolation-methods)
- [Troubleshooting and FAQs](#troubleshooting-and-faqs)
- [Citation](#citation)
- [License](#license)
</details>
<details open>
<summary><h2>✨ Features</h2></summary>
- **Multiple Interpolation Methods** - Linear, logarithmic, RBF, and two-step interpolation algorithms
- **Velocity Editing** - Tools to add, modify, and delete velocity picks
- **Gaussian Smoothing** - Apply adjustable smoothing to interpolated velocity models
- **Multiple Export Formats** - Save velocity models as text or binary files
- **Velocity Distribution Analysis** - Analyze velocity trends and distributions
- **User-friendly GUI** - Simple workflow with visual guidance for the entire velocity modeling process
</details>
<details>
<summary><h2>💻 System Requirements</h2></summary>
- **Operating System**: Windows, Linux, or macOS
- **Memory**: At least 4GB RAM
- **Python**: 3.8+ (automatically handled if installing via pip)
- **Disk Space**: Sufficient space for velocity data and output files
- **Data Requirements**:
- Velocity data files with 3 columns (CDP, TWT, Velocity)
- SEG-Y files for spatial context (optional but recommended)
</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 VelRecover**:
- Open Command Prompt (search for "cmd" in Windows search)
- Type the following command and press Enter:
```bash
pip install velrecover
```
Alternatively, install directly from GitHub:
```bash
pip install git+https://github.com/a-pertuz/velrecover.git
```
3. **Launch the program**:
After installation, simply type:
```bash
velrecover
```
### First Run Setup
When you run VelRecover for the first time:
- You'll be prompted to choose a data storage location
- 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 `velrecover` (if installed via pip)
4. Click "Next" and give the shortcut a name (e.g., "VelRecover")
5. Click "Finish"
</details>
<details>
<summary><h2>📁 Before You Begin</h2></summary>
### File Organization
VelRecover uses the following folder structure:
```
velrecover/
├── SEGY/ # Store seismic SEGY files
├── VELS/ # Main velocity data directory
│ ├── RAW/ # Store input velocity data files
│ ├── CUSTOM/ # Store edited velocity picks
│ └── INTERPOLATED/ # Store interpolated velocity models
│ ├── TXT/ # Text format outputs
│ └── BIN/ # Binary format outputs
└── LOG/ # Store log files
```
The application automatically creates these folders if they don't exist.
### Prepare Your Data
1. **Place velocity files** in the `VELS/RAW/` folder
2. **Place SEGY files** in the `SEGY/` folder (optional but recommended)
3. **Verify data format**:
- Velocity files: Text files with 3 columns (CDP, TWT, Velocity)
- Example format:
```
CDP TWT Velocity
100 500 1500
200 1000 1800
300 1500 2100
```
- SEGY files: Standard SEG-Y format for corresponding seismic lines
</details>
<details>
<summary><h2>🚀 Quick Start (6 Steps)</h2></summary>
1. **Launch** → Run `velrecover` and click "Start New Project"
2. **Load Data** → Load velocity text file and SEGY file
3. **Edit** → Review and edit velocity picks if needed
4. **Select Method** → Choose interpolation algorithm
5. **Interpolate** → Run interpolation and apply smoothing if desired
6. **Export** → Save velocity model in desired format
Your velocity model will be saved in the `VELS/INTERPOLATED/` folder and can be used for seismic processing and interpretation.
</details>
<details>
<summary><h2>📚 Complete Tutorial</h2></summary>
### Step 1: Loading Velocity Data
*Window for loading velocity data and SEGY files*
1. From the Welcome screen, click **"New Velocity Field"** button
2. In the **Load Data** tab:
- Click **"Load SEGY File"** to provide spatial context for the interpolation
- Click **"Load Text File"** to select your velocity data file (formats: .dat, .txt, .tsv, .csv)
- The velocity picks will be loaded and displayed over the SEG-Y file
- Click **"Show Velocity Distribution"** to visualize the distribution of velocity values
- Click **"Next"** to proceed to the Edit tab
*Velocity distribution plot showing the velocity values vs two-way-time for each trace or CDP in the text file*
> **Note**: Click the **"Show Velocity Distribution"** button to visualize the distribution of velocity values in your data. This can help identify outliers or trends in the data.
### Step 2: Editing Velocity Data
*Data editing interface for cleaning velocity data. New picks have been added at the seismic section bottom.*
In this step, you'll review and edit your velocity data to remove outliers or incorrect velocity picks. You can also add new picks to improve the accuracy of the model:
1. **Apply Time Shift**: Click to shift all velocity picks along the time axis
2. **Edit Pick**: Select a pick and modify its velocity value
3. **Add Pick**: Add new velocity picks at selected Trace and TWT positions
4. **Delete Pick**: Remove selected velocity picks
5. **Save Changes**:
- Click **"Save edits"** and select save location for new velocity picks
- Click **"Continue without edits"** if no changes are needed
6. Click **"Next"** to proceed to interpolation
> **Tip**: Adding picks at depth intervals where velocity changes significantly improves interpolation accuracy.
### Step 3: Interpolation
*Interpolation interface showing the velocity field visualization*
Configure and run the interpolation to generate a complete velocity field:
1. **Select Interpolation Method** from the dropdown:
- **Linear Best Fit**: Simple linear model (V=V0+kt)
- **Linear Custom**: Custom linear model with user-defined coefficients
- **Logarithmic Best Fit**: Natural logarithmic model for compaction effects
- **Logarithmic Custom**: Custom logarithmic model (V=V0+k*ln(t))
- **RBF**: Radial Basis Function for smooth transitions
- **Two-Step**: RBF interpolation followed by nearest neighbor filling
2. **Configure Parameters** (method-specific):
- For custom methods: Set V0 and k coefficients
- For RBF: Choose basis function type
- For Two-Step: Set interpolation parameters
3. **Run Interpolation**: Click **"Run Interpolation"** to process the data
4. **Apply Smoothing** (optional):
- Enter Gaussian blur value (1-100)
- Higher values provide more smoothing
- Click **"Run Interpolation"** again to apply
5. **Review Results**: The velocity field displays as a color-coded grid
6. **Export Results**:
- **"Save Data as TXT"**: Exports as a text file with X, Y coordinates and CDP, TWT, Velocity values
- **"Save Data as BIN"**: Exports in binary format (float32) as a velocity grid (TWT, CDP)
> **Note**: Binary format (.bin) is suitable for direct import into Seismic Unix for migration processing. Text format (.txt) can be imported into most interpretation software.
### Step 4: Results and Export
- **Text Format (.txt)**: Compatible with most interpretation software (Petrel, Kingdom, OpendTect)
- **Binary Format (.bin)**: Direct import into Seismic Unix for migration processing
- Files are automatically saved in the appropriate `VELS/INTERPOLATED/` subdirectories
</details>
<details>
<summary><h2>🔧 Interpolation Methods</h2></summary>
### Linear Models
**Linear Best Fit**
- **Description**: Simple linear model based on best fit for all velocity picks (V=V0+kt)
- **Best for**: Simple velocity fields with gradual changes
- **Advantages**: Fast computation, predictable results
- **Limitations**: May not accurately represent natural velocity trends with depth
**Linear Custom**
- **Description**: Create custom linear model by defining V0 and k coefficients
- **Best for**: When you have prior knowledge of velocity trends
- **Usage**: Enter V0 (initial velocity) and k (gradient) values
### Logarithmic Models
**Logarithmic Best Fit**
- **Description**: Model based on natural logarithmic best fit for all velocity picks
- **Best for**: Simple velocity fields accounting for compaction effects
- **Advantages**: Better represents natural velocity behavior
- **Limitations**: May create unusual values at surface; apply Gaussian blur for better results
**Logarithmic Custom**
- **Description**: Create custom logarithmic model (V=V0+k*ln(t))
- **Best for**: Areas with known compaction trends
- **Usage**: Define V0 and k coefficients based on geological understanding
### Advanced Methods
**RBF (Radial Basis Function)**
- **Description**: Uses radial basis functions to create smooth interpolation surfaces
- **Best for**: Complex velocity fields with irregular sampling
- **Advantages**: Creates natural-looking transitions between sparse points
- **Limitations**: Computationally intensive; may create anomalous gradients without sufficient picks
- **Recommendation**: Add picks at depth to guide interpolation
**Two-Step Interpolation**
- **Description**: First interpolates each trace with velocity picks using RBF, then completes model using nearest neighbor
- **Best for**: Areas with complex geology and lateral velocity variations
- **Advantages**: Handles both lateral and vertical trends effectively
- **Limitations**: Most computationally intensive method
</details>
<details>
<summary><h2>🔧 Troubleshooting and FAQs</h2></summary>
### Troubleshooting
#### Data Loading Issues
- Ensure your text file has exactly 3 columns: CDP, TWT, Velocity
- Leave only one line of comments or headers
- Verify all values are numeric with no text characters
- Check that CDP numbers are reasonable (positive integers)
#### Interpolation Artifacts
- Edit out obvious outliers in your velocity data
- Try different interpolation methods
- Apply Gaussian blur to smooth small-scale artifacts
- Add more velocity picks in areas with poor results
#### Poor Interpolation Results
- **Linear/Logarithmic**: May not suit complex geology; try RBF or Two-Step
- **RBF**: Add more picks at depth; may need smoothing
- **Two-Step**: Computationally intensive but usually most realistic
### Common Issues
- **Program not found**: Ensure Python is added to your PATH
- **Missing dependencies**: Try running `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. (2025b). VelRecover: a Python GUI-based tool for creating velocity models from sparse 2D velocity picks in vintage seismic reflection sections. Zenodo. https://doi.org/10.5281/zenodo.15053268
```
Check the Zenodo repository: https://doi.org/10.5281/zenodo.15053268
</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": "velrecover",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "seismic, digitization, velocity, geophysics",
"author": null,
"author_email": "Alejandro Pertuz <apertuz@ucm.es>",
"download_url": "https://files.pythonhosted.org/packages/c8/91/c6457a9e5c2eb36e6c185ec90557613590eb61445099abe2034db735d3b5/velrecover-1.1.0.tar.gz",
"platform": null,
"description": "# VelRecover\r\n\r\n[](https://doi.org/10.5281/zenodo.15053268)\r\n\r\n\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 building velocity models from the interpolation of sparse velocity picks found in seismic sections. VelRecover provides multiple interpolation algorithms in an intuitive GUI for visualization and quality control.\r\n\r\nVelRecover 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 (6 Steps)](#quick-start-6-steps)\r\n- [Complete Tutorial](#complete-tutorial)\r\n- [Interpolation Methods](#interpolation-methods)\r\n- [Troubleshooting and FAQs](#troubleshooting-and-faqs)\r\n- [Citation](#citation)\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- **Multiple Interpolation Methods** - Linear, logarithmic, RBF, and two-step interpolation algorithms\r\n- **Velocity Editing** - Tools to add, modify, and delete velocity picks\r\n- **Gaussian Smoothing** - Apply adjustable smoothing to interpolated velocity models\r\n- **Multiple Export Formats** - Save velocity models as text or binary files\r\n- **Velocity Distribution Analysis** - Analyze velocity trends and distributions\r\n- **User-friendly GUI** - Simple workflow with visual guidance for the entire velocity modeling process\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, Linux, or macOS\r\n- **Memory**: At least 4GB RAM\r\n- **Python**: 3.8+ (automatically handled if installing via pip)\r\n- **Disk Space**: Sufficient space for velocity data and output files\r\n- **Data Requirements**: \r\n - Velocity data files with 3 columns (CDP, TWT, Velocity)\r\n - SEG-Y files for spatial context (optional but recommended)\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 VelRecover**:\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 velrecover\r\n ```\r\n\r\n Alternatively, install directly from GitHub:\r\n ```bash\r\n pip install git+https://github.com/a-pertuz/velrecover.git\r\n ```\r\n\r\n3. **Launch the program**:\r\n After installation, simply type:\r\n ```bash\r\n velrecover\r\n ```\r\n\r\n### First Run Setup\r\n\r\nWhen you run VelRecover for the first time:\r\n\r\n- You'll be prompted to choose a data storage location\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 `velrecover` (if installed via pip)\r\n4. Click \"Next\" and give the shortcut a name (e.g., \"VelRecover\")\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\nVelRecover uses the following folder structure:\r\n\r\n```\r\nvelrecover/\r\n\u251c\u2500\u2500 SEGY/ # Store seismic SEGY files\r\n\u251c\u2500\u2500 VELS/ # Main velocity data directory\r\n\u2502 \u251c\u2500\u2500 RAW/ # Store input velocity data files\r\n\u2502 \u251c\u2500\u2500 CUSTOM/ # Store edited velocity picks\r\n\u2502 \u2514\u2500\u2500 INTERPOLATED/ # Store interpolated velocity models\r\n\u2502 \u251c\u2500\u2500 TXT/ # Text format outputs\r\n\u2502 \u2514\u2500\u2500 BIN/ # Binary format outputs\r\n\u2514\u2500\u2500 LOG/ # Store log files\r\n```\r\n\r\nThe application automatically creates these folders if they don't exist.\r\n\r\n### Prepare Your Data\r\n\r\n1. **Place velocity files** in the `VELS/RAW/` folder\r\n2. **Place SEGY files** in the `SEGY/` folder (optional but recommended)\r\n3. **Verify data format**:\r\n - Velocity files: Text files with 3 columns (CDP, TWT, Velocity)\r\n - Example format:\r\n ```\r\n CDP TWT Velocity\r\n 100 500 1500\r\n 200 1000 1800\r\n 300 1500 2100\r\n ```\r\n - SEGY files: Standard SEG-Y format for corresponding seismic lines\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\ud83d\ude80 Quick Start (6 Steps)</h2></summary>\r\n\r\n1. **Launch** \u2192 Run `velrecover` and click \"Start New Project\"\r\n2. **Load Data** \u2192 Load velocity text file and SEGY file\r\n3. **Edit** \u2192 Review and edit velocity picks if needed\r\n4. **Select Method** \u2192 Choose interpolation algorithm\r\n5. **Interpolate** \u2192 Run interpolation and apply smoothing if desired\r\n6. **Export** \u2192 Save velocity model in desired format\r\n\r\nYour velocity model will be saved in the `VELS/INTERPOLATED/` folder and can be used for seismic processing and interpretation.\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 Velocity Data\r\n\r\n\r\n*Window for loading velocity data and SEGY files*\r\n\r\n1. From the Welcome screen, click **\"New Velocity Field\"** button\r\n2. In the **Load Data** tab:\r\n - Click **\"Load SEGY File\"** to provide spatial context for the interpolation\r\n - Click **\"Load Text File\"** to select your velocity data file (formats: .dat, .txt, .tsv, .csv)\r\n - The velocity picks will be loaded and displayed over the SEG-Y file\r\n - Click **\"Show Velocity Distribution\"** to visualize the distribution of velocity values\r\n - Click **\"Next\"** to proceed to the Edit tab\r\n\r\n\r\n*Velocity distribution plot showing the velocity values vs two-way-time for each trace or CDP in the text file*\r\n\r\n> **Note**: Click the **\"Show Velocity Distribution\"** button to visualize the distribution of velocity values in your data. This can help identify outliers or trends in the data.\r\n\r\n### Step 2: Editing Velocity Data\r\n\r\n\r\n*Data editing interface for cleaning velocity data. New picks have been added at the seismic section bottom.*\r\n\r\nIn this step, you'll review and edit your velocity data to remove outliers or incorrect velocity picks. You can also add new picks to improve the accuracy of the model:\r\n\r\n1. **Apply Time Shift**: Click to shift all velocity picks along the time axis\r\n2. **Edit Pick**: Select a pick and modify its velocity value\r\n3. **Add Pick**: Add new velocity picks at selected Trace and TWT positions\r\n4. **Delete Pick**: Remove selected velocity picks\r\n5. **Save Changes**: \r\n - Click **\"Save edits\"** and select save location for new velocity picks\r\n - Click **\"Continue without edits\"** if no changes are needed\r\n6. Click **\"Next\"** to proceed to interpolation\r\n\r\n> **Tip**: Adding picks at depth intervals where velocity changes significantly improves interpolation accuracy.\r\n\r\n### Step 3: Interpolation\r\n\r\n\r\n*Interpolation interface showing the velocity field visualization*\r\n\r\nConfigure and run the interpolation to generate a complete velocity field:\r\n\r\n1. **Select Interpolation Method** from the dropdown:\r\n - **Linear Best Fit**: Simple linear model (V=V0+kt)\r\n - **Linear Custom**: Custom linear model with user-defined coefficients\r\n - **Logarithmic Best Fit**: Natural logarithmic model for compaction effects\r\n - **Logarithmic Custom**: Custom logarithmic model (V=V0+k*ln(t))\r\n - **RBF**: Radial Basis Function for smooth transitions\r\n - **Two-Step**: RBF interpolation followed by nearest neighbor filling\r\n\r\n2. **Configure Parameters** (method-specific):\r\n - For custom methods: Set V0 and k coefficients\r\n - For RBF: Choose basis function type\r\n - For Two-Step: Set interpolation parameters\r\n\r\n3. **Run Interpolation**: Click **\"Run Interpolation\"** to process the data\r\n\r\n4. **Apply Smoothing** (optional):\r\n - Enter Gaussian blur value (1-100)\r\n - Higher values provide more smoothing\r\n - Click **\"Run Interpolation\"** again to apply\r\n\r\n5. **Review Results**: The velocity field displays as a color-coded grid\r\n\r\n6. **Export Results**:\r\n - **\"Save Data as TXT\"**: Exports as a text file with X, Y coordinates and CDP, TWT, Velocity values\r\n - **\"Save Data as BIN\"**: Exports in binary format (float32) as a velocity grid (TWT, CDP)\r\n\r\n> **Note**: Binary format (.bin) is suitable for direct import into Seismic Unix for migration processing. Text format (.txt) can be imported into most interpretation software.\r\n\r\n### Step 4: Results and Export\r\n\r\n- **Text Format (.txt)**: Compatible with most interpretation software (Petrel, Kingdom, OpendTect)\r\n- **Binary Format (.bin)**: Direct import into Seismic Unix for migration processing\r\n- Files are automatically saved in the appropriate `VELS/INTERPOLATED/` subdirectories\r\n\r\n</details>\r\n\r\n<details>\r\n<summary><h2>\ud83d\udd27 Interpolation Methods</h2></summary>\r\n\r\n### Linear Models\r\n\r\n**Linear Best Fit**\r\n- **Description**: Simple linear model based on best fit for all velocity picks (V=V0+kt)\r\n- **Best for**: Simple velocity fields with gradual changes\r\n- **Advantages**: Fast computation, predictable results\r\n- **Limitations**: May not accurately represent natural velocity trends with depth\r\n\r\n**Linear Custom**\r\n- **Description**: Create custom linear model by defining V0 and k coefficients\r\n- **Best for**: When you have prior knowledge of velocity trends\r\n- **Usage**: Enter V0 (initial velocity) and k (gradient) values\r\n\r\n### Logarithmic Models\r\n\r\n**Logarithmic Best Fit**\r\n- **Description**: Model based on natural logarithmic best fit for all velocity picks\r\n- **Best for**: Simple velocity fields accounting for compaction effects\r\n- **Advantages**: Better represents natural velocity behavior\r\n- **Limitations**: May create unusual values at surface; apply Gaussian blur for better results\r\n\r\n**Logarithmic Custom**\r\n- **Description**: Create custom logarithmic model (V=V0+k*ln(t))\r\n- **Best for**: Areas with known compaction trends\r\n- **Usage**: Define V0 and k coefficients based on geological understanding\r\n\r\n### Advanced Methods\r\n\r\n**RBF (Radial Basis Function)**\r\n- **Description**: Uses radial basis functions to create smooth interpolation surfaces\r\n- **Best for**: Complex velocity fields with irregular sampling\r\n- **Advantages**: Creates natural-looking transitions between sparse points\r\n- **Limitations**: Computationally intensive; may create anomalous gradients without sufficient picks\r\n- **Recommendation**: Add picks at depth to guide interpolation\r\n\r\n**Two-Step Interpolation**\r\n- **Description**: First interpolates each trace with velocity picks using RBF, then completes model using nearest neighbor\r\n- **Best for**: Areas with complex geology and lateral velocity variations\r\n- **Advantages**: Handles both lateral and vertical trends effectively\r\n- **Limitations**: Most computationally intensive method\r\n\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#### Data Loading Issues\r\n- Ensure your text file has exactly 3 columns: CDP, TWT, Velocity\r\n- Leave only one line of comments or headers\r\n- Verify all values are numeric with no text characters\r\n- Check that CDP numbers are reasonable (positive integers)\r\n\r\n#### Interpolation Artifacts\r\n- Edit out obvious outliers in your velocity data\r\n- Try different interpolation methods\r\n- Apply Gaussian blur to smooth small-scale artifacts\r\n- Add more velocity picks in areas with poor results\r\n\r\n#### Poor Interpolation Results\r\n- **Linear/Logarithmic**: May not suit complex geology; try RBF or Two-Step\r\n- **RBF**: Add more picks at depth; may need smoothing\r\n- **Two-Step**: Computationally intensive but usually most realistic\r\n\r\n\r\n### Common Issues\r\n- **Program not found**: Ensure Python is added to your PATH\r\n- **Missing dependencies**: Try running `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. (2025b). VelRecover: a Python GUI-based tool for creating velocity models from sparse 2D velocity picks in vintage seismic reflection sections. Zenodo. https://doi.org/10.5281/zenodo.15053268\r\n```\r\n\r\nCheck the Zenodo repository: https://doi.org/10.5281/zenodo.15053268\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 tool for building velocity models from the interpolation of sparse velocity analyses",
"version": "1.1.0",
"project_urls": {
"DOI": "https://doi.org/10.5281/zenodo.15053268",
"Documentation": "https://a-pertuz.github.io/REVSEIS/index.html",
"Source Code": "https://github.com/a-pertuz/VelRecover"
},
"split_keywords": [
"seismic",
" digitization",
" velocity",
" geophysics"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1c47719fbf800c6d7c3859079d04926209a66bfaf41cb1e9a314549013ad2d72",
"md5": "b799c46e4b7f10148c7e6c8f305dd6eb",
"sha256": "beccefe9ba4c5ca1258e8bb94e4d37012af0cb324fef56ad99560addd1a1463a"
},
"downloads": -1,
"filename": "velrecover-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b799c46e4b7f10148c7e6c8f305dd6eb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 6838853,
"upload_time": "2025-07-18T15:22:34",
"upload_time_iso_8601": "2025-07-18T15:22:34.803904Z",
"url": "https://files.pythonhosted.org/packages/1c/47/719fbf800c6d7c3859079d04926209a66bfaf41cb1e9a314549013ad2d72/velrecover-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c891c6457a9e5c2eb36e6c185ec90557613590eb61445099abe2034db735d3b5",
"md5": "6c9bf3ac9063e6f99de8d05a50a06bfc",
"sha256": "37609b88af980dffa004e3822eed0706cd4d64952160af24e75fedec5dc79936"
},
"downloads": -1,
"filename": "velrecover-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "6c9bf3ac9063e6f99de8d05a50a06bfc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 6714483,
"upload_time": "2025-07-18T15:22:38",
"upload_time_iso_8601": "2025-07-18T15:22:38.005794Z",
"url": "https://files.pythonhosted.org/packages/c8/91/c6457a9e5c2eb36e6c185ec90557613590eb61445099abe2034db735d3b5/velrecover-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-18 15:22:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "a-pertuz",
"github_project": "VelRecover",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "velrecover"
}
