Skip to content

Commit

Permalink
Update docs, add demo video
Browse files Browse the repository at this point in the history
  • Loading branch information
kevmoor committed Sep 20, 2024
1 parent 7004688 commit 5f5c4c9
Show file tree
Hide file tree
Showing 4 changed files with 52 additions and 14 deletions.
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,5 @@ new*
*.png
*.gif
*.mp4
*turbsimfiles/
*turbsimfiles/
*animation/
11 changes: 10 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,21 @@
# OWENS (Onshore/Offshore Wind/Water ENergy Simulator)

[![](https://img.shields.io/badge/docs-stable-blue.svg)](https://sandialabs.github.io/OWENS.jl)
[![](https://img.shields.io/badge/docs-dev-blue.svg)](https://sandialabs.github.io/OWENS.jl/dev)
![](https://github.com/sandialabs/OWENS.jl/workflows/CI/badge.svg)

* *Documentation:* [sandialabs.github.io/OWENS.jl/](https://sandialabs.github.io/OWENS.jl/dev)
* *Code:* [github.com/sandialabs/OWENS.jl](https://github.com/sandialabs/OWENS.jl)

This package is for experienced researchers and analyists with both software and engineering experience who need generalized flexibility and performance that is 100% open source and is compatible with gradient based optimization with automatic gradients in process. If you want a windows compatible GUI, please use QBlade.

OWENS is an ontology, or way of coupling modular aerodynamic, structural, hydrodynamic, and controls packages. It was originally based on the structural dynamics solver by Brian Owens (see dissertation: http://hdl.handle.net/1969.1/151813). However, it has been rewritten into the Julia programming language, modularized, and many of the issues related to aerodynamic coupling and floating dynamics solved, with extensive expansion into other areas and features to provide a seamless and automated process that takes in high level design details and does all of the preprocessing, running, and post processing that is normally done under different roofs or by different manual processes. This was done with the intent of enabling fast, parametric design. We have many of the modules propogating automatic gradients, however this is still a future challenge to solve well.

<p><br></p>


<p align="center"> <a href="https://www.youtube.com/watch?v=FTx9Jui_0CA?hd=1"> <img src="docs/src/assets/youtube_demo_image.png" alt="youtube.com/watch?v=FTx9Jui_0CA" style="width:70%"> </a> </p>


Here are several examples of OWENS use cases, current and past, including the Sandia 34m research turbine.

<img src="docs/src/assets/SNL34m.png" alt="drawing" width="400"/>
Expand All @@ -30,6 +37,8 @@ Then, floating turbines are a possibility, though this feature adds another dime

The OWENS.jl package contains functions and interfaces related to the ontology (how everything comes together, forms a wind turbine, and operates like a wind turbine), with preprocessing and postprocessing helper functions. These include automated meshing functions, sectional property mapping, two-way loads mapping, generalized torque and direct mesh controls, algorithms for two-way coupling and time stepping, fatigue and design equivalent load calculation, and all of the ontology and coupling to the other packages used.

<img src="docs/src/assets/OWENS_Processes.png" alt="drawing" width="400"/>

OWENSPrecomp.jl is a translation of Precomp and calculates the sectional properties

Composites.jl provides classical laminate theory definitions used for both pre and post processing
Expand Down
Binary file added docs/src/assets/youtube_demo_image.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
52 changes: 40 additions & 12 deletions docs/src/index.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,56 @@
# OWENS (Onshore/Offshore Wind/Water ENergy Simulator)

[![](https://img.shields.io/badge/docs-stable-blue.svg)](https://sandialabs.github.io/OWENS.jl)
[![](https://img.shields.io/badge/docs-dev-blue.svg)](https://sandialabs.github.io/OWENS.jl/dev)
![](https://github.com/sandialabs/OWENS.jl/workflows/CI/badge.svg)

* *Documentation:* [sandialabs.github.io/OWENS.jl/](https://sandialabs.github.io/OWENS.jl/dev)
* *Code:* [github.com/sandialabs/OWENS.jl](https://github.com/sandialabs/OWENS.jl)

This package is for experienced researchers and analyists with both software and engineering experience who need generalized flexibility and performance that is 100% open source and is compatible with gradient based optimization with automatic gradients in process. If you want a windows compatible GUI, please use QBlade.

OWENS is an ontology, or way of coupling modular aerodynamic, structural, hydrodynamic, and controls packages. It was originally based on the structural dynamics solver by Brian Owens (see dissertation: http://hdl.handle.net/1969.1/151813). However, it has been rewritten into the Julia programming language, modularized, and many of the issues related to aerodynamic coupling and floating dynamics solved, with extensive expansion into other areas and features to provide a seamless and automated process that takes in high level design details and does all of the preprocessing, running, and post processing that is normally done under different roofs or by different manual processes. This was done with the intent of enabling fast, parametric design. We have many of the modules propogating automatic gradients, however this is still a future challenge to solve well.

<p><br></p>

```@raw html
<div style="position:relative;padding-top:50%;">
<iframe style="position:absolute;left:0;top:0;height:80%;width:71.0%;"
src="https://www.youtube.com/embed/FTx9Jui_0CA?hd=1"
title="YouTube video player" frameborder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
allowfullscreen></iframe>
</div>
```
Here are several examples of OWENS use cases, current and past, including the Sandia 34m research turbine.

![SNL34m.](./assets/SNL34m.png){#fig:34m
width="50%"}
```@raw html
<p align="center">
<img src="./assets/SNL34m.png" alt="img" style="width:40%">
</p>
```

Then here is an example of a helical design. Note that arbitrary numbers of struts can be specified in the automatic meshing functions. You can also write your own generalized mesh using the internal building blocks, but it is not thouroughly documented.

![helical.](./assets/helical.png){#fig:34m
width="50%"}
```@raw html
<p align="center">
<img src="./assets/helical.png" alt="img" style="width:40%">
</p>
```

The generalized meshing was modified to include HAWT concepts, like this bi-wing concept. OWENS is capable of axial flow turbines/HAWTs, but it is not a mature feature, and no where near as developed as OpenFAST (i.e. for regular HAWTs it is recommended to use that software).

![biwing.](./assets/biwing.png){#fig:34m
width="50%"}
```@raw html
<p align="center">
<img src="./assets/biwing.png" alt="img" style="width:40%">
</p>
```

Then, floating turbines are a possibility, though this feature adds another dimension to the nonlinear time stepping convergance and in turn a fair amount of time. Future work is to make this general interface and functionality an easy to use feature (right now it needs a high level of experience to use).

![arcus.](./assets/arcus.png){#fig:34m
width="50%"}

```@raw html
<p align="center">
<img src="./assets/arcus.png" alt="img" style="width:40%">
</p>
```

# OWENS under the hood

Expand All @@ -48,7 +72,11 @@ Turbulent inflow is provided by OWENSOpenFASTWrappers.jl and the inflowwind and

Rainflow counting was provided by Rainflow.jl, however, this package became orphained and was pulled into the OWENS code base.

<img src="./assets/OWENS_Processes.png" alt="drawing" width="400"/>
```@raw html
<p align="center">
<img src="./assets/OWENS_Processes.png" alt="img" style="width:40%">
</p>
```

## Installation
Please follow the instructions on the setup page
Expand Down

0 comments on commit 5f5c4c9

Please sign in to comment.