Skip to content

Commit

Permalink
Simple update to docs
Browse files Browse the repository at this point in the history
  • Loading branch information
kevmoor committed Nov 11, 2024
1 parent 48b0131 commit 72bf705
Show file tree
Hide file tree
Showing 4 changed files with 21 additions and 30 deletions.
2 changes: 2 additions & 0 deletions Project.toml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ version = "1.0.3"

[deps]
DelimitedFiles = "8bb1440f-4735-579b-a4ab-409b98df4dab"
FLOWMath = "6cb5d3fb-0fe8-4cc2-bd89-9fe0b19a99d3"
HDF5 = "f67ccb44-e63f-5c2f-98bd-6dc0ccc4ba2f"
Libdl = "8f399da3-3557-5675-b5ff-fb832c97cbdb"
LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
Expand All @@ -15,6 +16,7 @@ OWENSOpenFAST_jll = {url = "https://github.com/sandialabs/OWENSOpenFAST_jll.jl"}

[compat]
DelimitedFiles = "1"
FLOWMath = "0.4.1"
HDF5 = "0.17"
OWENSOpenFAST_jll = "4.0.0"
julia = "1"
Expand Down
23 changes: 8 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,15 @@
# OWENSOpenFASTWrappers

[![](https://img.shields.io/badge/docs-stable-blue.svg)](https://sandialabs.github.io/OWENSOpenFASTWrappers.jl)
[![](https://img.shields.io/badge/docs-dev-blue.svg)](https://sandialabs.github.io/OWENSOpenFASTWrappers.jl/dev)
![](https://github.com/sandialabs/OWENSOpenFASTWrappers.jl/workflows/CI/badge.svg)
[![codecov](https://codecov.io/gh/sandialabs/OWENSOpenFASTWrappers.jl/graph/badge.svg?token=1egaz9f5cT)](https://codecov.io/gh/sandialabs/OWENSOpenFASTWrappers.jl)

A repository containing julia wrappers for standalone openFAST modules.
* *Documentation:* [sandialabs.github.io/OWENSOpenFASTWrappers.jl/](https://sandialabs.github.io/OWENSOpenFASTWrappers.jl/dev)
* *Code:* [github.com/sandialabs/OWENSOpenFASTWrappers.jl](https://github.com/sandialabs/OWENSOpenFASTWrappers.jl)

## Quick Start for Developing Julia Packages
This is part of the Sandia National Labs OWENS toolkit (Onshore/Offshore Wind/Water Energy Simulator). This package provides a frontend julia wrapper to many of the popular OpenFAST libraries, including AeroDyn, HydroDyn, MoorDyn, InflowWind, and Turbsim. The package can be used standalone, as shown in the test cases, or in conjunction with OWENS.jl. The OWENSOpenFAST_jll.jl package was also created, which this is linked to, which provides cross compiled binaries for the major operating systems and significantly improves the installation experience. Please also note the API reference in these docs, which gives a searchable index of all of the functions with their inputs and outputs. Please make any pull requests against the dev branch.

Please make all feature changes and bug fixes as branches and then create pull requests against the dev branch. The dev branch will be periodically pulled into master.

- include("./path/modulename.jl/src/modulename.jl") is like a copy and paste and will reload the module every time the script is run

- installing a module by navigating to the module's working directory (and in an interactive julia session), running "] dev ." will install it in dev mode and will pick up changes made in the local package location every time julia restarts.

- installing normally ("] add url/or/path/2/package") installs the package in the "~/.julia" folder and requires the url/path original location to be updated, and a "] update mypackage" to get it to pick up changes.

- Each package has its own "environment" like conda environment. To activate that environment and add dependencies, navigate to the working directory and run "] activate ." Then, when you "] add dependencyname" it will add it to the Project.toml and Manifest.toml automatically. To switch back to the general environment, run "] activate"

- Add code in the src/ folder with an include("./yournewfile.jl") in the OpenFASTWrapers.jl file

- Add tests and test data in the test/ folder, add include statements for your tests in the runtests.jl file.
## Installation
]add [email protected]:sandialabs/OWENSOpenFAST_jll.jl.git
]add [email protected]:sandialabs/OWENSOpenFASTWrappers.jl.git
24 changes: 10 additions & 14 deletions docs/src/index.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,15 @@
# OWENSOpenFASTWrappers

A repository containing julia wrappers for standalone openFAST modules.
[![](https://img.shields.io/badge/docs-stable-blue.svg)](https://sandialabs.github.io/OWENSOpenFASTWrappers.jl)
[![](https://img.shields.io/badge/docs-dev-blue.svg)](https://sandialabs.github.io/OWENSOpenFASTWrappers.jl/dev)
![](https://github.com/sandialabs/OWENSOpenFASTWrappers.jl/workflows/CI/badge.svg)
[![codecov](https://codecov.io/gh/sandialabs/OWENSOpenFASTWrappers.jl/graph/badge.svg?token=1egaz9f5cT)](https://codecov.io/gh/sandialabs/OWENSOpenFASTWrappers.jl)

## Quick Start for Developing Julia Packages
* *Documentation:* [sandialabs.github.io/OWENSOpenFASTWrappers.jl/](https://sandialabs.github.io/OWENSOpenFASTWrappers.jl/dev)
* *Code:* [github.com/sandialabs/OWENSOpenFASTWrappers.jl](https://github.com/sandialabs/OWENSOpenFASTWrappers.jl)

Please make all feature changes and bug fixes as branches and then create pull requests against the dev branch. The dev branch will be periodically pulled into master.
This is part of the Sandia National Labs OWENS toolkit (Onshore/Offshore Wind/Water Energy Simulator). This package provides a frontend julia wrapper to many of the popular OpenFAST libraries, including AeroDyn, HydroDyn, MoorDyn, InflowWind, and Turbsim. The package can be used standalone, as shown in the test cases, or in conjunction with OWENS.jl. The OWENSOpenFAST_jll.jl package was also created, which this is linked to, which provides cross compiled binaries for the major operating systems and significantly improves the installation experience. Please also note the API reference in these docs, which gives a searchable index of all of the functions with their inputs and outputs. Please make any pull requests against the dev branch.

- include("./path/modulename.jl/src/modulename.jl") is like a copy and paste and will reload the module every time the script is run

- installing a module by navigating to the module's working directory (and in an interactive julia session), running "] dev ." will install it in dev mode and will pick up changes made in the local package location every time julia restarts.

- installing normally ("] add url/or/path/2/package") installs the package in the "~/.julia" folder and requires the url/path original location to be updated, and a "] update mypackage" to get it to pick up changes.

- Each package has its own "environment" like conda environment. To activate that environment and add dependencies, navigate to the working directory and run "] activate ." Then, when you "] add dependencyname" it will add it to the Project.toml and Manifest.toml automatically. To switch back to the general environment, run "] activate"

- Add code in the src/ folder with an include("./yournewfile.jl") in the OpenFASTWrapers.jl file

- Add tests and test data in the test/ folder, add include statements for your tests in the runtests.jl file.
## Installation
]add [email protected]:sandialabs/OWENSOpenFAST_jll.jl.git
]add [email protected]:sandialabs/OWENSOpenFASTWrappers.jl.git
2 changes: 1 addition & 1 deletion test/aerodyn_run.jl
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ mymesh, myort, myjoint, bladeIdx, bladeElem = create_mesh_struts(;Htwr_base = Ht
# Create AeroDyn Files

# input files for ADI
ad_input_file="$path/AeroDynInputs/ADInputFile_OneTurbine.dat"
ad_input_file="$path/AeroDynInputs/ADInputFile_oneTurbine.dat"
ifw_input_file="$path/AeroDynInputs/IW.dat"
blade_filename="$path/AeroDynInputs/blade.dat"
lower_strut_filename="$path/AeroDynInputs/lower_arm.dat"
Expand Down

0 comments on commit 72bf705

Please sign in to comment.