Copyright (c) 2025 by Dr Jose M. Dominguez All rights reserved. MeasureTool is a free tool for DualSPHysics simulations. DualSPHysics project is an international collaboration between University of Vigo (Spain) and University of Manchester (UK). Redistribution and use in binary form, without modification, are permitted provided that the following conditions are met: * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Redistributions or modifications of source code are not permitted unless expressly authorised, and must retain the above copyright notice, this list of conditions and the following disclaimer. * Neither the name of the MeasureTool nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. MeasureTool v5.4.266.02 (07-05-2025) ===================================== LoadDsphConfig> .../dualsphysics/bin/DsphConfig.xml Information about parameters of execution: MeasureTool Basic options: -h Shows information about parameters -ver Shows version information -opt Loads configuration from a file Define input file : -dirdata Directory with particle data (Part_XXXX.bi4) -filedata File with particle data (file.bi4) -filexml file.xml Loads xml file with information of mk and and other information. The word 'AUTO' can be used to load the xml used in the simulation. -first: Indicates the first file to be computed -last: Indicates the last file to be computed -files: Indicates the number of files to be processed -threads: Indicates the number of threads for parallel execution of the interpolation, it takes the number of cores of the device by default (or using zero value). Define parameters for acceleration or vorticity calculation: -viscoart:v:vbf Artificial viscosity [0-1] (vbf:ViscoBoundFactor) -viscolam:v:vbf Laminar viscosity [order of 1E-6] (vbf:ViscoBoundFactor) -viscoauto Viscosity config. is load from BI4 files (default option) -gravity: Gravity value Set the filters that are applied to particles for interpolation: -onlypos:xmin:ymin:zmin:xmax:ymax:zmax Indicates limits of particles -onlyposfile filters.xml Indicates XML file with filters to apply -onlymk: Indicates the mk of selected particles -onlyid: Indicates the id of selected particles -onlytype: Indicates the type of selected particles +/-all: To choose or reject all options +/-bound: Boundary particles (fixed, moving and floating) +/-fixed: Boundary fixed particles +/-moving: Boundary moving particles +/-floating: Floating body particles +/-fluid: Fluid particles (no excluded) (by default: all, + means include, - means do not include) -onlyzone: Indicates the VRes zone of selected particles Set the configuration of interpolation: -templates Creates example file to be used with -points or -pointspos -points Defines the points where interpolated data will be computed (each value separated by space or a new line) -pointsdef: Definition of points by command line intead of by file. List of equivalences with definitions in external file (POINTS=pt, POINTSLIST=ptls and POINTSENDLIST=ptels): pt=::,pt=::... ptls[x=::,y=::,z=::]... ptels[x=::,y=::,z=::]... -pointspos Defines the position of points where interpolated data will be computed (each line contains the points for one part file, points are defined as x0;y0;z0;x1;y1;z1...) -pointsgeo[:size] Defines the measuring positions starting from vertices in a geometry file (VTK, VTU, VTP, STL or PLY). When size is provided, the triangle mesh is refined to reduce the side size to requested size -meshpoints[:size] Generates triangle mesh starting from the measuring positions when a grid definition was used (only for flow calculation). When size is provided, the triangle mesh is refined to reduce the side size to requested size. -trackmk: Points track the movement of the indicated MK. Only supports -points and -pointsdef options -kclimit: Defines the minimum value of sum_wab_vol to apply the Kernel Correction. Use value >= 2 to disable this correction (default value = 0.5 and 2 for flow calculation) -kcdummy: Defines the dummy value for the interpolated quantity if Kernel Correction is not applied (default value = 0) -kcusedummy:<0/1> Defines whether or not to use the dummy value (default value = 1) -distinter_2h: Coefficient of 2h that defines the maximum distance for the interaction among particles depending on 2h (default value = 1.0) -distinter: Defines the maximum distance for the interaction among particles in an absolute way. Set calculation mode: -vars: Set variables to compute by SPH interpolation (by default). -elevation: Computes fluid elevation and other related variables. -flow: Computes flow. -tke: Computes Turbulent Kinetic Energy. Set the values to be calculated: -vars[:] Defines the variables or magnitudes that are going to be computed as an interpolation of the selected particles around a given position (+ means include, - means do not include) +/-all: To choose or reject all options +/-vel: Velocity +/-rhop: Density +/-press: Pressure +/-mass: Mass +/-vol: Volume +/-idp: Id of particles +/-ace: Acceleration +/-vor: Vorticity +/-kcorr: Kernel sum +/-XXX: Variable defined by the user (by default: vel,rhop,press when elevation/tke calculation is not enabled) Set options for elevation calculation: -elevation[:] Fluid elevation is calculated starting from kernel sum for each point x,y. The threshold value is 0.5 in 3D (0.4 in 2D) by default. -elevationoutput: Output files with fluid elevation values time: Values of elevation for each time (option by default) pos: Values of elevation for each position (x,y) all: Both output files. -hvars[:] Defines height values to be computed (+ means include, - means do not include) +/-all: To choose or reject all options +/-eta: Maximum elevation for each column x,y (like -elevation) +/-eta1: First elevation for each column x,y +/-eta2/3/4: Following elevations for each column (eta2, eta3, eta4) +/-bottom: Fluid bottom for each column x,y +/-depthsum: Sum of depths for each column x,y +/-depthmax: Maximum depth for each column x,y +/-depthlast: Last depth (near surface) for each column x,y +/-depthfirst: First depth (near bottom) for each column x,y +/-depthrhop: Total depth calculated by integral of density at x,y -hsort: Height sort mode: 1:Original, 2:X-Y, 3:Y-X (0 by default) Set options for flow calculation: -flow[:] Compute flow in requested units: 1:m^3/s, 2:l/s, 3:gal/s, 4:gal/min (default units = m^3/s). Set Turbulent Kinetic Energy calculation: -tke Turbulent Kinetic Energy is calculated using the average velocity of selected PARTS Define output files format: -savevtk Generates VTK(polydata) file with the given interpolation points -savecsv Generates one CSV file with the time history of the obtained values -savecsvpart:<0/1> Generates CSV file per PART data instead of variable -savecsvnopos:<0/1> Position not included in CSV file per PART data -saveascii Generates one ASCII file without headers with the time history of the obtained values -createdirs:<0/1> Creates full path for output files (value by default is read from DsphConfig.xml or 1) -csvsep:<0/1> Separator character in CSV files (0=semicolon, 1=coma) (value by default is read from DsphConfig.xml or 0) Examples: MeasureTool -points fpoints.txt -onlytype:-all,fluid -savecsv dataf MeasureTool -points fpoints.txt -vars:press -savevtk visupress