This is an old revision of the document!
====== MuPIF ====== {{ :wiki:images:mupif-logo-3-color.png?250|}} 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, to build a customized multiphysics simulation chains. In order to achieve such a modular approach a multiphysics integration framework, called MuPIF has been designed, which provides an underlying infrastructure enabling high-level data exchange and steering of individual applications. ====== Description ====== ===== Framework Design ===== One of the main objectives is to develop an integrated modelling platform targeted to multiscale and multi-physics engineering problems. The approach followed in MuPIF is based on an system of distributed, interacting objects designed to solve given problem. The individual objects represent entities in the problem domain, including individual simulation packages, but also the high level, complex data, such as micro-structures, fields and properties. The abstract classes are introduced for all entities in the model space. They define a common interface 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 and data 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 exchanged data (such as 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}} The complex simulation pipeline developed in MuPIF consists of top-level script in Python language (called scenario) enriched by newly introduced classes. 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&c=9630250" alt="AmazingCounters.com"></a></html> (Since May, 2016) </WRAP>
