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.7.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.7-py3-none-any.whl (2.5 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: vivyd-0.1.7.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.7.tar.gz
Algorithm Hash digest
SHA256 bbf6d689c0e739bcb6fe206b807e65f12018016cb10445de2acb14cecd8c7718
MD5 da8ed39efae151f5ca4b1f4dd548ffc9
BLAKE2b-256 1db761cd7a4de8fc3e879551c7d847328e86d947371a7b09dfd86f99da064b43

See more details on using hashes here.

File details

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

File metadata

  • Download URL: vivyd-0.1.7-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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 c33483907c9bdea7e3120271dbad36c5986afe6c9905bdb4e363d7d54a2374a6
MD5 fabfd6b8ec2d094fb33589841cfbc7da
BLAKE2b-256 b9c9b5322d8f80a07e844f4e790a9e182d2ba758c618d1361cc615ceb68dc67a

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