Files - msolids/musen GitHub Wiki

---

To increase program flexibility the MUSEN simulation framework stores all data on a hard drive as a set of separate files. In Fig. 1 the structure of used files is shown schematically. All names like SimResults, Materials, etc. are exemplary file names.

Fig. 1. Schematic representation of files used in MUSEN.

The main file SimResults.mdem stores all data related to the current scene (information about particles, their time-dependent motion, walls, etc.). This file is always opened during with write access during simulation or scene modification. This means that, if some file is opened: it cannot be copied, moved or renamed; all modifications in the scene can be automatically saved to the file! If you open scene and delete some data from it, then this data can be automatically removed from the source file.

If you create some scene and save it into MyScene.mdem and you want to perform a new simulation study, then copy file as MySceneSim1.mdem and run simulations with newly created file. This will help to avoid any data loss. File SimResults.coll is an optional file which can be created during simulation (if option Save Collision is activated). It stores information about collisions. If you want to analyze collision data, then this file should have same name as main results file and should be stored in the same folder. Materials.mdb, Agglomerates.madb, Geometries.mgdb – database with materials, agglomerates and geometries.

This module is used for merging several *.mdem files into the one result file.

List of files for merging is contained paths to the *.mdem files which have to be merged into the one result *.mdem file. Files have to be located from the first one to the last one in the list from the top to the bottom respectively. At least two files have to be added for the merging. For handling the list the next functions are available:

• Add: add a file to the list;
• Remove: remove the selected file from the list;
• Remove all: remove all files from the list;
• Up: move up selected file in the list;
• Down: move down selected file in the list;

Path to the result file has to contain the path to final *.mdem file which is generated during the merging process. To select the result file button button is used. In order to load result file after merging checkbox Load result file after merging has to be checked.

Fig. 2: Merge files Tab

This module is used to export simulation results as file in text format (*.txt, more information about this format is given in TextFile). User can choose one of the available modes of exporting data:

• Save all: export all objects and properties for saved time points and all additional information;
• Save selective: export selected objects and properties, apply constraints, distribution by time.

Selective saving mode allows us to export only selected objects and properties (Fig. 3 - Properties Tab) as well as apply constraints for materials, analysis volumes and diameters (Fig. 4 - Constraints Tab). Also, in this mode one can use distribution results by time (Linear interpolation is used to obtain data between saved time points).

Properties Tab:

• Object type: selection of type of objects (Geometry consists of many Triangular walls objects);
• Constant properties: selection of general information about objects and time-independent data;
• Scene info: selection of some additional information of scene;
• Time: selection of specific time interval;
• TD properties: selection of time-dependent data of objects;
• Geometries: selection of information about geometries.

Each property can be obtained for specific time interval, divided into classes (Fig. 1 - Time). Values will be exported for each time point from interval [T_FROM;T_TO] starting from T_FROM with specified time step ∆T. For example for initial data T_FROM = 0 s, T_TO = 5 s,∆T = 1 s, the results will be generated for time points 0, 1, 2, 3, 4, 5 s. To get values for only one specific time point T specify T_FROM = T_TO = T. There is also a possibility to obtain results only for those time points, which were saved during the simulation (thereby avoiding the interpolated results). To update time parameters from current simulation click on the button button.

Constraints Tab:

• Materials: selection of materials available in the materials manager;
• Analysis volumes: selection of analysis volumes (Object is considered in the volume only if all coordinates of the object is in the volume and that is true for all time points);
• Diameters: selection of minimum and maximum of diameters of the objects to be considered.

Fig. 3: Properties Tab of the Export as text Fig. 4: Constraints Tab of the Export as text

Format of the text file is described in TextFileFormat