# MATLAB Toolbox for OpenFAST, including MBC3
A collection of MATLAB tools developed for use with OpenFAST, including
a MATLAB®-based postprocessor for Multi-Blade Coordinate transformation of
wind turbine state-space models.
## Download
From a command line:
```
git clone https://github.com/OpenFAST/matlab-toolbox
```
## Install in MATLAB
From a MATLAB command window:
```
addpath( genpath('AbsolutePathToToolbox') )
```
where `AbsolutePathToToolbox` is the name of the absolute path where you cloned this toolbox.
Adding this command to your MATLAB `startup.m` file will make sure these tools are avalible every time you
use MATLAB.
## Folders
The scripts are organized in the following folders:
- `Campbell`: contains scripts to produce a Campbell diagram (work in progress, see [here](#campbell-diagram).
- `ConvertFASTversions:` scripts to convert input files from different versions of OpenFAST (in particular FAST7 and FAST8, some scripts are not up to date for the latest OpenFAST)
- `FAST2MATLAB` and `MATLAB2FAST`: scripts to read and write FAST input files
- `MBC`: scripts to perform the multi-blade coordinate transformation (see [here](#MBC))
- `Plots`: plotting scripts
- `ProgrammingTools`: tools for OpenFAST developers
- `Utilities`: miscellaneous tools used in the library (see [examples](Utilities/examples/)).
- `math`: generic mathematical tools used in the library
- `_ExampleData`: data used in some examples (e.g. the Campbell Diagram example)
The content of some of these folders are described below.
## Campbell diagram
Tools to generate a Campbell diagram are provided in the `Campbell` folder.
The scripts are operational but are still considered work in progress as they require the user to be quite familiar with OpenFAST and the linearization process.
The mode identification is not fully automated, and the user will have to perform a manual modification of the XLS or CSV file ("Modes\_ID" tab or file).
The following example script is provided:
```
Campbell/examples/runCampbell.m
```
This script requires OpenFAST 2.3.
Before additional documentation is provided, some answers may be found in the following link:
- [Issue 480 on Campbell diagram](https://github.com/OpenFAST/openfast/issues/480)
### Campbell diagram with trim option
The trim option has been introduced in the dev branch of OpenFAST in August 2020. Limited documentation and support is currently provided.
The following example script is provided:
```
Campbell/examples/runCampbell_Trim.m
```
This script requires OpenFAST 2.3 dev (August 2020).
Before additional documentation is provided, some answers may be found in the following links
- [Implementation plan for the Trim Option](https://github.com/ebranlard/temp-lin/blob/master/ForceSetPoint.pdf)
- [Pull request for Trim and Mode shape](https://github.com/OpenFAST/openfast/pull/373)
- [Issue 480 on Campbell diagram](https://github.com/OpenFAST/openfast/issues/480)
### Mode shapes visualization
Mode shape visualization has been introduced in the dev branch of OpenFAST in August 2020. Limited documentation and support is currently provided.
The following example script is provided:
```
Campbell/examples/runCampbell_Trim.m
```
This script requires OpenFAST 2.3 dev (August 2020).
Before additional documentation is provided, some answers may be found in the following links:
- [Pull request for Trim and Mode shape](https://github.com/OpenFAST/openfast/pull/373)
- [VTK visualization](https://github.com/OpenFAST/r-test/blob/dev/glue-codes/openfast/5MW_Land_ModeShapes/vtk-visualization.md): this describe the underlying steps to produce the visualization. These steps are not required when running the example scripts since these steps have been wrapped by some matlab function. Yet, it is still necessary to install paraview-python, and this documentation is useful to understand the process.
- [Issue 480 on Campbell diagram](https://github.com/OpenFAST/openfast/issues/480)
## MBC
MBC is a set of MATLAB scripts that performs multi-blade coordinate transformation (MBC) on wind turbine system models.
The dynamics of wind turbine rotor blades are conventionally expressed in rotating frames attached to the individual blades.
The tower-nacelle subsystem sees the combined effect of all rotor blades, not the individual blades. This is because the rotor
responds as a whole to excitations such as aerodynamic gusts, control inputs, and tower-nacelle motion—all of which occur in a
nonrotating frame. MBC helps integrate the dynamics of individual blades and express them in a fixed (nonrotating) frame.
MBC is mandatory to controls and stability analyses—erroneous predictions can result otherwise. A novel feature of this MBC code
is that it can handle variable-speed operation and turbines with dissimilar blades. Depending on the analysis objective, a user
may generate system models either in the first-order (state-space) form or the second-order (physical-domain) form. MBC3 can
handle both types of system models. Key advantages of MBC are: capturing cumulative dynamics of the rotor blades and its interaction
with the tower-nacelle subsystem, well-conditioning of system matrices by eliminating non-essential periodicity, and filtering operation.
### MBC3 Usage
The MBC scripts were updated to functions and modified to deal with some changes in OpenFAST linearizaton for BeamDyn. The old scripts have been moved
to the `Source\old` directory. The new functions can be called with
```
[mbc_data, matData, FAST_linData] = fx_mbc3( FileNames )
```
where the returned data structures are:
- `mbc_data`: the MBC3-transformed data
- `matData`: the data from calling fx_getMats
- `FAST_linData`: the raw data stored in the OpenFAST linearization files
After the MBC3 transformation, the `campbell_diagram_data` function can be called to help analyze modes:
```
[CampbellData] = campbell_diagram_data(mbc_data, BladeLen, TowerLen, xlsFileName)
```
Note that the blade and tower lengths are inputs to this function. Also, if the optional `xlsFileName` is used, the CampbellData is written to an Excel
file, which can be useful for analyzing the results.
## Utilities
Various utilities used by other scripts. Examples are:
- run OpenFAST simulations.
- read OpenFAST input files
- read OpenFAST output files
See [examples](Utilities/examples/)
没有合适的资源?快使用搜索试试~ 我知道了~
Collection of Matlab tools developed for use with OpenFAST.zip
共251个文件
m:142个
dat:69个
txt:10个
1.该资源内容由用户上传,如若侵权请联系客服进行举报
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
版权申诉
0 下载量 74 浏览量
2023-07-16
19:26:27
上传
评论
收藏 1019KB ZIP 举报
温馨提示
Collection of Matlab tools developed for use with OpenFAST
资源推荐
资源详情
资源评论
收起资源包目录
Collection of Matlab tools developed for use with OpenFAST.zip (251个子文件)
LinearizationPoints_Servo.csv 347B
LinearizationPoints_NoServo.csv 275B
NRELOffshrBsline5MW_BeamDyn_Blade.dat 56KB
NRELOffshrBsline5MW_OC4Jacket_SubDyn.dat 26KB
HDv2.03.x.dat 18KB
HDv2.01.00.dat 17KB
HydroDyn.dat 17KB
HDv2.02.x.dat 17KB
NRELOffshrBsline5MW_Onshore_ElastoDyn.dat 15KB
NRELOffshrBsline5MW_Onshore_ElastoDyn.dat 15KB
HDv2.00.05.dat 14KB
HDv2.00.03.dat 13KB
DU30_A17.dat 12KB
DU21_A17.dat 12KB
DU25_A17.dat 12KB
DU40_A17.dat 12KB
DU35_A17.dat 12KB
NACA64_A17.dat 12KB
SrvD_Primary.dat 12KB
ElastoDyn_Primary.dat 11KB
ED_Primary.dat 11KB
ED_Primary_v1.01.x.dat 11KB
ED_Primary_v1.03.x.dat 11KB
NRELOffshrBsline5MW_Onshore_ServoDyn.dat 11KB
SrvD_Primary_v1.05.x.dat 10KB
SrvD_Primary_v1.03.x.dat 10KB
AeroDyn15_Primary.dat 10KB
seaState.dat 10KB
SrvD_Primary_v1.02.x.dat 10KB
SrvD_Primary_v1.01.x.dat 9KB
NRELOffshrBsline5MW_Onshore_AeroDyn15.dat 9KB
NRELOffshrBsline5MW_Onshore_AeroDyn15.dat 9KB
SDv1.01.x.dat 8KB
SrvD_Primary.dat 7KB
Cylinder2.dat 7KB
Cylinder1.dat 7KB
AirfoilInfo_v1.01.x.dat 7KB
ED_Furling.dat 7KB
NRELOffshrBsline5MW_BeamDyn.dat 7KB
InflowWind.dat 7KB
IfW_v3.01.x.dat 7KB
NRELOffshrBsline5MW_Blade.dat 6KB
AD_Primary_v15.03.x.dat 6KB
ED_Blade.dat 6KB
AD_Primary_v15.00.x.dat 6KB
NRELOffshrBsline5MW_InflowWind_Steady10mps.dat 6KB
NRELOffshrBsline5MW_InflowWind_Steady8mps.dat 6KB
NRELOffshrBsline5MW_InflowWind_Steady8mps.dat 6KB
FAST_Primary_v8.16.x.dat 6KB
FAST_Primary_v8.17.x.dat 5KB
SrvD_TMD_v1.01.x.dat 5KB
FAST_Primary_v8.15.x.dat 5KB
FAST_Primary_v8.12.x.dat 4KB
FAST_Primary_v8.08.x.dat 4KB
HD_Primary.dat 4KB
AD_Primary_v14.04.x_NT.dat 4KB
ED_Tower.dat 3KB
NRELOffshrBsline5MW_Onshore_ElastoDyn_Tower.dat 3KB
FAST_Primary_v8.06.x.dat 3KB
FAST_Primary_v8.05.x.dat 3KB
AD_Primary_v14.04.x.dat 3KB
FAST_Primary_v8.03.x.dat 3KB
IfW_Primary.dat 3KB
AD_Primary.dat 3KB
ED_AdamsSpecific.dat 3KB
FAST_Primary_v8.01.x.dat 3KB
NRELOffshrBsline5MW_AeroDyn_blade.dat 3KB
FAST_Primary.dat 2KB
hd_driver.dat 2KB
FAST_Linear.dat 2KB
AD_Blade_v15.00.x.dat 1KB
OpenFAST.fst 7KB
Main_5MW_Land_8mps.fst 6KB
Main_5MW_Land_Lin.fst 6KB
Main_5MW_Land_10mps.fst 6KB
.gitignore 68B
.gitignore 52B
.gitignore 5B
BeamDyn_Primary.inp 7KB
TurbSim.inp 7KB
bd_driver.inp 4KB
LICENSE 11KB
Standstill.1.lin 99KB
test01.lin 90KB
os_path.m 38KB
PlotFASToutput.m 37KB
Matlab2FAST.m 25KB
GetMats.m 25KB
Write_ChckOutLst.m 25KB
Matlab2HD.m 23KB
WritePolarAD15.m 20KB
Matlab2SD.m 19KB
fx_mbc3.m 18KB
mbc3.m 18KB
FAST2Matlab.m 18KB
HD2Matlab.m 16KB
ConvertFAST7to8.m 15KB
Generate_SubDyn_Output_Params.m 14KB
writeLinearizationFiles.m 13KB
SD2Matlab.m 12KB
共 251 条
- 1
- 2
- 3
资源评论
AbelZ_01
- 粉丝: 915
- 资源: 5441
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功