Skip to content
Andrés Vieira edited this page Apr 27, 2020 · 8 revisions

This wiki is currently under construction and probably outdated!

This page is a reference for using DesignSPHysics. Use the sidebar menu to see the different sections.

General information

DesignSPHysics is a FreeCAD macro that allows the user to create simulation cases for the fluid simulation software DesignSPHysics.

It can create 3D and 2D scenes delimited by a cube or a plane (limits of case simulation) with all of FreeCAD's functionalities. DesignSPHysics exports the scene in a compatible XML file, with any data needed for GenCase execution included in the save directory. Also, it can load previously saved scenes for further edition.

It supports creating bounds and fluids, floating objects, fillboxes, etc. All from one place.

DesignSPHysics can run simulations and execute post-processing tools from FreeCAD, automating multiple steps and providing a graphical view of the process.

Currently, DesignSPHysics is free to use and can be downloaded from the FreeCAD addon manager.

Installing

Installing DesignSPHysics is pretty straightforward, please check the Installation wiki page.

How to use

You can check the Feature Reference wiki page to learn how the use this software.

If this is also your first time with DualSPHysics (or even with an SPH solver), please also check out the Concepts and Clarifications section, that explains some things that may seem difficult to understand.

Development and technical info

At 05 of November 2019 the development of DesignSPHysics is driven mainly by Andrés Vieira.

DesignSPHysics is a Macro for the parametric 3D modeler FreeCAD. Its entirely made in Python 3.7 (with bits of HTML/CSS for templates) and its meant to be self contained and multiplatform.

This software is tied up to the DualSPHysics suite, as a large part of its functionality is aided with GenCase, DualSPHysics and several post-processing tools.

If you want to contribute to the project or help out finding issues or suggestions, please submit them in here. Any help is welcome :)

Reporting errors and making suggestions

To report errors and make suggestions you have several ways to do it. The best way to do it is to post an issue in the GitHub repository, as it is automatically notified into the developers email and integrated with the version control system.

You can also send an email to [email protected].

If you find a bug or a feature you would like to see improven or replace please try to send all the possible information (like the error details or some screenshots/descriptions on how something could be improved) so it's easier for us to understand.

Don't forget to specify in detail all the steps that took you to encounter the error or in the case of a suggestions, all the details of the suggested feature, patch or fix.

Thanks for contributing!

License

Copyright (C) 2019 EPHYSLAB Environmental Physics Laboratory, Universidade de Vigo EPHYTECH Environmental Physics Technologies

DesignSPHysics is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

DesignSPHysics is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with DesignSPHysics. If not, see http://www.gnu.org/licenses/.