Skip to main content

OpenFLASH ⚡️

Open-source Flexible Library for Analytical and Semi-analytical Hydrodynamics

Project Status: Active – The project has reached a stable, usable state and is being actively developed. Unit Tests codecov License

DOI - entire project DOI - code only GitHub Release PyPI - Version Conda Version

About The OpenFLASH Project

The OpenFLASH project is a Python package designed for solving hydrodynamic boundary value problems using eigenfunction expansion methods. It provides a modular framework for defining complex geometries, setting up multi-domain problems, performing numerical computations, and analyzing results, particularly for linear potential flow hydrodynamics. It can be significantly faster than Boundary Element Method calculations although is restricted to certain geometries (currently axisymmetric compound cylinders).

When referencing this work, please reference our citation.cff.

This project is licensed under the MIT License. See the LICENSE file for details.

Installation

Three common installation options are shown below. For more details, see the installation section of the docs.

Option 1: via pypi (recommended for users who manage environments with venv or similar)

pip install open-flash

Option 2: via conda (recommended for users who manage environments with conda)

conda create -n openflash-env sea-lab::open-flash
conda activate openflash-env

Option 3: via git (recommended for developers)

Note - if you are a developer outside of the SEA Lab, please create a fork and clone your fork.

  1. Clone the repository:
git clone https://github.com/symbiotic-engineering/OpenFLASH.git
cd OpenFLASH
  1. Install the package:
pip install -e .
  1. Install dependencies:
pip install -e .[dev]

Usage

Please see our documentation and tutorial notebook. The documentation provides detailed instructions and API reference for the different modules and classes within the openflash package.

If you prefer not to utilize the package programatically, the model can also be run with an interactive web app (the site may take several seconds to load).

Theory

Please see our equations documentation and references for mathematical background and derivations as well as validation information.

MATLAB

We also have a MATLAB code version, although the Python package is intended as primary for future development. MATLAB only supports bodies consisting of 2 concentric cylinders, rather than the arbitrary N concentric cylinders in the Python package.

See matlab/src/run_MEEM.m for the symbolic and numeric code, see matlab/test/ for some scripts to get results, and matlab/dev for various matlab experiments.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

open_flash-1.0.39.tar.gz (1.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

open_flash-1.0.39-py3-none-any.whl (29.6 kB view details)

Uploaded Python 3

File details

Details for the file open_flash-1.0.39.tar.gz.

File metadata

  • Download URL: open_flash-1.0.39.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for open_flash-1.0.39.tar.gz
Algorithm Hash digest
SHA256 9805f5bdd260dbf07d2d943c0126d3c8385fb6ad5a8b996fd734b6d6e9f3f591
MD5 d3ab57a33b0bf4f07af9fa7131ac03f2
BLAKE2b-256 11a47ee5b04be7ecd18844fe9cd983b032c3cc9388f618b232f3a53367c0f330

See more details on using hashes here.

Provenance

The following attestation bundles were made for open_flash-1.0.39.tar.gz:

Publisher: publish-package.yml on symbiotic-engineering/OpenFLASH

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file open_flash-1.0.39-py3-none-any.whl.

File metadata

  • Download URL: open_flash-1.0.39-py3-none-any.whl
  • Upload date:
  • Size: 29.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for open_flash-1.0.39-py3-none-any.whl
Algorithm Hash digest
SHA256 4632a8905ab47ebb43e8dc663d1ffda97673c7dedcc041b10ae22af1dddae380
MD5 503806b015afc71d119a1fd88301ebe9
BLAKE2b-256 d234c7089577079d34e446c07e5152c130e22eb17738f2530bc8f9afe07f9d60

See more details on using hashes here.

Provenance

The following attestation bundles were made for open_flash-1.0.39-py3-none-any.whl:

Publisher: publish-package.yml on symbiotic-engineering/OpenFLASH

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.0.40

2 files

This release

1.0.39 This release

2 files

1.0.38

2 files

1.0.37

2 files

1.0.36

2 files

1.0.35

2 files

1.0.34

2 files

1.0.33

2 files

1.0.32

2 files

1.0.31

1 file

1.0.30

2 files

1.0.29

2 files

1.0.28

2 files

1.0.27

2 files

1.0.26

2 files

1.0.25

2 files

1.0.24

2 files

1.0.23

2 files

1.0.22

2 files

1.0.21

2 files

1.0.20

2 files

1.0.19

2 files

1.0.18

2 files

1.0.17

2 files

1.0.16

2 files

1.0.15

2 files

1.0.14

2 files

1.0.13

2 files

1.0.12

2 files

1.0.11

2 files

1.0.10

2 files

1.0.9

2 files

1.0.8

2 files

1.0.7

2 files

1.0.6

2 files

1.0.5

2 files

1.0.4

2 files

1.0.1

2 files

1.0.0

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

1 file

0.1.9

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page