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.40.tar.gz (2.0 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.40-py3-none-any.whl (36.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: open_flash-1.0.40.tar.gz
  • Upload date:
  • Size: 2.0 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.40.tar.gz
Algorithm Hash digest
SHA256 b951eca6c3c5f16b4ad44c30f9be67a8365f2e19ed9fac896f69cbd37446218f
MD5 f068d604b44032226176db3ae0bdd211
BLAKE2b-256 88a822ebdbd83fe3ecddb31a4c8b27d4eed2e1b46f690f7d809b153677cc0687

See more details on using hashes here.

Provenance

The following attestation bundles were made for open_flash-1.0.40.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.40-py3-none-any.whl.

File metadata

  • Download URL: open_flash-1.0.40-py3-none-any.whl
  • Upload date:
  • Size: 36.3 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.40-py3-none-any.whl
Algorithm Hash digest
SHA256 dfad59231b024f0f1c610f62ea29b196ca936acc66e7a202f427d14e19785634
MD5 c658d273447e14d83a510c879b3e5974
BLAKE2b-256 db4976b250a843f47405c7f3d09084752cd6dc3af413b5872dd945765da4b004

See more details on using hashes here.

Provenance

The following attestation bundles were made for open_flash-1.0.40-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

This release

1.0.40 This release

2 files

1.0.39

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