Skip to main content

Numerical tools for studying VIV models

Project description

VIVyD: Vortex-Induced Vibration Dynamics

Description

VIVyD is a Python package for simulating vortex-induced vibrations (VIV). It implements several models for the fluid-structure interaction.

Installation

You can install it using the pip command:

pip install vivyd

Development setup

To work on the source code of this project, clone this repository to your local machine.

git clone https://gitlab.uliege.be/structural-and-stochastic-dynamics/vivyd.git

Or, if you prefer using SSH:

git clone git@gitlab.uliege.be:structural-and-stochastic-dynamics/vivyd.git

Then, navigate into the project directory:

cd vivyd

Next, it is recommended to create a virtual environment to manage dependencies. In particular, this project uses uv as recommended environment management. To install the environment in editable mode with the specified dependencies, simply run:

uv sync

Equivalently, using pip:

pip install -e .

Usage

Once installed, the package can be imported in your own Python scripts or Jupyter notebooks with

import vivyd

Under the development setup, examples of how to use the package can be found in the examples/ directory. You can run scripts using

cd src/examples
uv run example_name.py

or, interactively for the Jupyter notebooks.

Support

The best way to get help is to open an issue in the issue tracker of this repository.

Contributing

This project is open to contributions. If you would like to contribute, please fork the repository and create a pull request with your changes. Make sure to follow the coding style and include tests for any new features or bug fixes.

License

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

Project details


Download files

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

Source Distribution

vivyd-0.1.5.tar.gz (2.5 MB view details)

Uploaded Source

Built Distribution

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

vivyd-0.1.5-py3-none-any.whl (2.5 MB view details)

Uploaded Python 3

File details

Details for the file vivyd-0.1.5.tar.gz.

File metadata

  • Download URL: vivyd-0.1.5.tar.gz
  • Upload date:
  • Size: 2.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"43","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for vivyd-0.1.5.tar.gz
Algorithm Hash digest
SHA256 2d5347519cfafd4cfbfff891b4cd3ab75cfdd3be796dde21168998b210a1a888
MD5 dc084eee125d763d40966a368ebaffdb
BLAKE2b-256 9c65d372d6173ff0086a68d4ad53159860f3442ca1bc44f1703b8b9fd10be41b

See more details on using hashes here.

File details

Details for the file vivyd-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: vivyd-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 2.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"43","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for vivyd-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 9c8b41a91ad98d13631a599550d76dd229243dde9dd0212ff8b378c9e272407c
MD5 25a85ae2d2bbb3258f1028a8434cbdd1
BLAKE2b-256 be762b1ae9d47e3cfb12256ce544bf4a9770fe34f4c4a0033cfd916445328d8b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page