mupif.org

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{ :wiki:images:mupif-logo-3-color.png?250|}}
====== MuPIF ======

MuPIF is modular, object-oriented integration platform allowing to create complex distributed multiphysics simulation workflows across the scales and processing chains by combining existing simulation tools.   

===== Framework Design =====
A reliable multiscale/multiphysics numerical modeling requires including all relevant physical phenomena along the process chain, typically involving multiple scales, and the combination of knowledge from multiple fields. A pragmatic approach lies in combining existing tools, The approach followed in MuPIF is based on an system of distributed, interacting components designed to solve given problem. The individual components represent entities in the problem domain, including individual simulation packages, high level data, but also the workflows. The abstract classes are introduced for all entities in the model space, defining common interfaces that needs to be implemented by any derived class, representing particular implementation of specific component. Such interface concept allows using any derived class on a very abstract level, using common services defined by abstract class, without being concerned with the implementation details of an individual software component. This essentially allows to manipulate all models, data, and workflows using standardized interfaces. Moreover, as the simulation data are represented by objects as well, the platform is independent on particular data format(s), as the simulation data (such as microstructures, fields and properties) can be manipulated using the same abstract interface. Therefore, the focus on services is provided by objects (object interfaces) and not on underlying data itself. The abstraction allows to treat local as well as remote objects using the same interface making the platform naturally distributed.  
{{ :wiki:images:mupif-map.png?direct&400|MuPIF Features}}

Even though the platform can be used locally on a single computer orchestrating installed applications, the real strength of the MMP platform is its distributed design, allowing to execute simulation scenarios involving remote applications. MuPIF provides a transparent distributed object system, which takes care of the network communication between the objects when they are distributed over different machines on the network. One can just call a method on a remote object as if it were a local object – the use of remote objects is (almost) transparent. This is achieved by using the concept of proxies representing remote objects, which forward the calls to the remote objects and pass the results back to the calling code. In this way, there is no difference between simulation script for local or distributed case, except for the initialization, where, instead of creating local object, one has to connect to the remote object. 



===== Implementation =====
Rather than writing programs, the Python language will be extended by modules, representing interfaces to existing codes, with specific functionality. The emphasis will be on building infrastructure to facilitate the implementation of multi-physic and multi-level simulations. The high-level language serves as a “glue” to tie the modules or components together, to create specialized application. Python language provides the flexibility, interactivity, and extensibility needed for such an approach, thanks to its concise and pseudocode-like syntax, modularity and object-oriented design, introspection and self documentation capability, and the availability of a Numerics extension allowing the efficient storage and manipulation of large amounts of numerical data. The application interface can be conveniently realized by wrapping application code. The process of wrapping code can be automated to a fair extent using SWIG~\cite{Swig}, Boost~\cite{Boost}, or similar tools, which can generate wrapper code for several languages. This approach also allows a single source version of the component code to be maintained. 

====== Documentation ======
  * Online {{::MuPIF-UserManual-1.0.0.pdf|User manual}} and {{::MuPIF-ReferenceManual-1.0.0.pdf|Reference manual}}
  * Three webinars on MuPIF platform design, installation, and use are available on [[http://mmp-project.eu/doku.php?id=public_events|MMP project website]] and also available on YouTube: 
     * [[https://www.youtube.com/watch?v=Q9FRviRo0TE| 1st webinar on Generic platform design]],
     * [[https://www.youtube.com/watch?v=NFmCYtou_hM | 2nd webinar on Build your own API]],
     * [[https://www.youtube.com/watch?v=72vj_Uf5YQo| 3rd webinar on Perform a platform run]].
===== Demonstration of platform use =====
  * [[wiki:examples:thermo-mechanical-demo|Coupled thermo-mechanical analysis]]
  * [[wiki:examples:multiscale-heat-transfer-demo|Multiscale heat transfer]]

===== How to get MuPIF =====
The easiest installation happens through Python Package Index (pip) which takes care of dependencies and installs/updates missing modules automatically. Run as a command
<code>
pip install mupif
</code>
Alternatively, you may download and install MuPIF from [[https://github.com/mupif/mupif.git|git repository]]. You have to take care yourself on depending modules (Pyro4, numpy, scipy, setuptools, enum34, pyvtk, future).
**Note that since June, 2017 the git repository has been migrated to GitHub.** 
===== License =====
MuPIF is available under GNU Library or Lesser General Public License version 3.0 (LGPLv3)
===== Support =====
The GitHub issue subsystem to report any bugs or get a support [[https://github.com/mupif/mupif| MuPIF GitHub page]]
===== Course =====
We offer intensive, one-day course on multi-scale and multi-physics modeling using MuPIF platform. The course covers following topics:
  * Fundamentals of MuPIF philosophy, design, and structure
  * MuPIF installaton on different platforms
  * Application interface explained, connecting existing applications
  * Developping custom simulation scenarios
  * Practical session on platform usage
The cost of the course is 200 EUR/person. Course will be held in Prague at the Czech Technical University. Minimum of 5 participants per course.
===== Authors & Credits =====
Mupif developpers:
  * [[http://mech.fsv.cvut.cz/~bp|Bořek Patzák]] (Lead Developper)
  * [[http://mech.fsv.cvut.cz/~smilauer/|Vit Šmilauer]]
  * Guillaume Pacquaut
  * Václav Šmilauer
  * Former developpers: Daniel Rypl, Jaroslav Kruis
Contact: info@oofem.org

====== Resources ======
  * [[https://www.dropbox.com/sh/judps2lshqnvup8/AAAeOo4Pa6g5rOHfr5PLCXcJa?dl=0|MuPIF Graphical Workflow Editor]], which creates  MuPIF workflow models based on a MuPIF workflow metamodel, generates Python scripts from MuPIF workflow models, and can run MuPIF Python scripts and monitor their executions. 
===== Related tools =====
  * Python Programming Language, [[http://www.python.org/]].
  * Boost  - C++ wrapper generator, [[http://www.python.org/]].
  * Pyro project home page, [[http://pyro.sourceforge.net/]].
===== Related Publications =====
  * B. Patzák, D. Rypl, and J. Kruis. Mupif – a distributed multi-physics integration tool. Advances in Engineering Software, 60–61(0):89 -- 97, 2013 (http://www.sciencedirect.com/science/article/pii/S0965997812001329).
  * B. Patzák. Design of a multi-physics integration tool. In B. H. V. Topping, J. M. Adam, F. J. Pallares, R. Bru, and M. L. Romero, editors, Proceedings of the Seventh International Conference on Engineering Computational Technology, Stirlingshire, United Kingdom, 2010. Civil-Comp Press. paper 127.
  * B. Patzak, V. Smilauer, and G. Pacquaut, presentation & paper “Design of a Multiscale Modelling Platform” at the 15 th International Conference on Civil, Structural, and Environmental Engineering Computing, 1st - 4th of September 2015, Prague (Czech Republic).
  * B. Patzák, V. Šmilauer, M. Apel, R. Altenfeld, L. Thielen, A. Lankhorst, [[http://congress.cimne.com/icme2016/admin/files/filepaper/p67.pdf|Multi-Physics Integration Framework MuPIF – design, operation and application to simulate CIGS thin film growth for photovoltaics]], 2nd International Workshop on Software Solutions for ICME, April 2016, Barcelona, Spain. 

===== Projects using MuPIF=====
  * MuPIF used as modeling platform in H2020 [[http://composelector.net|Composelector]] project
  * Platform is used to simulate the effect of fire on structural response, project GACR 16-18448S
  * Platform has been used to model moisture condensation in tunnels, project [[http://cesti.cz|CESTI]]
  * MuPIF has been used to simulate CIGS selenization and Light conversion in LEDs in EU [[http://mmp-project.eu|MMP]] project.



===== Acknowledgements=====
  * The development of MuPIF has been funded by Grant Agency of the Czech Republic - Projects No. P105/10/1402.
  * The development is at present supported by the EU project [[http://mmp-project.eu/|Multiscale Modelling Platform: Smart design of nano-enabled products in green technologies]], project number 604279.
  * Starting from 2017, the development will be further supported in the frame of EU H2020 project [[http://composelector.net|COMPOSELECTOR: Multi-scale Composite Material Selection Platform with a Seamless Integration of Materials Models and Multidisciplinary Design Framework]].

<WRAP centeralign>
Access counter: <html><a href="http://www.amazingcounters.com"><img border="0" src="http://cc.amazingcounters.com/counter.php?i=3209979&amp;c=9630250" alt="AmazingCounters.com"></a></html> (Since May, 2016)
</WRAP>
mupif.org

User Tools

Site Tools

Page Tools
