[general]
name=ARSYSplotQGIS
qgisMinimumVersion=3.22
qgisMaximumVersion=3.99
description=Archaeostratigraphic workspace for excavation XYZ points: plan, sections, group filters, kernel density, PNG export and 3D
version=0.2.3
author=Antoni Canals-Salomó (URV IPHES-CERCA)
email=archesystem@iphes.cat
about=ARSYSplotQGIS is a QGIS 3 plugin for archaeostratigraphic reading of excavation point clouds.
    It opens its own window. Plugin layers are not added to the QGIS map canvas or legend.
    Three linked views: plan (X/Y), longitudinal section (X/Z) and transversal section (Y/Z), plus an optional 3D scatter.
    Load data with Import CSV (delimiter auto-detected: comma, semicolon, tab or pipe), Load sample, or Use selected layer.
    Map P1 as the object centre (X, Y, Z). Optionally map P2 and P3 as the two ends of an orientation vector (P2→P3; if P3 is missing, P1→P2).
    A group field (material, level, …) colours the points. Filter with coloured chips (All / None) and X, Y, Z range sliders.
    Adaptive frame: Off keeps the full extent; On zooms canvases to the filtered cloud.
    Draw points (P1), vectors, both, or none. Point size and arrow size apply to all views.
    Density: kernel-density heatmap and/or isolines of the filtered points (Quartic, Triangular, Uniform, Triweight, Epanechnikov).
    Min/Max set the colour stretch from the plan peak and apply it to each view’s own peak (plan, X/Z, Y/Z). Below Min is not drawn. Auto uses a 2 percent cut and 100 percent of each local peak.
    Colour palettes, radius, cell size, isoline count, labels and opacity are adjustable. Density stays inside the plugin.
    Each view has a zoom window and PNG export (title, subtitle, background, 96–600 dpi) with metre axes, grid, scale bar and legend.
    3D is a built-in Qt orbit/pan/zoom scatter. It does not use the QGIS 3D engine and needs no extra Python packages.
    Requires QGIS 3.22 or later (tested on 3.40). Uses only the Python that ships with QGIS, plus the bundled Processing heatmap and contour algorithms.
    No pip packages, no binaries, no internet connection at runtime.
    Sample data (sample.csv) is included: p1x, p1y, p1z, material, categoria, taxo, nivell. Use Load sample.
    Documentation: Help → Plugins → ARSYSplotQGIS, or the README in the code repository (homepage).
    Licence: GNU GPL-2.0-or-later (required by the QGIS plugin repository).
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,3d,csv,points,sections
changelog=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
