initial commit

CHANGELOG.md

+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog][keep_chglog], and this project adheres
+to [Semantic Versioning][sem_ver]. In the context of this repo, the semantic
+versioning is based mainly on the CSV files. Major releases indicate a breaking
+change in the formatting of the CSV files (column rorder, renaming, etc). Minor
+versions indicate addition of new data.
+
+## [Unreleased]
+
+_Initial commit_. The first version will be released once I have figured out the
+format to use for the geometry files.
+
+### Added
+
+- NACA-TN-626 geometry and data
+- NASA-TM-81232 geometry and (partial) data
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+[sem_ver]:<https://semver.org/spec/v2.0.0.html>
+[keep_chglog]: <https://keepachangelog.com/en/1.0.0/>
+[Unreleased]: https://gitlab.uliege.be/thlamb/rotor-db

CODEOWNERS

+# Each line is a file pattern followed by one or more owners.
+
+# The following owners will be the default owners for everything in
+# the repo. Unless a later match takes precedence, they
+# will be requested for review when someone opens a merge request.
+* @thlamb

LICENSE

+MIT License
+
+Copyright (c) 2022 University of Liege
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the “Software”), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

+# Rotor database
+
+This repo contains a list of rotor geometries and the associated experimental
+data. All these data were found in articles, technical reports, theses, etc. The
+reference is always listed alongside the files.
+
+## Organization
+
+Every entry comes with at least two csv files:
+
+- `<rotor_name>_geom.csv` contains the geometric parameters of the rotor
+- `<rotor_name>_data.csv` contains the experimental measurements
+
+### General file info
+
+All files start with some commented lines (_i.e._, lines starting with `#`).
+These comments indicate
+
+- the origin of the data
+- "tags" to quickly identify topics of interest with `grep` or similar tools
+- the units of the columns
+
+The available tags are compiled in the following table
+
+| Tag          | Description                                                   |
+|------------- | ------------------------------------------------------------- |
+| `hover`      | Hovering helicopter                                           |
+| `axial`      | Helicopter in axial climb/descent                             |
+| `oblique`    | Oblique flows (_e.g._, helicopter in forward flight)          |
+| `coaxial`    | Coaxial rotors                                                |
+| `propeller`  | Aircraft propeller                                            |
+| `incomplete` | Incomplete datasets (no all data in reproduced in the csv)    |
+
+### Geometry files
+
+The geometry files are standardized so they all share the same formatting,
+columns order, etc. They are also **all given in SI units**.
+
+The columns represent the different parameters, while the rows give the values
+of these parameters in some specific blade sections. This means that the first
+data always corresponds to the section at the blade root cutout, while the last
+data corresponds to the section at blade tip.
+
+### Data files
+
+The data files reflect the available information in the source material. It is
+currently not planned to standardize them, so each file should be scrutinized
+properly before usage in your codes. The data are presented in their original
+units, so use it with caution.
+
+### Scripts
+
+Small scripts/functions will be provided in the future in the `scripts/`
+directory to help you load and parse the data in the most common languages.
+
+## Contributing
+
+Any contribution to this database is more than welcomed. A small python script
+will be provided shortly to streamline the generation of the geometry file.
+
+## List of rotors
+
+- NACA-TN-626: Knight & Hefner, Static Thrust Analysis of the Lifting Airscrew
+- NASA-TM-81232: Caradonna & Tung, Experimental and Analytical Studies of a
+  Model Helicopter Rotor in Hover

database/NACA-TN-626_data.csv

+# Knight & Hefner, Static Thrust Analysis of the Lifting Airscrew, 1937 (NACA-TN-626)
+# Tags: hover
+# -, -, fps, -, -, deg, -, -, -, -, rc/R, -
+number of blades, solidity, tip speed, tip reynolds, tip mach, collective pitch, CT, CP, CT/sigma, CP/sigma, root cutout, notes
+2, 0.04244, 251.3, 267825, 0.22511, 0.0,  0.000000, 0.0000540, 0.00000, 0.001272, 0.150,
+2, 0.04244, 251.3, 267825, 0.22511, 1.0,  0.000140, 0.0000555, 0.00330, 0.001308, 0.150,
+2, 0.04244, 251.3, 267825, 0.22511, 2.0,  0.000437, 0.0000625, 0.01028, 0.001473, 0.150,
+2, 0.04244, 251.3, 267825, 0.22511, 4.0,  0.001240, 0.0000955, 0.02922, 0.002250, 0.150,
+2, 0.04244, 251.3, 267825, 0.22511, 6.0,  0.002210, 0.0001580, 0.05207, 0.003723, 0.150,
+2, 0.04244, 251.3, 267825, 0.22511, 8.0,  0.003250, 0.0002470, 0.07658, 0.005820, 0.150,
+2, 0.04244, 251.3, 267825, 0.22511, 10.0, 0.004235, 0.0003455, 0.09978, 0.008141, 0.150,
+2, 0.04244, 251.3, 267825, 0.22511, 12.0, 0.004950, 0.0004390, 0.11663, 0.010344, 0.150,
+3, 0.06366, 251.3, 267825, 0.22511, 0.0,  0.000000, 0.0000925, 0.00000, 0.001453, 0.150,
+3, 0.06366, 251.3, 267825, 0.22511, 2.0,  0.000510, 0.0001030, 0.00801, 0.001618, 0.150,
+3, 0.06366, 251.3, 267825, 0.22511, 4.0,  0.001490, 0.0001500, 0.02340, 0.002356, 0.150,
+3, 0.06366, 251.3, 267825, 0.22511, 6.0,  0.002740, 0.0002370, 0.04304, 0.003723, 0.150,
+3, 0.06366, 251.3, 267825, 0.22511, 8.0,  0.004165, 0.0003675, 0.06542, 0.005773, 0.150,
+3, 0.06366, 251.3, 267825, 0.22511, 10.0, 0.005625, 0.0005240, 0.08836, 0.008231, 0.150,
+3, 0.06366, 251.3, 267825, 0.22511, 12.0, 0.006850, 0.0006785, 0.10760, 0.010658, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 0.0,  0.000000, 0.0001340, 0.00000, 0.001579, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 1.0,  0.000144, 0.0001370, 0.00169, 0.001614, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 2.0,  0.000521, 0.0001500, 0.00614, 0.001767, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 3.0,  0.001070, 0.0001690, 0.01261, 0.001991, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 4.0,  0.001690, 0.0002050, 0.01991, 0.002415, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 5.0,  0.002380, 0.0002495, 0.02804, 0.002939, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 6.0,  0.003225, 0.0003100, 0.03799, 0.003652, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 7.0,  0.003960, 0.0003715, 0.04665, 0.004377, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 8.0,  0.004905, 0.0004600, 0.05779, 0.005419, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 9.0,  0.005910, 0.0005810, 0.06963, 0.006845, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 10.0, 0.006910, 0.0006975, 0.08141, 0.008217, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 11.0, 0.007980, 0.0008550, 0.09401, 0.010073, 0.150,
+4, 0.08488, 251.3, 267825, 0.22511, 12.0, 0.008725, 0.0009550, 0.10279, 0.011251, 0.150,
+5, 0.10610, 251.3, 267825, 0.22511, 0.0,  0.000000, 0.0001500, 0.00000, 0.001414, 0.150, Questionable
+5, 0.10610, 251.3, 267825, 0.22511, 2.0,  0.000591, 0.0001350, 0.00557, 0.001272, 0.150,
+5, 0.10610, 251.3, 267825, 0.22511, 4.0,  0.001810, 0.0001980, 0.01706, 0.001866, 0.150,
+5, 0.10610, 251.3, 267825, 0.22511, 6.0,  0.003470, 0.0003400, 0.03270, 0.003204, 0.150,
+5, 0.10610, 251.3, 267825, 0.22511, 8.0,  0.005515, 0.0005430, 0.05198, 0.005118, 0.150,
+5, 0.10610, 251.3, 267825, 0.22511, 10.0, 0.007740, 0.0008175, 0.07295, 0.007705, 0.150,
+5, 0.10610, 251.3, 267825, 0.22511, 12.0, 0.010000, 0.0011400, 0.09425, 0.010744, 0.150,

database/NACA-TN-626_geom.csv

+# Knight & Hefner, Static Thrust Analysis of the Lifting Airscrew, 1937 (NACA-TN-626)
+# Tags: hover
+# -, -, -, m, m, deg, deg, deg
+geometry, section, airfoil, nBlades, radial pos, chord, twist, precone, sweep
+1, 1, NACA0012, 2, 0.0381, 0.0508, 0, 0, 0
+1, 2, NACA0012, 2, 0.7620, 0.0508, 0, 0, 0
+
+2, 1, NACA0012, 3, 0.0381, 0.0508, 0, 0, 0
+2, 2, NACA0012, 3, 0.7620, 0.0508, 0, 0, 0
+
+3, 1, NACA0012, 4, 0.0381, 0.0508, 0, 0, 0
+3, 2, NACA0012, 4, 0.7620, 0.0508, 0, 0, 0
+
+4, 1, NACA0012, 5, 0.0381, 0.0508, 0, 0, 0
+4, 2, NACA0012, 5, 0.7620, 0.0508, 0, 0, 0

database/NASA-TM-81232_data.csv

+# Caradonna & Tung, Experimental and Analytical Studies of a Model Helicopter Rotor in Hover, 1981 (NASA-TM-81232)
+# Tags: hover, incomplete
+# deg, rpm, -, -, -, -, -, -, -
+collective pitch, rpm, CL@0.5, CL@0.68, CL@0.80, CL@0.89, CL@0.96, CT, notes
+2,  1250, 0.0394, 0.0389, 0.0631, 0.0346, 0.0471, ,
+2,  1500, 0.0374, 0.0503, 0.0651, 0.0319, 0.0481, ,
+2,  1750, 0.0352, 0.0571, 0.0631, 0.0333, 0.0496, ,
+2,  2062, 0.0370, 0.0458, 0.0599, 0.0307, 0.0417, ,
+2,  2265, 0.0331, 0.0370, 0.0596, 0.0325, 0.0496, ,
+2,  2324, 0.0408, 0.0303, 0.0627, 0.0301, 0.0500, ,
+2,  2400, 0.0310, 0.0327, 0.0598, 0.0270, 0.0474, ,
+5,  650,  0.1104, 0.2067, 0.1475, 0.1203, 0.1449, ,
+5,  1250, 0.1028, 0.1249, 0.1539, 0.1183, 0.1500, 0.00213,
+5,  1500, 0.1022, 0.1343, 0.1524, 0.1188, 0.1519, ,
+5,  1750, 0.1049, 0.1395, 0.1180, 0.1539, 0.1542, 0.00218,
+5,  2067, 0.0900, 0.1012, 0.1426, 0.1043, 0.1417, ,
+5,  2268, 0.1015, 0.1198, 0.1513, 0.1173, 0.1563, 0.00200, Fixed error. report says 0.200
+5,  2330, 0.1024, 0.1130, 0.1554, 0.1115, 0.1571, ,
+8,  650,  0.2600, 0.3485, 0.2561, 0.2904, 0.2999, ,
+8,  1250, 0.2345, 0.2815, 0.2886, 0.3143, 0.2683, 0.00459,
+8,  1500, 0.2409, 0.2638, 0.2633, 0.2760, 0.3052, ,
+8,  1750, 0.2374, 0.2728, 0.2690, 0.2835, 0.3125, 0.00455,
+8,  2050, 0.2377, 0.2571, 0.2765, 0.2789, 0.3242, ,
+8,  2250, 0.2275, 0.2768, 0.2751, 0.2937, 0.3250, 0.00462,
+8,  2300, 0.2383, 0.2818, 0.2712, 0.2903, 0.3145, ,
+8,  2350, 0.2372, 0.2803, 0.2812, 0.3008, 0.3194, ,
+8,  2400, 0.2330, 0.2851, 0.2715, 0.2901, 0.3126, ,
+8,  2500, 0.2298, 0.2842, 0.2736, 0.2989, 0.3175, 0.00473, Inconsistency between fig 4 and 6
+8,  2540, 0.2380, 0.2647, 0.2719, 0.2884, 0.3149, ,
+12, 650,  0.4269, 0.5440, 0.4138, 0.4882, 0.4958, ,
+12, 1250, 0.4253, 0.5455, 0.4226, 0.5023, 0.5090, 0.00796,
+12, 1500, 0.4260, 0.5523, 0.4247, 0.4949, 0.5049, ,
+12, 1750, 0.4358, 0.5226, 0.4434, 0.5091, 0.5245, 0.00807,
+12, 2074, 0.4300, 0.5243, 0.4450, 0.5075, 0.5169, ,
+12, 2280, 0.4164, 0.5328, 0.4360, 0.5032, 0.5089, 0.00792,

database/NASA-TM-81232_geom.csv

+# Caradonna & Tung, Experimental and Analytical Studies of a Model Helicopter Rotor in Hover, 1981 (NASA-TM-81232)
+# Tags: hover, incomplete
+# -, -, -, m, m, deg, deg, deg
+geometry, section, airfoil, nBlades, radial pos, chord, twist, precone, sweep
+1, 1, NACA0012, 2, 0.1905, 0.1905, 0, 0.5, 0
+1, 2, NACA0012, 2, 1.143 , 0.1905, 0, 0.5, 0