Wiki »

Release history

Download latest version or go to Files for other versions. In Files we only keep latest build of every minor version.

AMAPVox 1.10

Moved post-processing functions to R package.
Separated AMAPVoxGUI and AMAPVox JARs.
Shared voxel space for multiple scans voxelization.
New command line syntax.

  • AMAPVox 1.10.4 (2022-07-25)
    • Bugfix in LAS reader, latest points were omitted (< 100)
    • Bugfix in GUI for cubic voxels
    • Bugfix in GUI to add shot and echo filters
    • Bugfix in XYB reader to clean header from multiple spaces.
  • AMAPVox 1.10.3 (2022-05-04)
    • Bugfix concurrent access of voxels in voxel space
    • Deprecated SUBSAMPLING output variable
  • AMAPVox 1.10.2 (2022-04-22) FLAWED
    • Bugfix in concurrent access to transmittance and attenuation records in voxelization.
    • Removed leaf angle distribution components in both GUI and configuration.
  • AMAPVox 1.10.1 (2022-04-19) FLAWED
    • Shared voxel space for multiple scans.
    • Separated AMAPVox and AMAPVoxGUI executables.
    • Moved VoxelSpace merging to R package.
    • Moved LAI raster output to R package.
    • New command line syntax.
  • AMAPVox 1.10.0 (2022-03-30)
    • Moved PAD calculation, butterfly removal, NaN filling, cropping, ground energy calculation to R package.
    • Ground distance computed for every voxel, even for empty ones.
    • Reorganized voxelisation XML configuration file.

AMAPVox 1.9

Updated RiVLib library for reading RIEGL point clouds. Replaced JLas library by new LASzipJNA library based on LAStools/LASzip.

  • AMAPVox 1.9.3 (2022-01-14)
    • Echo weight table not limited to seven echoes anymore, though default weights only go up to 7 echoes.
    • Shots with more echoes than maximum number of echoes in echo weight table are discarded (with warning message).
  • AMAPVox 1.9.2 (2022-01-10)
    • Bugfix in echo weight checks.
  • AMAPVox 1.9.1 (2022-01-07)
    • Replaced JLas library by LASzipJNA library
  • AMAPVox 1.9.0 (2021-11-22)
    • RiVLib 2.5.10 for Windows 32 & 64 bit and Linux 64 bit

AMAPVox 1.8

New GUI for the configuration editor.

  • AMAPVox 1.8.2 (2021-10-13)
    • Added butterfly remover as a post-processing option in voxelization process.
  • AMAPVox 1.8.1 (2021-10-04)
    • Bug fixes in GUI.
  • AMAPVox 1.8.0 (2021-09-24)
    • New GUI for the configuration editor.

AMAPVox 1.7

Added support for XYB format. Added multiple scans support for PTG and XYB formats. New attenuation maximum likelihood estimator based on potential path length. Allow cuboid voxels.

  • AMAPVox 1.7.6 (2021-06-22)
    • Bugfix in voxel readers
    • Bugfix in vertical profile viewer
  • AMAPVox 1.7.5 (2021-06-17)
    • Cuboid voxels
  • AMAPVox 1.7.4 (2021-03-30)
    • Bugfix in Canopy Analyzer tool for generating sensor position from voxel file
    • New missing voxel check in GUI for Canopy Analyzer and Transmittance Light Map tools.
  • AMAPVox 1.7.3 (2021-01-13)
    • Bufgixing in XYB format that always set scanner position to (0, 0, 0). Scanner position is now correctly taken into account.
    • Unified ALS and TLS configurations. Any voxelisation configuration now accepts multiple scans. Such change does not reflect yet on the GUI.
    • Distinguished logging messages in multiscan mode.
  • AMAPVox 1.7.2 (2020-12-01)
    • Added two laser specifications for enforcing unitary beam section for either mono or multi echo (debugging purpose)
    • Bugfix for monoecho mode, intercepted beam fraction of first echo always 1, no matter the weighting table of whether there are actually multiple echoes.
    • Bugix in merging attenuation MLE FPL variables, NaN values properly handled.
  • AMAPVox 1.7.1 (2020-11-25)
    • Added new attenuation maximum likelihood estimator based on potential path length
    • New output variable attenuation unbiased maximum likelihood estimator based on free path length
    • Output variable "weighted free path length" renamed into "weighted effective free path length"
    • Output is now and output path for both TLS and ALS voxelisation.
    • Backward compatibility with deprecated laser names.
    • Bug fixing in GUI
  • AMAPVox 1.7.0 (2020-11-19)
    • Added support for XYB format.
    • Added multiple scans support for PTG and XYB formats.
    • Improved chart drawing GUI

AMAPVox 1.6

Updated all dependencies. Bugfixing. Updated attenuation biais correction factor.

  • AMAPVox 1.6.4 (2020-10-30)
    • Fixed attenuation bias correction factor.
    • List of output variables automatically generated in GUI
  • AMAPVox 1.6.3 (2020-10-15)
    • Included HDF5 dependencies in a local maven repository. Of no consequence for end user, useful for developers only.
  • AMAPVox 1.6.2 (2020-10-05)
    • Missing voxel were not handled in Canopy analyzer tool (LAI2000/LAI2200). Fixed.
  • AMAPVox 1.6.1 (2020-07-27)
    • Updated calculation of the attenuation bias correction factor (F.Pimont multiecho4).
    • Fixed voxel file merging: ground value set to NaN for empty voxel, identical voxel index in merged and individual files.

AMAPVox 1.5

Automatic updater of the XML configuration file. Improved ergonomics of the 3D viewer. Bugfixing.

  • AMAPVox 1.5.6 (2020-06-05)
    • New advanced features for exporting path lengths.
    • Added new BETA button in GUI
    • Reorganized XML configuration files with new input and output elements.
  • AMAPVox 1.5.5 (2020-05-28)
    • Fixed a bug in voxel file merging: skip empty voxel option (from 1.5.1) was not handled correctly.
    • Updated RIEGL RivLib library to version 2.5.9 (Linux only)
  • AMAPVox 1.5.4 (2020-04-17)
    • Added "Apply VOP matrix" checkbox in pointcloud filter
    • Fixed multithreading for TLS voxelisation from command-line
    • Bugfix in merging routine
    • Moved legacy filter elements (false empty shot, dtm, pointcloud) under filters element
  • AMAPVox 1.5.3 (2020-04-02)
    • Several small bug fixes in the GUI
  • AMAPVox 1.5.2 (2020-03-20)
    • Fixed a bug in PTX voxelisation (SOP matrix was ignored)
    • Clarified transformation matrix calculation in the GUI transformation tab.
  • AMAPVox 1.5.1 (2020-02-28)
    • Fixed a bug in LAZ reader
    • Deleted ALS multiple files voxelization mode.
    • Limited size of the log
    • Added option to skip writting empty voxels in vox file
    • Added option to write only ground energy output and skip vox file
  • AMAPVox 1.5.0 (2020-01-30)
    • Added automatic updater of the XML configuration files
    • Fixed voxel file cropping tool.
    • Fixed ground energy calculation
    • Improved 3d viewer ergonomy

AMAPVox 1.4

Replaced internal math library with vecmath. Mixed approach for estimation of the transmittance.

  • AMAPVox 1.4.3 (2019-12-09)
    • ALS integrity checks are now controlled by user.
    • AMAPVox.bat and .sh now takes command line arguments.
    • Voxelisation from SHOT files (.sht) now works from command line.
    • New output variable "weighted free path length"
  • AMAPVox 1.4.2 (2019-11-15)
    • Mixed approach for numerical estimation of the transmittance: unrestricted accuracy by default (requires to store every ray crossing a voxel) and fallback mode when memory cost is too high with limited precision.
    • Updated calculation of the bias correction factor of the attenuation coefficient.
    • New default ALS echo attenuation factors, identical to the TLS weights.
  • AMAPVox 1.4.1 (2019-09-26)
    • Updated VoxtoObj export tool.
  • AMAPVox 1.4.0 (2019-09-06)
    • Removed points, vectors and matrix related classes from commons-math library and replaced by vecmath library.

AMAPVox 1.3

New propagation algorithm that estimates directly the attenuation coefficient following F. Pimont's method. New GUI layout.

  • AMAPVox 1.3.5 (2019-07-30)
    • Experimental feature: numerical estimation of the transmittance with fixed set of values from scractch. Accurate, low on memory usage, high on computational power, limited fraction digits. Big toll on computational power for limited numerical precision may lead to abandon this approach (provided that we find a better one).
  • AMAPVox 1.3.4 (2019-07-30)
    • Bug fixing: drawing vegetation profile was broken since 1.3.0. Improved voxel file parsing error handling.
  • AMAPVox 1.3.3 (2019-07-25)
    • Experimental feature: numerical estimation of the transmittance can be splitted in intermediary estimations. Reasonnable memory usage (depends on parameters though), low computational power, unlimited fraction digits, poor accuracy. Poor accuracy will lead to abandon this approach.
  • AMAPVox 1.3.2 (2019-07-23)
    • Rewrote LAS/LAZ shot creation process.
  • AMAPVox 1.3.1 (2019-07-12)
    • New GUI layout.
  • AMAPVox 1.3.0 (2019-07-12)
    • New feature: voxelisation algorithm redesigned to suit F. Pimont's method.

AMAPVox 1.2

New propagation algorithm. Improved approximated computation of the transmittance and numerical estimation of the transmittance.

  • AMAPVox 1.2.20 (2019-07-08)
    • New feature: shot consistency filter allows to discard shot with blank echo(es).
  • AMAPVox 1.2.19 (2019-07-06)
    • New feature: new automatic merge mode - weighted mean (nSampling as weight) - set for output variables angleMean, distLaser, sdLength, attenuation and attenuation_biasCorr.
  • AMAPVox 1.2.18 (2019-07-06)
    • New feature: exploration rate handled by vox file merging.
    • Bug fixing: output variable bsPotential (free propagation) was not set to zero for below ground voxel.
  • AMAPVox 1.2.17 (2019-06-27)
    • New output variable: exploration rate (ranging 0, 1) quantifies the sampling intensity at sub voxel scale. New user defined parameter sub voxel division.
  • AMAPVox 1.2.16 (2019-06-27)
    • Bug fixing: output variable distLaser returned inconsistent values (too big).
    • Bug fixing: got rid of +Inf values in attenuation output variable
  • AMAPVox 1.2.15 (2019-06-19)
    • New feature: Attenuation coefficient from F. Pimont. Variable attenuation is the biased estimation. Variable attenuation_biasCorr is the correction factor. Bias corrected attenuation = attenuation - attenution_biasCorr.
  • AMAPVox 1.2.14 (2019-06-25)
    • Internal organization: new separated launcher module and new packaging.
  • AMAPVox 1.2.13 (2019-06-21)
    • Bug fixing: 3D visualization window now closes properly.
  • AMAPVox 1.2.12 (2019-06-19)
    • Bug fixing: removed unnecessary computation when numerical estimation of the transmittance is disabled
  • AMAPVox 1.2.11 (2019-06-18)
    • New output variable: mean distance to laser, the mean distance of voxel centre to shot origin.
    • New output variable: the standard deviation of the ray length distribution inside a voxel.
  • AMAPVox 1.2.10 (2019-05-29)
    • Bug fixing: float precision issues in the voxelization that lead to NAN transmittance when bsEntering==bsIntercepted instead of zero.
    • New feature: number of fraction digits in voxel file is user defined
  • AMAPVox 1.2.9 (2019-05-28)
    • New feature: added NetCDF3 output format for voxel file.
  • AMAPVox 1.2.8 (2019-05-17)
    • Bug fixing: Updated Voxel file merging to handle properly NaN values.
  • AMAPVox 1.2.7 (2019-05-06)
    • Bug fixing: Upated the RSP scan selector so that is handles RSP project without MON scan.
  • AMAPVox 1.2.6 (2019-05-03)
    • Bug fixing: averaged output variables (angleMean, lMeanTotal, transmittance, PadBVTotal) set to NaN in unsampled voxel.
  • AMAPVox 1.2.5 (2019-05-03)
    • New feature: optional output variables.
  • AMAPVox 1.2.4 (2019-04-12)
    • Renamed output variables "bvEntering" into "bsEntering", "bvIntercepted" into "bsIntercepted and "bvPotential" into "bsPotential".
  • AMAPVox 1.2.3 (2019-04-05)
    • Bug fixing: corrected the computation of the output variable bvPotential, the potential beam fraction.
  • AMAPVox 1.2.2 (2019-03-08)
    • Bug fixing: command line launcher fully detached from JavaFX
  • AMAPVox 1.2.1 (2019-02-14)
    • Bug fixing: command line launcher exits properly when all tasks have executed.

AMAPVox 1.1

Adressed issues in the voxelization algorithm and added new filters.

Biased approximation: Tr = [sum(BFOut * l * S) / sum(BFIn * l * S)]^(n/sum(l))
New approximation: Tr = [sum(BFOut * S) / sum(BFIn * S)]^(n/sum(l))

The XML configuration file differs from 1.0 version: 
1.0.*: <ponderation mode="0/1">
1.1.*: <ponderation byrank="false/true">

  • AMAPVox 1.1.9 (2019-04-24)
    • Upated the RSP scan selector so that is handles RSP project without MON scan.
  • AMAPVox 1.1.8 (2019-04-24)
    • Renamed output variables bvEntering, bvIntercepted & bvPotential (beam volume) into bsEntering, bsIntercepted & bsPotential (beam surface).
  • AMAPVox 1.1.7 (2019-02-14)
    • Fixed the command line launcher to exit properly when all tasks have executed.
  • AMAPVox 1.1.6 (2019-02-13)
    • Secured the echo filter from CSV file by discarding any shot with mismatch between number of echoes in the shot and the CSV file.
    • Added "shot integrity" filter that checks whether the echoes are locating at increasing distance from the source and discard the shot otherwise.
  • AMAPVox 1.1.5 (2019-01-22)
    • Added numerical estimation of the transmittance.
  • AMAPVox 1.1.4 (2018-11-21)
    • Added a free propagation algorithm that propagates the shots ignoring the echoes (thus the vegetation) and saving this potential beam section in the .vox file as bvPotential variable.
  • AMAPVox 1.1.3 (2018-11-20)
    • Updated the propagation algorithm: the optical ray in the voxel containing the last echo is not extended until the edge of the voxel. In AMAPVox <= 1.1.2 the transmittance might be slightly overestimated because of this unjustified extension.
  • AMAPVox 1.1.2 (2018-11-13)
    • Fixed bugs in the shot angle computation and the beam section computation.
  • AMAPVox 1.1.1 (2018-11-12)
    • Fixed the approximated computation of the transmittance.
  • AMAPVox 1.1.0 (2018-11-07)
    • New features: 1. echo filtering by rank, 2. correction of echo attenuation factor by shot id & 3. shot decimation filter given an offset and a decimation factor

AMAPVox 1.0

First releases by Julien Heurtebize.

  • AMAPVox 1.0.2 (2018-05-04)
    • Minor modifications from Philippe Verley. Moved the sources back to amap-dev.cirad.fr and gathers all the dependencies into a single Maven project with multiple modules. Fixed the JOGL library for some AMD graphic cards on Linux.
  • AMAPVox 1.0.1 (2017-05-12)
    • First public release by Julien Heurtebize, available on the main Wiki page or the Files tab.

Retrieve specific version

If you would like to retrieve a specific version number that is not available for download anymore, here is how you should proceed:

git clone http://amap-dev.cirad.fr/git/amapvox.git
git checkout amapvox/1.#.# (e.g. git checkout amapvox/1.2.9)
cd AMAPVox
mvn install

The zip is generated in target/ folder.