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

Uploaded Python 3

File details

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

File metadata

  • Download URL: vivyd-0.1.6.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.6.tar.gz
Algorithm Hash digest
SHA256 a8318c9e14626ece591adefa53cc9fcfb7deb5ee1664b6d41660415e1d9e9dbd
MD5 3d76892702afac5cd0804857985ff0a8
BLAKE2b-256 b3600aae872652738667e552cff150d2bc1aed4ac0254f94da0b978bf17a4525

See more details on using hashes here.

File details

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

File metadata

  • Download URL: vivyd-0.1.6-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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 467564b61121ac2475423a2cd8b5df6f58aa9b38f712f662e78a49d89373cf24
MD5 80a95f774a9ac5681f7d6834ffa9dcd2
BLAKE2b-256 9f3615abdfee8cb157e529ef52a329185dc9283c04f41f07433d4c70ce6d869c

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