Repository navigation
Releases
PlotExtractor 2026-11-10
Windows 64-bit build of PlotExtractor from the latest commit on main. Unzip and run PlotExtractor\PlotExtractor.exe - no Python needed. See README.txt in the zip and the User Guide (PDF) attached here.
New tab layout
- Plot Grid Generation - 1a Generate grid, 1b Edit grid, 1c Review crop rows
- IIQ File Conversion
- Plot Extraction - 3a From converted images (indirect), 3b Direct from IIQ
- Tiles Generation - 4a Fixed ground size tiles, 4b Row-based tiles, 4c QA
- Acknowledgements
What's new
- Crop rows in the grid (1a). Crop rows per plot draws the seeder rows in every plot (spacing = plot width / rows, as in PhenoFuse 4.0.7) and saves
<grid>_rows.shp+ CSV. - Resize by % (1b). W % / L % + Apply % change each plot by a share of its own width / length. Rows from a count follow the edited plots when the grid is saved.
- Review crop rows (1c). Make the row lines from the count (fixed spacing) or detect them in the orthomosaic (PhenoFuse row method), page through the plots on the orthomosaic at full detail, move / add / delete / even-space rows, save. York 2025: 5 rows found in all 36 plots in 6 s.
- 3a from converted images. 16-bit TIFFs converted in tab 2 keep their 16 bits; converted frames of another size than the aligned photos are scaled exactly. Crops from 16-bit converted TIFFs are pixel-identical to the 3b crops.
- Raw sensor values (3b). Pixels = Raw sensor values copies each plot box's 16-bit Bayer values from the IIQ with no development (nothing lost or changed; read with LibRaw, no Phase One SDK needed). QA re-reads them: 36/36 identical on York.
- Deflate compression (lossless) is the new default for TIFF / GeoTIFF: 16-bit files ~28 % smaller than LZW (which was larger than uncompressed).
- Native pixel tiles (4a). Tile unit px cuts tiles that are exact copies of the plot image (metre tiles are resampled to one pixel size: 362 of 372 York tiles).
- Experiment (User Guide ch. 10, Technical Report E8): every output format of the direct IIQ extraction compared, the GeoTIFF georeference explained (affine through ground control points: pixels untouched, 4.7 mm mean fit residual), tiles vs plot images, and the original APPN PhaseOne_Pipeline run on the same flight (30/36 plots; same pixels as PlotExtractor with the same box and settings). Scripts and results in
docs/experiments/2026-11-10_iiq_formats.
Requirements
- Windows 10/11 x64. Tabs 2 (GeoTIFF), 3a and 3b need an Agisoft Metashape licence; tabs 1, 4 and 5 do not.
- Tabs 2 and 3b (developed pixels) need the Phase One ImageSDK, which is licensed by Phase One A/S and is not included in this download (see README.txt). 3b with raw sensor values does not need it.
Credits: APPN, The University of Queensland (PhaseOne_Pipeline, MIT), Phase One A/S (ImageSDK), LibRaw (rawpy). Contributors: @IbrahimUWA, @bipulneupane.
PlotExtractor 2026-10-30
Windows 64-bit build of PlotExtractor from the latest commit on main. Unzip and run PlotExtractor\PlotExtractor.exe - no Python needed. See README.txt in the zip and the User Guide (PDF) attached here.
What's new
- Tab 6a - tiles of a fixed ground size. Tile size and overlap are in metres (default 1 m x 1 m). Every tile covers the same ground and has the same pixel size on every plot and within each plot: one output scale per run (the plot nearest the median mm/px, or Output scale). Plots at that scale are exact copies; others are resampled to the common size. Only whole tiles; middle-row tiles laid end to end.
- Tab 6a - tiles that cover the middle rows. With Tile only the middle N rows, Size the tiles to cover these rows measures the row spacing of every plot first and makes one tile size for the run: N x the median spacing + a buffer each side (default 0.05 m), square or a set length along the rows. Every tile holds the N rows and all tiles have the same pixel size (York, 3 rows: 0.744 m = 1310 px; rows inside the tile on 36/36 plots).
rows_report.csvflags any plot whose rows are wider than the tile. - QA pictures for every plot, in every mode (
_rows_qa\or_tiles_qa\), including plots that got no tile, with the reason written on the picture. - Tab 6b - whole rows and row tiles. Choose rows
all,middle Nor1,2,3. Whole rows go to<plot>\rows\, and tiles of a fixed size along each row (default 1 m along x the median row spacing) go to<plot>\row_tiles\row<k>\, over the row's whole length in the plot with no vegetation threshold. All row tiles have the same pixel size; rows running up-down are turned so every tile runs left-right. - Recipe file. Every run writes
PlotExtractor_recipe.json(plot extraction, plot tiles, rows and row tiles; a tiles run also records the extraction it came from). Load recipe... on tabs 4, 6a and 6b repeats the settings. - User Guide: chapter 9 rewritten for 6a/6b and the recipe file; the Otsu figure is redrawn (only clearly green pixels, ExG > 0.05, are green). The demo video has the same redrawn scene.
Tested on the York 2025 calibration trial (36 plots, raw and rectified): 6a 372/360 tiles, all 1761/1685 px (1.000 m); 6b 180 whole rows and 707/718 row tiles, all one size; tiles at the output scale are pixel-identical to the crops; turned tiles' georeference error is 0 mm.
Requirements
- Windows 10/11 x64. Tabs 3 (GeoTIFF), 4 and 5 need an Agisoft Metashape licence; tabs 1, 2, 6, 7 do not.
- Tabs 3 and 5 need the Phase One ImageSDK, which is licensed by Phase One A/S and is not included in this download (see README.txt).
Credits: APPN, The University of Queensland (PhaseOne_Pipeline, MIT) and Phase One A/S (ImageSDK). Contributors: @IbrahimUWA, @bipulneupane.
PlotExtractor 2026-10-27
Windows 64-bit build of PlotExtractor at commit 97add9d. Unzip and run PlotExtractor\PlotExtractor.exe - no Python needed. See README.txt in the zip and the User Guide (PDF) attached here.
What's new
- Tab 5 (IIQ plot extraction): 8 or 16 bit (the same development at 0-255 or 0-65535; Masked or Bounding box style, GeoTIFF/TIFF/PNG) and TIFF compression LZW or none. All TIFF/GeoTIFF files are written with GDAL; no pixel value changes after the Phase One SDK.
- Tab 6 (Training tiles): exact copies. Bits same as plot image (default) keeps every tile identical to its window in the plot image, 8 or 16 bit; 8/16 converts exactly. TIFF is the default format, LZW or uncompressed.
- Georeferenced tiles: each tile is a GeoTIFF with the plot image's coordinates (EPSG:7850 by default).
- Tiles linked to the source photo / IIQ: tile tags and
tile_index.csvrecord the source IIQ, the tile's pixel box in the photo and the IIQ settings. - QA: crops re-developed at their own bit depth; tiles checked pixel by pixel (IDENTICAL / EXACT CONVERSION) and for their georeference.
- Fix: the ground scale of current GeoTIFF crops is now read correctly, so Fix tile ground scale and the end distance in metres work (tile positions can move a few pixels compared with earlier runs; tiles are still exact copies).
Recommended: GeoTIFF, LZW, 8 bit for plot images; tif, same as plot image, LZW, georeference and link on for tiles. In tab 4, keep Auto-fit crop to detected rows off for plot-only crops (it switches the style to Rectified).
Requirements
- Windows 10/11 x64. Tabs 3 (GeoTIFF), 4 and 5 need an Agisoft Metashape licence; tabs 1, 2, 6, 7 do not.
- Tabs 3 and 5 need the Phase One ImageSDK, which is licensed by Phase One A/S and is not included in this download. Set Phase One SDK folder on tab 3/5 to an SDK obtained from Phase One (see README.txt).
Credits: APPN, The University of Queensland (PhaseOne_Pipeline, MIT) and Phase One A/S (ImageSDK). Contributors: @IbrahimUWA, @bipulneupane.
PlotExtractor 2026-10-26
Windows 64-bit build of PlotExtractor at commit 953f2cd. Unzip and run PlotExtractor\PlotExtractor.exe - no Python needed. See README.txt in the zip and the User Guide (PDF) attached here.
What's new
- Tabs numbered in workflow order: 1 Generate plot grid · 2 Edit plot grid · 3 IIQ conversion · 4 Extract plots · 5 IIQ plot extraction · 6 Training tiles · 7 QA · 8 Acknowledgements.
- Edit plot grid is its own tab (move, reshape, grow, width, length, shift on the RGB orthomosaic; correct grid to rows). The grid saved in tab 1 or 2 is the default for tabs 4 and 5; another plots file can still be chosen.
- IIQ plot extraction: each plot developed straight from the Phase One IIQ raw file (approach of the APPN-UQ PhaseOne_Pipeline, extended - see tab 8). Lower noise and more detail than the JPEGs (York 2025: detail/noise 7.4 vs 5.4).
- IIQ conversion: IIQ to TIFF (8/16 bit), georeferenced GeoTIFF or JPEG.
- Frame per plot: whole plot first, else the photo holding the largest part.
- Output CRS defaults to EPSG:7850 (GDA2020 / MGA zone 50), follows the orthomosaic's CRS when one is loaded, and can be changed in every tab.
- QA tab; middle-row training tiles.
Requirements
- Windows 10/11 x64. Tabs 3 (GeoTIFF), 4 and 5 need an Agisoft Metashape licence; tabs 1, 2, 6, 7 do not.
- Tabs 3 and 5 need the Phase One ImageSDK, which is licensed by Phase One A/S and is not included in this download. Set Phase One SDK folder on tab 3/5 to an SDK obtained from Phase One (see README.txt).
Credits: APPN, The University of Queensland (PhaseOne_Pipeline, MIT) and Phase One A/S (ImageSDK). Contributors: @IbrahimUWA, @bipulneupane.
PlotExtractor 2026-09-10
Windows 64-bit build of PlotExtractor at commit 4f36ab8. Unzip and run PlotExtractor\PlotExtractor.exe - no Python needed. Metashape license required for .psx extraction (ortho-only mode is license-free).
Highlights since the previous build:
- Raw native crops are QGIS-ready: affine geotransform + chosen projected CRS (e.g. EPSG:7850) written directly, GCPs preserved in metadata (PE_GCPS / PE_AFFINE_RESID tags).
- Frame selection prefers near-nadir, full-resolution frames (tiered by foreshortening, low-resolution frames demoted) - no more oblique crops sweeping in neighbouring plots.
- 5x5 GCP grid keeps clipped edge plots georeferenced.
- Source ICC profile (e.g. Phase One Adobe RGB 1998) embedded in crops when sRGB conversion is off - colours match the source exactly.
- Loud TINY CROP / wrong-chunk warning when the selected chunk does not match the plot shapefile.
See README.txt inside the zip for quick start.
Plot Extractor v1.0.0
Standalone Windows build and demo videos for Plot Extractor.
Downloads
- PlotExtractor_Windows_x64.zip — one-folder standalone app (no Python needed). Unzip anywhere and run
PlotExtractor.exe. Seedocs/EXE_README.md. - PlotExtractor_Demo.mp4 — 30s tool demo (set up → run → manifest).
- PlotExtractor_Demo_Short.mp4 / PlotExtractor_Demo_editor.mp4 — editor-focused cuts.
Notes
The exe bundles the Metashape engine but not a licence. Orthomosaic-GeoTIFF mode runs anywhere; Metashape-project mode needs a live Agisoft licence reachable at runtime (agisoft_LICENSE).