Link zu WSL Hauptseite Eidg. Forschungsanstalt für Wald, Schnee und Landschaft WSL

Release Notes

The following list shows a history of the development and the major changes of previous versions of ROXAS.


17 September 2013 - v1.6.0.0

  • ROXAS main window, Batch processing: new option to recalculate output of previously analyzed images. This option is useful when parameter calculation was improved (see below) or extended to quickly create updated Excel output files.
  • ROXAS main window, Summarize ROXAS Output: new option to restrict overall summary to specific years (period).
  • ROXAS main window: periodical appearance of a button to delete the “” file that stores the used spatial calibrations; when this file gets too large, loading and creating spatial calibrations - and therefore analysis in general - slow down.
  • Spatial calibration in cross-sections: the default location of the cross-hair specifying the center of the sample is now in the image center.
  • Manual editing: moved the ‘Change the checkpoint resolution of ring borders to ...’ option to the new ‘Editing Utilities & Options’
  • Manual editing: moved the ‘Show/hide Settings’ option to the ‘Editing Utilities & Options’
  • Manual Editing, Editing Utilities & Options: new option to split the image into overlapping sub-images; this speeds up conduit editing in very large image files and avoids a bug of IPP that does not support the Magic Wand tool for conduit drawing in very large images.
  • Manual Editing, Editing Utilities & Options: new option to represent the outlines of conduit lumina as filled objects and to customize the outline color
  • Manual Editing, Editing Utilities & Options: new option to automatically show and hide conduit outlines for a customizable number of repetitions and a customizable repetition rate
  • Improved algorithm for ring width measurement in rings with oblique and non-parallel borders as often appears towards the stem center. The obliqueness of both the inner and outer ring border is now independently considered. Before, only the obliqueness of the outer ring border was considered, assuming the inner border would run more or less parallel.
  • Improved algorithm for assigning conduits to annual rings: now interpolating between checkpoints of ring borders. Before, conduits were related to the closest checkpoint.
  • Improved algorithm for detection of touching neighboring vessels (vessel grouping): take angle of major axis into account. Before, vessels were always assumed to touch with their flat side (the major axis).
  • New output (in summary file): mean hydraulic diameter
  • New output (in summary file): vessel group size frequency distribution (absolute and relative)
  • New output (in summary file): relative position of largest/smallest conduit and max3 within annual ring
  • Generally streamlined automatic analysis to better handle very large images.
  • Bug fixes and general improvements of stability.


14 March 2013 - v1.5.0

  • ROXAS main window: added function to summarize all ROXAS output files of a folder and together with additional statistics such as percentiles of conduit size, conduit size contributing xy% to theoretical conductivity, conduit size frequency distribution and percentage of grouped conduits depending on conduit size classes
  • Manual editing: enable to draw several missing rings in one go.
  • Manual editing: speed up redrawing of conduit outlines that were added using the trace tool.
  • Manual editing: replaced some of the old instruction windows (draw new ring, split conduits, draw conduits) by windows that can be represented in minimal view and stay in place after moving from the central startup position to a more peripheral position. This avoids obstructing any image target regions when editing
  • Advanced settings: omit conduit grouping analysis if double cell wall thickness is set to 0 to speed up processing. This adjustment may be particularly sensible in coniferous wood
  • Enable writing output in Excel format 2007 and higher (*.xlsx) if present. In Excel 2007 and later, the maximum number of columns and rows is much higher (up to 16,384 columns and 1,048,576 rows), which allows to write data from much larger samples. If you load a previously analyzed image and do some editing, there will be a new *.xlsx output file besides the old *.xls file. The latter can be deleted.
  • Make ROXAS fully independent from MS Windows Regional Settings (allow any regional settings for import/export/exchange of ROXAS settings files and Excel output files). In earlier versions, some Regional Settings (e.g., NL, RU) using comma (",") instead of point (".") as a deliminator for decimal numbers caused problems. 
  • Bug fixes and general improvements of stability.

8 November 2012 - v1.4.0.4

  • Tree cores: implemented automatic origin selection during spatial calibration.
  • Tree cores: improved algorithm that adjusts ring width measurements to inclined (non-horizontal) ring borders; should give more accurate values than before
  • Manual editing: added functionality to change checkpoint resolution of ring borders
  • ROXAS project files (*.rpf) still work even after moving to another folder as long as the associated image and spatial calibration files (*.cal) are moved as well. Before, the image path in the rpf-file had to be updated
  • Bug fixes and general improvements of stability and user friendliness.

5 June 2012 - v1.4.0

  • Decoupled all previously coded species specific settings to settings files (*.rsf) to streamline the ROXAS application file. The settings files are now provided to registered user as part of the installation folder.
  • ROXAS main window: added “Manage calibration files” option to open the user's application folder that contains the settings files (*.rsf) to ease management of ROXAS settings.
  • ROXAS main window: added “Adjust General ROXAS settings” option to change the default startup settings
  • Tree cores, spatial calibration: allow Y origin to be offset >32’768 pixels out of the image. This allows to narrow the specified sector, which improves quality of automatic ring detection.
  • New output parameter: replaced previous "Vessel Multiple Fraction" (VMF) by more intuitive "Mean Group Size of Grouped Vessels" (GSGV), defined as (100-VSF)/VMF
  • Settings window, Annual ring recognition: added smaller steps in “Steps of ring border trajectories” to improve accuracy of ring tracing in very long images.
  • Advanced Settings window, Miscellaneous: added "Color of vessel outlines" option
  • Bug fixes and general improvements of stability and user friendliness.

5 September 2011 - v1.3.0

  • Implemented ROXAS Pro with full functionality vs. ROXAS Basic version without batch processing functionality.
  • Added control for parenchyma analysis in ROXAS main window.
  • Manual editing: implemented Undo option for the last ring and vessel editing operation.
  • Improved output of AOI-based analysis: area-sensitive statistics calculated on AOI area-level in global and annual ring output.
  • Improved ROXAS setup file.
  • Completely re-structured and extended ROXAS Reference Manual.
  • Bug fixes and general improvements of stability and user friendliness.

21 March 2011 - v1.2.0

  • Decoupled ROXAS species settings file from compiled version and made it accessible as text-file. The settings files are listed in ROXAS main window > species selection field.
  • Added additional options in Advanced window to include all relevant parameters needed for adjusting to a new species.
  • Excel output file adjusted to include all relevant parameters in settings tab. Layout is identical to settings text file and may be copy-pasted into a text file to create a new settings file (extension: *.rsf).
  • Allow user to define additional AOI’s (besides sector and xylem outline) to which analysis should be limited. In tree cores this may be useful to follow xylem outline (mask around core) or to select tracheid files. Vessels at the AOI borders that may be cut-off are either fully included or excluded depending on there center coordinates. All relevant AOI-level parameters that cannot be easily derived from other statistics are written separately to the output file.
  • Improved local contrast enhancement in image processing.
  • Added Roxas.ini file which contains easily changeable running options that are not associated with species settings files, e.g. the default species on start-up.
  • Bug fixes and general improvements of stability and user friendliness.

8 March 2011 - v1.1.3

  • Cross-sections: use trace circumference that are manually drawn by the user as the outmost ring boundary.
  • Cross-sections: automatically delete vessels (manually) drawn outside of specified angular sector and very small vessels that are most likely artifacts of manual vessel splitting/drawing.
  • Delete vessels outside of outmost ring that may be present due to manual editing or by the small interpolation difference between xylem outline and outmost ring trace.
  • New parameter: potential hydraulic conductivity.
  • New parameter: vessel grouping index, vessel solitary fraction and vessel multiple fraction (sensu Carlquist 1988/2001)
  • Manual editing: allow selecting multiple ring traces to delete in one go.
  • Manual editing: new tool to delete several vessels within a user-defined AOI.
  • Manual editing: allow multiple vessel tracing in one go.
  • Adjusted to Excel 2007 and later: Excel 97-2003 (*.xls) used as default file format.
  • Bug fixes and general improvements of stability and user friendliness.

16 January 2010 - v1.1.2

  • Created ROXAS installation file including all required ActiveX components and DLL that might not be installed on host machine.
  • Adjusted to IPP 6.x: >100’000 objects/vessels can be recognized.
  • Several minor bug fixes in batch processing

12 December 2008 - v1.1.0

Main window:

  • Added several control options for the way Analysis should be performed:
  • "Tree core(Y) Cross-section (N)", "Consider outline trace in analysis" (only available/relevant in cross-sections!), "Find outline automatically" (only available in cross-sections!); "Only global xylem analysis", "Extended visual output"
  • Added a batch spatial calibration functionality.
  • Added option to prepare project file for batch running the automatic analysis of several images.
  • Added a batch tool for running the automatic analysis of several images.

Automatic analysis:

  • Cross-sections: implemented stepwise analysis of sub-regions in large images to prevent crash in IPP 4.5 when >16,384 objects are found during vessel extraction.
  • Improved vessel extraction algorithm.

Manual editing:

  • Added button to only update outlines. Give user choice to re-edit after updating (useful in cases where manipulation errors occurred).
  • Allow consecutive hitting on junk objects to delete them.
  • Added function to split merged vessels.
  • Added option to only output essential visual data and not update/draw illustrating images that show Earlywood vessels, Earlywood Border vessels and assignment of vessels to rings.

User friendliness, system stability:

  • Allow to load previously saved annual ring boundaries and vessel outlines accessible for re-editing.
  • cross-sections: save and re-use manually drawn xylem outlines
  • Generally improved user guidance and information
  • Bug fixes and general improvements of stability and user friendliness

12 February 2008 - v1.0.3

  • Cross-sections: polar grid laid over source image to ease the selection of the sector to analyze.
  • Tree cores: implemented stepwise analysis of sub-regions in large images to prevent crash in IPP 4.5 when >16,384 objects are found during vessel extraction.
  • Cross-sections: algorithm to approximate outline trace. The radial changes in the tangential direction are used to guide algorithms in “Annual Ring Determination”. This will improve handling of eccentric roots.
  • Added button to allow the user to show/hide the outlines of vessels in i) “Settings”-window > “Vessel Extraction”-tab and ii) “Manual Correction”-window. The user can now flip between vessel outlines on/off, which will ease distinction of wrong and true vessels during calibration and manual corrections.
  • Automatically load the Annotation window when needed in “Manual Editing”.
  • Improved writing of data output to Excel. Now 25x faster than before.
  • Bug fixes and general improvements for stability and user friendliness.

30 June 2007 - v1.0.0

  • First fully functional version with manual editing functionality released.

18 November 2004 - v0.0.7

  • Prototype finished.