# This file contains metadata for your plugin.
# This file should be included when you package your plugin.

# Mandatory items:
[general]
name=Roll
qgisMinimumVersion=3.34
qgisMaximumVersion=4.99
description=Design and analysis of 3D seismic survey geometries
version=0.7.7
author=Duijndam.Dev
email=Bart.Duijndam@ziggo.nl
about:<p>This plugin is intended to create and analyze 3D seismic survey geometries. It is dependent on the following Python packages:<ul>
  <li><b>debugpy</b> (version 1.8.17) <i>if you want to debug GUI- and worker threads</i> </li>
  <li><b>numba</b> (version 0.62.1) Not strictly required, but it <i><b>significantly</b></i> speeds up calculations</li>
  <li><b>numpy</b> (version 1.26.4) <i>should already be installed by QGIS installation</i> </li>
  <li><b>pyqtgraph</b> (version 0.13.7) or higher</li>
  <li><b>rasterio</b> (version 1.4.1) </li>
  <li><b>wellpathpy</b> (version 0.5.2) </li></ul>
  <p>Please install these packages <b>first</b>, using pip from the OSGeo4W command prompt (on Windows)
  <p>Use <b>pip list</b> to detect which packages and versions have already been installed. (E.g. numpy should already be installed)
  <p>Start with installing rasterio (it has quite a few dependencies), followed by numba, pyqtgraph and wellpathpy in that order
  <p>Usage: <b> python -m pip install {package_name}=={package_version}</b>
  <p>
  <p>Whereby rasterio will install (requires) affine, attrs, certifi, chardet, charset-normalizer, click, click-plugins, cligj, and colorama
  <p>And numba will install the llvmlite bindings for the llvm JIT compiler
  <p>
  <p>Please take note:<ul>
  <li>Packages newer than those listed above may have bug fixes (nice) or incompatibilities (not so nice) </li>
  <li>Wellpathpy 0.5.2 solved a deprecation warning in 0.5.0, as a call to 'import pkg_resources' has been removed </li>
  <li>The plugin has not (yet) been tested on Linux or macOS </li>
  <li>The plugin works best on a QHD Screen (2560 x 1440 pixels) or larger </li>
  <li>As of QGIS v3.32, High-DPI UI scaling issues have arisen. See the following discussion on GitHub <a href="https://github.com/qgis/QGIS/issues/53898">here</a> </li> 
  <li>As of version 3.34.6, QGIS upgraded Python from v3.9 to to v3.12 This speeds up calculations and solves some security issues.
  But when <i>upgrading</i> from an earlier QGIS version, it requires installing the above listed packages <b><i>again.</b></i> </li>
  <li>As of version 0.4.6 the plugin is compatible with Qt6. Note that with Qt6 the High DPI scaling issues have been resolved</li>
  <li>As of version 0.6.3 the plugin is compatible with QGIS 4.0. Some numpy attribute names needed to be changed for NumPy 2.0 compatibility</li></ul>
  <p>


tracker=https://github.com/MrBeee/roll/issues
repository=https://github.com/MrBeee/roll
# End of mandatory metadata

# Recommended items:
hasProcessingProvider=no

changelog:   <p>2026-06-09 (0.7.7) Improved CFP implementation, expanded Sphinx documentation
  <p>2026-05-22 (0.7.6) Implemented first step of Sphinx documentation, acessible from F1
  <p>2026-05-20 (0.7.5) Updated readme.md and final cleaning of flake8 warnings when uploading the plugin
  <p>2026-05-19 (0.7.4) Updated metadata project information
  <p>2026-05-19 (0.7.3) Fixed a bug in 'experimental' geometry generation, that caused 'fixed' grids to be interpreted as 'rolling' grids
  <p>2026-05-17 (0.7.2) Fixed a bug in survey's template count, affecting progress message in geometry generation
  <p>2026-05-15 (0.7.1) Added "Shift Survey Location..." dialog. Expanded 3D view for Subset of survey data. Updated Marine Survey Wizard for optimal x-line bin size
  <p>2026-05-06 (0.7.0) Optimization of binning from templates and binning from geometry. Completed Flake8 code clean up
  <p>2026-05-01 (0.6.9) Added TWT option to inline and x-line offset displays. Started to fleece code using Flake8 
  <p>2026-04-30 (0.6.8) Added 3D view for Subset of survey data. Enabled by "Use experimental code" in the Settings dialog. Implemented faster worker thread routines, enabled by the same flag
  <p>2026-04-22 (0.6.7) Improved import and handling of SPS files.
  <p>2026-04-21 (0.6.6) Added 'Max Offset Gap' analysis. Fixed bug crashing app when worker thread was interrupted. Improved readability of items in Parameter tree (property pane).
  <p>2026-04-16 (0.6.5) Added inline and x-line offsets to |offset| plots and mouse tracking in statusbar for all plots. Continued refactoring code.
  <p>2026-04-09 (0.6.4) Added a polar diagram for the offset/azimuth histogram and continued refactoring of code
  <p>2026-03-10 (0.6.3) Some numpy attribute names needed to be changed for NumPy 2.0 compatibility in QGIS 4.0
  <p>2026-03-08 (0.6.2) Mainly internal reformatting of code to make attribute & variable names compatible with QGIS' use of camelCase, rather than snake_case. Some minor tweaks applied
  <p>2026-02-25 (0.6.1) Fixed a bug related to reading boolean values reliably from xml text input
  <p>2026-02-23 (0.6.0) Made Roll a 'standalone' app for testing and debugging purposes. Raised minimum QGIS version to 3.34  
  <p>2026-02-13 (0.5.9) Made fold-map transparent for areas where fold = 0. Added context menu in SPS and Geometry tables, to edit 'in-use' status
  <p>2026-02-10 (0.5.8) Fixed a small bug in copying charts to the clipboard
  <p>2026-02-07 (0.5.7) Updated 'Find and Replace' dialog for direct Xml editing. Fixed enum bugs to ensure Qt6 compatibility
  <p>2026-02-07 (0.5.6) Added 'Preview & Print' to the file menu for the xml file and the pyqtgraph charts. Implemented copy & paste for pyqtgraph charts
  <p>2026-02-06 (0.5.5) Fixed bug in azimuth range in Offset/Azimuth diagram
  <p>2026-02-03 (0.5.4) Improved import and export of SPS data
  <p>2026-01-29 (0.5.3) Fixed pattern management (adding/moving/renaming/removing patterns) in the Property panel
  <p>2026-01-28 (0.5.2) Fixed bug resulting in coverage gaps at block boundaries for multi block (marine) surveys, when working from geometry data
  <p>2025-12-03 (0.5.1) Updated SPS file import and implemented flexible SPS format definition by the end user. Binning can now be done in absence of a relation file (*.xps), using offset limits solely
  <p>2025-09-22 (0.5.0) Some significant changes; progressive painting, keeps UI alive with large survey objects; debugging with Debugpy instead of Debugvs; Well files accessed through relative paths
  <p>2025-09-22 (0.4.9) Small bug fixes related to using - or not using - numba
  <p>2025-09-19 (0.4.8) Use chunked data-access when using very large memory-mapped analysis files
  <p>2025-09-17 (0.4.7) Removed a bug that caused QGIS to crash, when using very large memory-mapped analysis files
  <p>2025-09-12 (0.4.6) The code has been reformatted to be compatible with Qt6. It should still be backwards compatible with Qt5
  <p>2025-06-09 (0.4.5) Accept projects that are created from SPS-data only (i.e. projects that are not template-based)
  <p>2025-06-01 (0.4.4) changed the way SPS source points are shown in QGIS: (point, line) has become (line, point) except for parallel/NAZ surveys
  <p>2025-05-11 (0.4.3) several improvements in transferring data from Roll to QGIS and vice versa. Created html help page in help menu
  <p>2025-03-05 (0.4.2) refactoring of parameter management code, speeding up display in property pane of surveys with many blocks & seed points
  <p>2025-02-22 (0.4.1) implemented feathering in Marine Wizard; enabled selective drawing of survey details (lines and/or points and/or patterns)
  <p>2025-02-15 (0.4.0) updated Marine Wizard; simplifying data structure in case there's no streamer fanning, significantly speeding up property editing
  <p>2025-02-11 (0.3.9) implemented Marine Wizard for streamer surveys and improved Level of Detail (LOD) rendering in Layout pane
  <p>2024-11-02 (0.3.8) improved editing patterns in Property pane and displaying hem in the Pattern tab. 
  <p>2024-10-22 (0.3.7) introduced multiple seeds per pattern, allowing for very complex pattern layout. Ensured backwards compatibility.
  <p>2024-07-27 (0.3.6) added 'pattern' tab for pattern display & analysis. Added convolution with patterns to kx-ky stack response. Fixed an assertion bug in Land Wizard
  <p>2024-07-27 (0.3.5) moved statistics calculations to extended binning. Updated metadata.txt to describe installation of plugin
  <p>2024-07-27 (0.3.4) added "inuse" field to src & rec points in QGIS. Implemented a Categorized Symbol Renderer to display used/unused points in QGIS
  <p>2024-07-24 (0.3.3) interface with QGIS improved. Display active / inactive points separately. Fixed rasterio CRS bug
  <p>2024-07-08 (0.3.2) geometry creation from templates now runs significantly faster. Fixed some bugs in Land Survey Wizard
  <p>2024-06-02 (0.3.1) created a 'display' menu. This allows for closing the display pane, when using (small) full HD monitors. Fixed some bugs
  <p>2024-05-27 (0.3.0) reduced minimal width of Geometry & SPS tables, in order to make working with a <i>smallish</i> full HD (1920x1080) screen easier 
  <p>2024-05-23 (0.2.9) expanded numba @jit functions, added rms-offset plot on Layout tab. Fixed some bugs. Implemented function profiling
  <p>2024-05-04 (0.2.8) implemented numba @jit, to speed up calculations. Added stack response analysis and |O| & O/A Histograms. Fixed some bugs
  <p>2024-04-21 (0.2.7) removed all numba @jit references, as exception handling with numba causes problems. Will revisit later
  <p>2024-04-21 (0.2.6) added 'Analysis' tab, containing seven analysis plots
  <p>2024-04-13 (0.2.5) added TWT values to trace table and implemented 'Unique Fold' capability
  <p>2024-04-08 (0.2.4) improved handling of well-files
  <p>2024-03-30 (0.2.3) updated metadata.txt (a) about text and (b) dependencies
  <p>2024-03-30 (0.2.2) improved handling of line- and stake numbers; refactoring of input parameters
  <p>2024-03-13 (0.2.1) initial release on the QGIS plugin website

# Tags are comma separated with spaces allowed
tags=3D seismic,seismic survey design,SPS data

homepage=https://github.com/MrBeee/roll
category=Plugins
icon=icon.png

# experimental flag
experimental=False

# deprecated flag (applies to the whole plugin, not just a single version)
deprecated=False

# Since QGIS 3.8, a comma separated list of plugins to be installed (or upgraded) can be specified.
# Check the documentation for more information.
# See: https://docs.qgis.org/testing/en/docs/pyqgis_developer_cookbook/plugins/plugins.html
# plugin_dependencies=

Category of the plugin: Raster, Vector, Database or Web
# category=Vector

# If the plugin can run on QGIS Server.
server=False
