[general]
name=ARSYSplotQGIS
qgisMinimumVersion=3.22
qgisMaximumVersion=3.99
description=Archaeostratigraphic workspace for excavation XYZ points: plan, sections, A–B profile, density, Find, PNG export and 3D
version=0.3.0
author=Antoni Canals-Salomó (URV IPHES-CERCA)
email=archesystem@iphes.cat
about=ARSYSplotQGIS is a QGIS 3 plugin developed as the QGIS counterpart of ARSYSplotLite, part of the ArcheSystem archaeological software suite developed at IPHES-CERCA URV.

    It provides an interactive archaeostratigraphic viewer for exploring and visualising the spatial distribution of archaeological remains recorded during excavation, in plan, vertical sections and 3D.

    WORKSPACE AND VIEWS
    - Opens in its own workspace, independent of the QGIS map canvas and layer legend.
    - Three linked 2D views: plan (X/Y), longitudinal section (X/Z) and transversal section (Y/Z).
    - Optional Stretch Z on the section views (vertical exaggeration; tick labels stay in real metres). Off by default.
    - Optional cross-view hover: highlight the same record across the three main panes. Off by default.
    - Optional 3D scatter view (X/Y/Z), with orbit, pan and zoom (plugin Qt viewer — not QGIS 3D).

    DATA AND FILTERING
    - Import CSV (comma, semicolon, tab or pipe) or spreadsheets (.xlsx / .ods / .xls via GDAL/OGR), load sample data or use a selected QGIS point layer.
    - Map P1 (X, Y, Z) as the object position and optionally P2 → P3 to represent orientation vectors.
    - Colour points by group field (material, level, category, taxonomy, etc.).
    - Optional style file to set colour and marker shape per group.
    - Filter by group and X, Y and Z coordinate ranges.
    - Find: exact-word attribute search with hit table and green selection ring.
    - Adaptive frame to fit the full or filtered dataset.
    - Options → To QGIS layer: publish the full loaded table as a project memory layer (filters ignored).

    PROFILE
    - Manual A–B profile on Plan (Wide in cm): vertical prism; LONG/TRANS sections; CSV and To QGIS export.
    - Density and Profile are mutually exclusive on screen; General → Redraw parks both and shows the loaded data.

    DENSITY AND EXPORT
    - Open the Density tab to build the kernel-density surface (no On switch).
    - Heatmaps and isolines, with five kernel functions; isolines include the outer Min edge of the first class.
    - Adjustable radius, cell size, colour palette, Min/Max, isoline count, labels and opacity.
    - Independent zoom and PNG export for each 2D view, with configurable titles, backgrounds and resolution (96–600 dpi).

    REQUIREMENTS
    - QGIS 3.22 or later (tested with QGIS 3.40).
    - Uses the Python environment and Processing algorithms bundled with QGIS.
    - No additional pip packages, external binaries or internet connection required.

    SAMPLE AND DOCUMENTATION
    - Includes sample.csv. Select Load sample to explore the plugin.
    - Documentation: Help → Plugins → ARSYSplotQGIS or the project README (homepage).

    LICENCE
    GNU GPL-2.0-or-later.
tracker=https://github.com/acanals/ARSYSplotQGIS/issues
repository=https://github.com/acanals/ARSYSplotQGIS
homepage=https://github.com/acanals/ARSYSplotQGIS
category=Vector
icon=ArcheIcon.png
experimental=False
deprecated=False
hasProcessingProvider=False
server=False
tags=archaeology,archaeostratigraphy,excavation,stratigraphy,heatmap,kde,isolines,profile,3d,csv,points,sections
changelog=0.3.0
    - Profile: A–B cut on Plan (Wide cm), pick/drag endpoints, LONG/TRANS sections, CSV and To QGIS export
    - Density ↔ Profile mutually exclusive on screen; General → Redraw parks both and shows loaded data
    - Density tab engages the surface (no On switch); isolines include the outer Min edge of the first class
    - Find: exact-word attribute search, hit table, green ring and detail card
    - Options footer → To QGIS layer (full table as project memory layer)
    - Stretch Z and Cross-view default Off
    - PNG page footer: Made by ArcheSystem — ARSYSplotQGIS
    - Clearer tooltips; natural wrapping for long tips (no one-word lines)
    0.2.5
    - Resources: Stretch Z on longitudinal/transversal (Factor, Reset); title Z ×N; tick labels stay real metres
    - Resources: Cross-view hover on the three main panes (linked highlight; Zoom windows excluded)
    - Optional style file: colour and marker shape per group
    - PNG export: Legend title and group glyphs; tall legends in columns below the plot; 50 cm B&W scale bar
    - Filter Reset restores X/Y/Z ranges only (Point size, Draw and groups unchanged)
    - Stretch Z with Density: keep KDE on the canvases; debounce Factor so density and points stay aligned
    - Qt6-ready enums (scoped form; still runs on Qt5 / QGIS 3.x)
    0.2.4
    - Point model: circle, square, diamond, triangles, polygons, star, cross and X (group colour on stroke for cross/X)
    - Sharper markers at small sizes; Fit on main canvases; Zoom window icon toolbar
    - Use selected layer: import P2/P3 vectors with the same field hints as CSV
    - Density: clearer screen/export fill, isoline labels in pt (level labels only when Density is on)
    - Archeo palette default dark→cream; Invert flips the ramp
    0.2.3
    - Density Min/Max: one control for plan, X/Z and Y/Z, applied to each view’s own KDE peak (fixes section peak holes)
    - Density fill stays on the styled KDE raster; isolines are lines only
    0.2.2
    - Use selected layer: private copy, keep the project CRS, prefer the legend switch ON over the focused row
    0.2.1
    - Clear QGIS plugin security scan (no silent except Exception pass/continue)
    0.2.0
    - First stable public release
    - Documentation for plugins.qgis.org (README and in-plugin help)
    - Kernel density: heatmap and isolines, palettes, Min/Max clip, Auto 2 percent cut
    - Kernels: Quartic, Triangular, Uniform, Triweight, Epanechnikov
    - Draw points, P2→P3 vectors, both or none
    - Adaptive frame, zoom windows, PNG export with axes and legend
    - Group colour chips, XYZ range, Reset
    - 3D scatter (Qt; no QGIS 3D, no extra packages)
    - CSV import (P1 centre, optional P2/P3) and bundled sample.csv
    0.1.1
    - Own plugin window (plan, longitudinal, transversal)
    - CSV import to PointZ, group and XYZ filters
    - Point size, wheel zoom, pan, reset, zoom windows
    - QPainter 3D view (no extra dependencies)
    - Plugin layers kept off the QGIS map canvas
    0.1.0
    - First working workspace
