Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
dciliberti authored Feb 23, 2021
1 parent e58856a commit 34d0b8d
Showing 1 changed file with 6 additions and 4 deletions.
10 changes: 6 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Calculate the Lehner© 2280-40 electric motor map from performance data issu
If you are is satisfied with the default motor data, then skip to the [Usage](#usage) section

## Code structure
The code is entirely written in MATLAB. The structure is as follows:
The code is entirely written in MATLAB®. The structure is as follows:

| Name | Type |
| :--- | :--- |
Expand Down Expand Up @@ -34,16 +34,17 @@ The software has one main script `performanceCharts.m` and several functions to
Therefore, any electric motor data can be imported and plotted, although this software is focused on the 2280-40 for my research activities.

## Usage
The program will interpolate data to plot the motor performance maps and the achievable propeller operating points. For the first time, just hit RUN on the MATLAB® toolbar to get a demo.

### Input
At the beginning of the main script `performanceCharts.m` the following variables are assigned:
- `propDiam`: the propeller diameter in meters, assigned by the user
- `windSpeed`: the advance speed of the propeller in m/s, assigned by the user
- `Jconv`: a conversion factor from RPM to advance ratio J, pre-defined

Then the user should write the propeller operating point of interest. If none, the program should only show the motor performance maps without propeller data points. The utility of this software is to plot the propeller operating points acheivable with the motor. A gearbox may be included.
Then the user should write the propeller operating points of interest. If none, the program should only show the motor performance map charts without propeller data points.

After defining the propeller diameter and the wind speed in the first lines of the main script `performanceCharts.m`, the user should write the propeller operating condition as a matrix. Each column correspond to a given quantity, i.e. Thrust, Shaft Power, RPM. Each row is a different combination of these quantities. For instance:
Each propeller is defined as a matrix. Each column correspond to a given quantity, i.e. Thrust, Shaft Power, RPM. Each row is a different combination of these quantities defining a data point. For instance:

| Thrust (N) | Shaft Power (W) | (RPM) |
| --- | --- | --- |
Expand All @@ -65,7 +66,8 @@ For instance, in case of three propellers we must have three numbers for each ar
`gratio = [1, 4, 3]`
`gloss = [0.0, 0.10, 0.05]`

To eliminate the gearbox just assign 1 to `gratio` and 0 to `gloss`, but always matching the number of elements with the number of conditions.
To eliminate the gearbox just assign 1 to `gratio` and 0 to `gloss`, but always match the number of elements with the number of conditions.

### Output
Actually the outputs are six charts: three 3D plots and three contours. Please, keep in mind that the J axis in the contour plot is referred to the values assigned to `propdiam` and `windSpeed`, therefore if your propeller data do not match these reference values, the conversion between RPM and J will be wrong and only the RPM axis should be looked.

0 comments on commit 34d0b8d

Please sign in to comment.