Skip to content

Commit 97f1bcb

Browse files
dav-ogtridelat
authored andcommitted
Update README.md
1 parent 67f5950 commit 97f1bcb

File tree

1 file changed

+17
-41
lines changed

1 file changed

+17
-41
lines changed

README.md

Lines changed: 17 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,28 @@
1-
<p align="center">
2-
<img src="doc/user/hydrochrono_logo.png" width="720" alt="HydroChrono logo">
3-
</p>
1+
# HydroChrono
42

5-
# What is HydroChrono?
3+
**HydroChrono** is an emerging hydrodynamics simulation tool designed to model complex ocean systems. Seamlessly integrated with the [Project Chrono](https://projectchrono.org/) physics engine, it offers a powerful C++ API for a wide range of simulations.
64

7-
HydroChrono is an advanced hydrodynamics package for simulating complex ocean systems. Its designed to integrate seamlessly with the open-source physics engine, [Project Chrono](https://projectchrono.org/) through a robust C++ API.
5+
## Capabilities
86

9-
<p align="center">
10-
<img src="doc/user/sphere_irreg.gif" width="500" alt="A simple sphere in irregular waves.">
11-
</p>
7+
HydroChrono extends the versatility of Project Chrono to hydrodynamic applications, enabling you to simulate multibody wave energy converters (WECs) and floating offshore wind turbines (FOWTs) with Chrono::FEA for flexible bodies.
128

13-
# Capabilities of HydroChrono
9+
## Get Started
1410

15-
With HydroChrono, you can model any system that's supported by Chrono - from multiple bodies and joints to finite element bodies and discrete element particles. HydroChrono will supply hydrodynamic forces to any rigid body in the system - whether you're looking to simulate multibody wave energy converters (WECs) or floating offshore wind turbines (FOWTs) with flexible towers and blades through Chrono::FEA.
11+
Visit the [HydroChrono website](https://nrel.github.io/HydroChrono/) for information about the underlying theory, build instructions, and usage details. Currently, HydroChrono is available as a source build, offering customization and optimization opportunities. A binary distribution with Python wrapper is in development and coming soon.
1612

17-
Here is an example of a floating wind turbine with flexible tower and blades where HydroChrono is supplying wave forces to the (rigid body) floating platform:
13+
## Limitations
1814

19-
<p align="center">
20-
<img src="doc/user/seahowl_fowt23.png" alt="FOWT" width="300">
21-
</p>
15+
- Currently only supports first-order linear potential flow forces.
16+
- Hydrodynamic forces are currently limited to rigid bodies.
17+
18+
## Vision and Future Goals
2219

23-
And here is a cutaway view of multibody WEC (TALOS) with 6 PTOs connecting the hull to a large internal reaction mass. HydroChrono is supplying wave forces to the hull:
20+
- Expand hydrodynamics to incorporate nonlinear and 2nd order forces.
21+
- Integrate advanced simulation features using Project Chrono's DEM and FEA modules.
22+
- Support seamless transitioning from potential flow to CFD and SPH for detailed FSI analysis.
23+
- Develop a Python API to broaden accessibility and ease of use.
24+
- Foster and support open-source collaboration in the research community.
2425

2526
<p align="center">
26-
<img src="doc/user/talos_demo.gif" alt="TALOS" width="500">
27+
<img src="docs\assets\img\wave_animation2.gif" alt="Wave Energy" width="300">
2728
</p>
28-
29-
30-
# Dive Deeper 🏊‍♂️
31-
32-
For more detailed information about HydroChrono please visit the [HydroChrono website](https://nrel.github.io/HydroChrono/). This website covers the theory behind the code in more detail, along with instructions for how to build the code and start using it.
33-
34-
As of now, HydroChrono must be built from source. While this provides flexibility for customization and optimization, it also means that the setup process may be more involved than a pre-compiled solution. For detailed build instructions, please refer to our HydroChrono website. We are continually working to improve the installation process and appreciate your feedback and patience!
35-
36-
# Limitations of HydroChrono
37-
38-
Like all tools, HydroChrono has its own set of limitations:
39-
40-
- **First-order potential flow forces:** we currently support first-order potential flow forces; more complex/nonlinear options have not yet been implemented.
41-
- **Rigid bodies:** while flexible bodies can be included in a system, at the moment we only support hydrodynamic forces applied to rigid bodies.
42-
43-
We welcome feedback and contributions to help us address these limitations!
44-
45-
# Long-term Goals & Vision
46-
47-
- **Develop advanced simulation capabilities:** HydroChrono opens up several new simulation possibilities, including:
48-
- Simulation of anchor-seabed interactions for WECs and FOWTs using both the DEM (Discrete Element Method) and FEA (Finite Element Analysis) modules available in Project Chrono.
49-
- Distributed hydrodynamic loads on flexible structures through the use of Chrono::FEA. This not only allows for in-depth structural analysis but also the simulation of innovative deformable and/or inflatable WECs.
50-
- **Deeper Integration with the Chrono Ecosystem:** We envision a seamless transition of system models across various fluid dynamics realms. From HydroChrono's potential flow to Computational Fluid Dynamics (CFD) and Smoothed Particle Hydrodynamics (SPH), our goal is to offer detailed Fluid-Structure Interaction (FSI) insights. This will aid researchers in understanding intricate nonlinear FSI scenarios before actual ocean deployments. Additionally, we want to support rapid estimation of viscous drag coefficients to help refine HydroChrono's potential flow models.
51-
- **Expanding Accessibility with a Python API:** Recognizing the global research community's diverse coding preferences, we're working towards introducing a Python API for HydroChrono. This will provide a more accessible interface and reduce the reliance on C++ for many users.
52-
- **Advocating for Open-Source Collaboration:** At the heart of HydroChrono lies the spirit of innovation driven by open-source collaboration. We highly value open-source solutions and strongly encourage collaborations!

0 commit comments

Comments
 (0)