Skip to main content

DRDMannTurb

DRDMannTurb (short for Deep Rapid Distortion Theory Mann Turbulence model) is a data-driven framework for synthetic turbulence generation in Python. The code is based on the original work of Jacob Mann in 1994 and 1998 as well as in the deep-learning enhancement developed by Keith et al. in this 2021 publication.

Installation

Pre-compiled wheels for the package are available via pip install drdmannturb. See our development environment instructions for instructions on installing development versions.

Basic Usage

See the /examples/ folder for baselines from the paper and for examples of the many functionalities of the package. These examples are rendered in a more readable format on our documentation here also.

DRDMannTurb consists of two primary submodules spectra_fitting and fluctuation_generation which are respectively focused on fitting a Deep Rapid Distortion (DRD) model and on generating synthetic turbulence "boxes" with a fit DRD model.

Questions?

If you have any questions, the best way to receive help is by creating a thread in our Discussions or by contacting the authors (Alexey Izmailov, Matthew Meeker) by email directly. If your question pertains to a problem with the package, please open an Issue so that it can addressed.

Citation

If you use this software, please cite it as below.

@software{Izmailov_DRDMannTurb_2023,
author = {Izmailov, Alexey and Meeker, Matthew and Deskos, Georgios and Keith, Brendan},
month = mar,
title = {{DRDMannTurb}},
url= {https://github.com/METHODS-Group/DRDMannTurb}, 
version = {1.0.3},
year = {2024}
}

Contributing

We always welcome new contributors! The best way to contribute to DRDMannTurb is through opening an issue, making a feature request, or creating a pull request directly.

See also the below instructions for installing DRDMannTurb for development purposes.

Development Version Installation Instructions

DRDMannTurb source is provided as a locally pip-installable package, meaning that the package can be installed locally with pip install -e . from the package root folder.

In conda_env_files, we provide a conda-lock file, which supports (64-bit) Intel macOS, ARM macOS, Linux, and Windows, as well as an environment.yml. These include all requirements for DRDMannTurb and building the documentation locally, which is discussed below. Either of these can be used to create a Conda environment for development and documentation purposes, however this is not mandatory.

Recreating the environment off the conda-lock can be done with conda-lock install -n ENV_NAME. Once this is completed, you should cd .. to the project root folder and run pip install -e . to install an editable version of DRDMannTurb in this environment.

If you choose to use your own environment, we ask that you use Python 3.9. You may wish to reference environment.yml to ensure that all dependencies are installed.

We also ask that you install our pre-commit configuration by running pre-commit install in the root directory of this repository. If you are unfamiliar with pre-commit, the documentation can be found here.

Running Tests Locally

DRDMannTurb's test suite is built with Pytest. Running the tests locally can be done by running pytest from the project root.

Tests decorated with slow can be run with the --runslow flag; they are otherwise skipped. Note that several of these tests require (at least ``partially'') training a DRD model, and so the suite may take several minutes to complete. Note also that certain components of the test suite require CUDA; these are also skipped if a CUDA device is not available.

Local Documentation Building Instructions

Our documentation source lives in the /docs/ folder. You should ensure that the dependencies listed in ./requirements-docs.txt are installed; if you chose to use one of our provided environments, this will have been done already.

Running make html will generate html pages in the /docs/build/html folder; these can be hosted locally with python -m http.server <PORT-NUMBER>.

Acknowledgements

This work was authored in part by the National Renewable Energy Laboratory, operated by Alliance for Sustainable Energy, LLC, for the U.S. Department of Energy (DOE) under Contract No. DE-AC36-08GO28308. Funding provided by the U.S. Department of Energy Office of Energy Efficiency and Renewable Energy Wind Energy Technologies Office. The views expressed in the article do not necessarily represent the views of the DOE or the U.S. Government. The U.S. Government retains and the publisher, by accepting the article for publication, acknowledges that the U.S. Government retains a nonexclusive, paid-up, irrevocable, worldwide license to publish or reproduce the published form of this work, or allow others to do so, for U.S. Government purposes. BK was supported in part by the U.S. Department of Energy Office of Science, Early Career Research Program under Award Number DE-SC0024335.

Metadata

Release files for drdmannturb 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for drdmannturb 1.0.3
File Size Uploaded Provenance Actions
drdmannturb-1.0.3.tar.gz 759.7 kB Without provenance Details for drdmannturb-1.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for drdmannturb 1.0.3
File Interpreter ABI Platform Actions
drdmannturb-1.0.3-py3-none-any.whl Python 3 none any Details for drdmannturb-1.0.3-py3-none-any.whl

Total release size: 814.3 kB

Release files / drdmannturb-1.0.3.tar.gz

Download URL drdmannturb-1.0.3.tar.gz
Size 759.7 kB
Tags Source
SHA-256 checksum
How to use checksums
b327b2d1618ac1a86c4f594114c4d4e63651cafb8eeed86178c453cdc15a4c94
BLAKE2b-256 checksum
How to use checksums
01b293492a017537f79fbb25b6430b9665e41246deae3b83e672c3ade718f02a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.9.13

Release files / drdmannturb-1.0.3-py3-none-any.whl

Download URL drdmannturb-1.0.3-py3-none-any.whl
Size 54.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aa328db089f49ed3a83838a421f11b8d5fa73903f391841dfad2189bebf1886f
BLAKE2b-256 checksum
How to use checksums
0fe37185a2f9f251067ea7e3850c67d337d757f969413ef548b2a0ee01032684
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.9.13

Security for drdmannturb 1.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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