fdsreader 0.9.12

Python reader for data generated by FDS.

FDSReader

Fast and easy-to-use Python reader for FDS data

Installation

The package is available on PyPI and can be installed using pip:

pip install fdsreader

Usage example

import fdsreader as fds

# Creates an instance of a simulation master-class which manages all data for a given simulation
sim = fds.Simulation("./sample_data")

# Examples of data that can be easily accessed
print(sim.meshes, sim.surfaces, sim.slices, sim.data_3d, sim.isosurfaces, sim.particles, sim.obstructions, sim.obstructions[0].get_boundary_data("temperature"))

More advanced examples can be found in the respective data type directories inside of the examples directory.

Configuration

The package provides a few configuration options that can be set using the settings module.

fds.settings.KEY = VALUE

# Example
fds.settings.DEBUG = True

KEY	VALUE	Default	Description
LAZY_LOAD	boolean	True	Load all data when initially loading the simulation (False) or only when specific data is needed (True).
ENABLE_CACHING	boolean	True	Cache the loaded simulation to reduce startup times when loading the same simulation again.
DEBUG	boolean	False	Crash on non-critical errors with an exception (True) or hide non-critical errors (False).

Data structure

Beware that not all attributes and methods are covered in this diagram. For a complete
documentation of all classes check the API Documentation below.

API Documentation

https://firedynamics.github.io/fdsreader/

Meta

• Jan Vogelsang – [e-mail]
• Prof. Dr. Lukas Arnold - [e-mail]

Distributed under the LGPLv3 (GNU Lesser General Public License v3) license. See LICENSE for more information.

https://github.com/FireDynamics/fdsreader

Contributing

1. Fork it (https://github.com/FireDynamics/fdsreader/fork)
2. Create your feature branch (git checkout -b feature/fooBar)
3. Commit your changes (git commit -am 'Add some fooBar')
4. Push to the branch (git push origin feature/fooBar)
5. Create a new Pull Request

Release History

• (unreleased) 1.0.0
  • (First official version will be released after sufficient public testing in beta stage)

Beta (current stage)

• 0.9.12
  • Bugfixes for slcf
• 0.9.11
  • Added option to retrieve coordinates from slices
• 0.9.10
  • Improved slice filtering functionality
• 0.9.9
  • Added bndf support for older versions of fds
• 0.9.8
  • Fixed an issue that caused numpy to crash on Unix-based machines
• 0.9.7
  • Added slcf support for older versions of fds
• 0.9.6
  • Bugfixes for complex geometry
• 0.9.5
  • Fixed issue with invalid pickle files (cache)
• 0.9.4
  • Bugfixes for complex geometry
• 0.9.3
  • Added lazy loading for complex geometry data
• 0.9.2
  • Improved documentation for complex geometry
• 0.9.1
  • Added documentation for complex geometry
• 0.9.0
  • Added rudimentary support for complex geometry

Alpha

• 0.8.3
  • Added collections to documentation
• 0.8.2
  • Fixed slcf examples
• 0.8.1
  • Bugfixes for vents
• 0.8.0
  • Major bugfixes

Pre-Alpha

• 0.7.4
  • Added obst hole support (bndf)
• 0.7.3
  • Added exception handling for optional modules
• 0.7.2
  • Improved slice combination functionality
• 0.7.1
  • Made PyVista (Vtk) requirement optional
• 0.7.0
  • Added automatic version compatibility testing
  • Usability improvements for slcf
• 0.6.5
  • Bugfixes
• 0.6.4
  • Added more convenience functions (mainly filters)
  • Added color-data isof support
• 0.6.3
  • Added some convenience functions (filters, obstruction masks, ...)
• 0.6.2
  • Improved documentation
• 0.6.1
  • Added multimesh part support
• 0.6.0
  • Added part example
  • Added pl3d example
  • Added slcf example
  • Added two bndf examples
  • Added isof example
• 0.5.3
  • Usability improvements for bndf
• 0.5.2
  • Bugfixes for bndf
• 0.5.1
  • Several bugfixes and improvements
• 0.5.0
  • Preparing for alpha release
  • Usability improvements for simulation
  • Usability improvements for part
  • Added devc support (devices)
  • Added part support (particles)
  • Bugfixes for bndf
• 0.4.10
  • Bugfixes for slcf
• 0.4.9
  • Bugfixes for bndf
  • Improved 2D-Slice functionality
• 0.4.8
  • Complete rework of internal reading process (higher performance)
  • Complete rework of bndf
  • Bugfixes (obstructions, extents, simulation)
• 0.4.7
  • Added cache clearing functionality
  • Bugfixes
• 0.4.6
  • Added automatic caching for simulations (significant loading time reduction)
  • Reworked internal slcf data structure
  • Fixed isof reader (now correctly reads in data for all time steps)
  • Connected bndf data to obstructions
  • Simplified instantiation of Simulation objects
• 0.4.5
  • Added multimesh isof support
  • Improved slcf stability
• 0.4.4
  • Bugfixes (bndf and pl3d)
• 0.4.3
  • Bugfixes (slcf and isof)
• 0.4.2
  • Completed API documentation
• 0.4.1
  • Bugfixes (python import issues)
• 0.4.0
  • Added bndf support (boundaries)
• 0.3.0
  • Added multimesh pl3d support
• 0.3.0
  • Added basic pl3d support
• 0.2.0
  • Added isof support (isosurfaces)
• 0.1.2
  • Added numpy support for slices
• 0.1.1
  • Added multimesh slcf support
  • Added API documentation
  • Package available on PyPI
• 0.1.0
  • Added basic slcf support (2D + 3D slices)