Copyright (c) 2025 by Dr Jose M. Dominguez All rights reserved. BoundaryVTK 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 BoundaryVTK 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. BoundaryVTK v5.4.266.02 (07-05-2025) ===================================== LoadDsphConfig> .../dualsphysics/bin/DsphConfig.xml Information about parameters of execution: BoundaryVTK Basic options: -h Shows information about parameters -ver Shows version information -opt Loads configuration from a file -info Shows information of loaded data Load shapes: -loadvtk Loads shapes from vtk files (PolyData). The keyword [CaseName] is replaced by name of case and wildcards are allowed -loadvtk AutoActual Loads shapes from files *_Actual.vtk generated by GenCase v4.0.074 (or higher) -loadvtk AutoDp Loads shapes from files *_Dp.vtk like previous one -onlymk: Indicates the mk of the shapes to be loaded, affects only the previous -loadvtk instruction and can not be used with -onlyid -onlyid: Indicates the code of object of the shapes to be loaded, only affects the previous -loadvtk -changemk: Changes the mk of the loaded shapes to a given value, only affects the previous -loadvtk instruction -loadply: Loads shapes from ply files with indicated mk -loadstl: Loads shapes from stl files with indicated mk Load configuration for a mobile boundary: -filexml file.xml Loads xml file with information of the movement and types of particles. The word 'AUTO' can be used to load the xml used in the simulation when -motiondata or -motiondatatime is used -motiontime:: Configures the duration and time step to simulate the movement defined in the xml file, can not be used with -motiondatatime and -motiondata -motiondatatime Indicates the directory where real times of the simulation are loaded for the mobile boundary Can not be used with -motiontime and -motiondata -motiondata Indicates the directory where motion reference data of moving and floating objects is (PartMotionRef.ibi4) Can not be used with -motiontime and -motiondatatime -motiondatax Same as -motiondata option but loads data with extra frequency (PartMotionRef2.ibi4) -motionfocus: Indicates the mk to fix this body and move the rest around. This option is only available when motion is computed from particle data. Define output files: -savevtk Generates vtk(polydata) files with the loaded shapes -saveply Generates ply file with the loaded information -savestl Generates stl file with the loaded information -savevtkdata Generates vtk(polydata) file with the loaded shapes including mk and shape code -savemotion Generates CSV file with matrix movement from the beginning -saveposmotion::x:y:z Generates CSV file with updated position according movement of mk boundary (simple configuration for one point) -saveposmotion:mk=, Generates CSV file with updated position according movement of mk boundary where points are defined using: pt=::,pt=::... for a simple list of points ptls[x=::,y=::,z=::]... ptels[x=::,y=::,z=::]... ptls and ptels are point grid definitions equivalent to POINTSLIST and POINTSENDLIST respectively (advanced configuration for several points) -onlytype: Indicates the type of selected mk of the shapes to be stored, affects only the previous out option and cannot be combined with other filters (+ means include, - means do not include) +/-all: To choose or reject all options +/-fixed: Boundary fixed particles +/-moving: Boundary moving particles +/-floating: Floating body particles -onlymk: Indicates the mk of the shapes to be stored, affects only the previous out option and cannot be combined with other filters -onlyid: Indicates the code of the object of the shapes to be stored, affects only the previous out option and cannot be combined with other filters -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: BoundaryVTK -loadvtk bound.vtk -savevtk box.vtk -onlymk:10,12 BoundaryVTK -loadvtk *_Actual.vtk -filexml AUTO -motiondata . BoundaryVTK -loadvtk file.vtk -filexml case.xml -motiondata . -saveply motion.ply BoundaryVTK -loadvtk AutoActual -motionfile data/PartFloatMotion.fbi4 -savevtk motion -onlytype:-all,floating BoundaryVTK -motiondata data -saveposmotion:10:0:0:0 result_mk10 BoundaryVTK -motiondata data -saveposmotion:mk=20,pt=0:0:0 result_mk20