Commit 341fd73e authored by Jenni Rinker's avatar Jenni Rinker
Browse files

updating report text

parent ae683bc3
Pipeline #13160 passed with stage
in 32 seconds
......@@ -7,7 +7,8 @@
\usepackage{pdflscape}
\usepackage{enumitem}
\usepackage{multirow}
\usepackage{hyperref}
\usepackage{hyperref} % mailto hyperlink
\usepackage{array} % raggedright in array cells
%\newenvironment{tablist}{\vspace*{-18pt}
% \begin{itemize}{}\itemsep-3pt\itemindent-12pt
......@@ -23,6 +24,7 @@
\title{The DTU 10 MW RWT HAWC Model}
\author{DTU Wind Energy}
\date{}
\begin{document}
......@@ -31,9 +33,9 @@
% ----------------------------------------------------------------
\section{Introduction}
This repository (``repo'') contains a DLB-ready HAWC2 implementation of the DTU 10 MW Reference Wind Turbine (RWT) \textbf{REF}.
This model is one of the most robust models curated by DTU Wind Energy, and it has been used quite extensively in a wide range of research activities \textbf{REF}.
A description of the original model design can be found in the design report \textbf{REF}.
This repository (``repo'') contains a DLB-ready HAWC2 implementation of the DTU 10 MW Reference Wind Turbine (RWT).
This model is one of the most robust models curated by DTU Wind Energy, and it has been used quite extensively in a wide range of research activities.
A description of the original model design can be found in the design report\footnote{C. Bak \emph{et al}. ``Description of the DTU 10 MW Reference Wind Turbine.'' DTU Wind Energy Report-I-0092}.
% dlc table
\begin{table}\centering
......@@ -78,7 +80,7 @@ A description of the original model design can be found in the design report \te
% ----------------------------------------------------------------
\section{Model history and versioning}
The history of the DTU 10~MW is slightly disorganized, primarily due to two different sets of model files being developed in parallel: those hosted on the original RWT repo \textbf{REF} and a separate set of files that privately hosted and released on the HAWC2 website.
The history of the DTU 10~MW is slightly disorganized, primarily due to two different sets of model files being developed in parallel: those hosted on the original RWT repo\footnote{\href{https://rwt.windenergy.dtu.dk}{https://rwt.windenergy.dtu.dk}} and a separate set of files that privately hosted and released on the HAWC2 website.
The two sets of input files were curated by different groups of researchers, and there was little synchronization between them.
The files hosted in this repository track the files that were distributed on the HAWC2 website.
However, because this repo is now a submodule of the RWT repo, the two modules should be synchronized in the future.
......@@ -92,6 +94,59 @@ Further changes were of course made, but it is unclear where the contributions c
A log of the changes in the different versions is given in Tables~\ref{tab:version1} and \ref{tab:version2}.
Specific changes can be found by using the \texttt{diff} command in git (from a local clone of the repo) of by comparing branches on GitLab.
% ----------------------------------------------------------------
\section{Model structure}
The model is constructed according to the standard method for three-bladed horizontal-axis wind turbines in HAWC2.
There are 9 main bodies: tower, towertop, shaft, three hub elements and three blades.
Of these bodies, the towertop and hub elements are rigid.
The main bodies are summarized in Table~\ref{tab:bodies}.
The blades are subdivided into 10 bodies to better allow for large deflections.
The bodies are modeled as a mixture of flexible (tower, shaft [torsion only] and blades) and stiff (towertop and hubs) bodies.
As indicated in the reference documentation, the DTU 10 MW RWT has a gearbox ratio of 50.
However, the HAWC2 implementation does not use the gearbox ratio, choosing instead to simply model the generator inertia on the low-speed-shaft side.
It is for this reason that the gearbox ratio in the controller and generator servo DLLs is listed as 1 instead of 50.
Thus, all generator torque values and specifications are given on the low-speed shaft side.
% ----------------------------------------------------------------
\section{Repository structure}
This repo uses a branch structure to track the different model versions.
For example, version 1.0 of the model can be found in branch \texttt{v1.0}.
These branches are locked to prevent unauthorized pushes or merges.
Updates to comments and/or line order are allowed within a released version.
However, any changes to model parameters or outputs are not allowed.
If a user requires changes to a released version, they must do so on a separate branch, and these changes cannot be merged.
Updates to the model itself (e.g., fixing bugs or improving the controller) must be submitted as a merge request on the master branch and then reviewed/accepted by the repo responsible.
This repo contains the source code for this report, some utilities for model generation, and the HAWC2 and HAWCStab2 input files for the model.
The folder structure for the input files is as shown:
\begin{verbatim}
* control/ <-- control DLLs go here
* wpdata.100 <-- text files for DTU Basic Controller
* data/ <-- files for bodies and HAWCStab2 operational data
* htc/ <-- HAWC2 files
* DTU_10MW_RWT.htc <-- turbulent simulation, 24 m/s
* DTU_10MW_RWT_step.htc <-- step-wind simulation
* DTU_10MW_RWT_hs2.htc <-- HAWCStab2 file
\end{verbatim}
The turbulent simulation is a ``unique'' file from which the step-wind and HAWCStab2 files are automatically constructed using a Python script in the utilities folder.
The compiled control DLLs are not provided in the repo due to their binary nature.
If you a require a ready-to-run model with all DLLs, please download the zip file from the HAWC2 website.
% ----------------------------------------------------------------
\section{Bugs, model improvements and questions}
If you as a user notice that there is a bug in the model (e.g., a sign error or a parameter that doesn't match the model documentation), then we kindly ask that you notify us by submitting an issue on GitLab.
Navigate to the repo on GitLab, then click on ``Issues'' in the side bar.
The Issue Tracker on GitLab is how we keep track of issues with the model and things that should be fixed for the next model release.
If you have questions about a model that are not answered by this document, then please email \href{mailto:hawc2@windenergy.dtu.dk}{hawc2@windenergy.dtu.dk}.
% ----------------------------------------------------------------
% Table pages (landscape)
\begin{landscape}
% TABLE. Model versions, part 1.
\begin{table}\centering
......@@ -179,45 +234,43 @@ Specific changes can be found by using the \texttt{diff} command in git (from a
\end{tabular}
\label{tab:version2}
\end{table}
\end{landscape}
% ----------------------------------------------------------------
\section{Repository structure}
This repo uses a branch structure to track the different model versions.
For example, version 1.0 of the model can be found in branch \texttt{v1.0}.
These branches are locked to prevent unauthorized pushes or merges.
Updates to comments and/or line order are allowed within a released version.
However, any changes to model parameters or outputs are not allowed.
If a user requires changes to a released version, they must do so on a separate branch, and these changes cannot be merged.
Updates to the model itself (e.g., fixing bugs or improving the controller) must be submitted as a merge request on the master branch and then reviewed/accepted by the repo responsible.
This repo contains the source code for this report, some utilities for model generation, and the HAWC2 and HAWCStab2 input files for the model.
The folder structure for the input files is as shown:
\begin{verbatim}
* control/ <-- control DLLs go here
* wpdata.100 <-- text files for DTU Basic Controller
* data/ <-- files for bodies and HAWCStab2 operational data
* htc/ <-- HAWC2 files
* DTU_10MW_RWT.htc <-- turbulent simulation, 24 m/s
* DTU_10MW_RWT_step.htc <-- step-wind simulation
* DTU_10MW_RWT_hs2.htc <-- HAWCStab2 file
\end{verbatim}
The turbulent simulation is a ``unique'' file from which the step-wind and HAWCStab2 files are automatically constructed using a Python script in the utilities folder.
The compiled control DLLs are not provided in the repo due to their binary nature.
If you a require a ready-to-run model with all DLLs, please download the zip file from the HAWC2 website.
% ----------------------------------------------------------------
\section{Bugs, model improvements and questions}
If you as a user notice that there is a bug in the model (e.g., a sign error or a parameter that doesn't match the model documentation), then we kindly ask that you notify us by submitting an issue on GitLab.
Navigate to the repo on GitLab, then click on ``Issues'' in the side bar.
The Issue Tracker on GitLab is how we keep track of issues with the model and things that should be fixed for the next model release.
If you have questions about a model that are not answered by this document, then please email \href{mailto:hawc2@windenergy.dtu.dk}{hawc2@windenergy.dtu.dk}.
% TABLE. Bodies
\begin{table}\centering
\caption{Main bodies in HAWC2 model.
``X'' indicates index 1, 2 or 3.
Data files for all bodies contain two subsets: flexible and rigid.}\vspace*{0.5cm}
\begin{tabular}{
p{1.5cm}|
>{\raggedright\arraybackslash}p{3cm}|
>{\raggedright\arraybackslash}p{3cm}|
p{1.5cm}|
>{\raggedright\arraybackslash}p{3.5cm}|
>{\raggedright\arraybackslash}p{5cm}}
Body & Location & Constraint & Flexible?
& Coordinate system & Notes \\\hline
Tower & Ground to bottom of nacelle & Bottom node fixed to ground &
Yes & z down, y downwind & \\\hline
Towertop & Bottom of nacelle up to shaft & Fixed to tower & No &
z down, y downwind &
Flexible parameters included in structural data file but by
by default not enabled. \\\hline
Shaft & Towertop to center of rotor, tilted. & Rotates at rotor speed
& Torsion only & z upwind along shaft & \\\hline
HubX & Rotor center to blade root, coned & Fixed to shaft & No &
y downwind along shaft, z outwards towards blade &
Flexible parameters included in structural data file but by
by default not enabled.\\\hline
BladeX & Blade root to tip, coned & Fixed to hub & Yes &
y downwind along shaft, z from root to tip &
\end{tabular}
\label{tab:bodies}
\end{table}
\end{landscape}
% ----------------------------------------------------------------
%\section{HAWC2/HAWCStab2 Results}
% To be added later
\end{document}
\ No newline at end of file
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment