Users Manual

JavaProp presents itself in a single window or in a single applet area in your browser. It contains a row of tabs on top and a card area below. Each tab shows its associated card which contains input and output elements for a certain topic.

The cards are divided in topics like Design, Airfoils, Geometry, Analysis and Options. Most of these cards have a button bar at the bottom, which contains command buttons acting on this specific card. Depending on the security settings of your Java system, some of these buttons may be inactive (see Applet or Application). Each card is described in more detail in the following sections. Note that when you install JavaProp locally, a more extensive users manual in PDF format will also be installed..

In JavaProp you work with a single "virtual" propeller. This means, that you have a single propeller, which can be designed, analyzed, modified and analyzed again an so forth. All manipulations like airfoil choice, specification of diameter or r.p.m. setting, applying modifications to the blade shape and importing a new blade geometry will alter this virtual propeller.

JavaProp Operation and Data Flow.

The unit system is metric for all entries and results, if not noted otherwise. Some conversion relations for metric and imperial units are given on the Tips and Tricks page.

Printed user's manual:
This page presents a short overview only. You can download a PDF version of a more detailed user's manual.

Design Card

The design card contains all data entries for the design of an optimum propeller. This propeller will have the highest efficiency for the given design point. Some entries like diameter and velocity of rotation are also used for the analysis of propellers. Additional parameters for the design are the design lift and drag coefficients of the airfoil, which must be selected on the Airfoils card. Also, the density on the Option cards must be set correctly for your problem.
The velocity of rotation n is given in revolutions per minute, but for the actual calculations, as in the advance ratio v/(nD)n usually means revolutions per seconds.

You can design a propeller either for given power, thrust or torque.

To start a design, simply push the "Design It!" button. After an optimum propeller has been designed, the results for the design point are listed in a text area below the input fields.

If a spinner diameter is given, it is handled as a simple through flow hole in the center of the propeller.

The shrouded rotor option only switches the tip loss correctionoff , the shape of a shroud is not take into account, nor is its thrust and drag.

A square tip option can be used to maintain a finite chord length at the tip. This is achieved by simply extrapolating the chord lengths of the last two sections towards the tip.

A wind turbine can be designed by entering an arbitrary negative value for the power.

Note: the design procedure also uses the distributions of airfoil sections and the design angles of attack from the Airfoils card..

Airfoils Card

Here you can select which airfoils you want to use along the radius. You can also select a design angle of attack, which is only used for the distribution of lift and drag coefficients for the design of an optimum propeller on the Design card.

The right hand side of the card shows the airfoil polar of the station you are currently working on and also indicates the lift and drag coefficient for the specified angle of attack by symbols. When you select a different airfoil or change the angle of attack, the screen is updated accordingly.

The current version uses synthetic airfoil data, which are characterized by 30 parameters, mainly by zero lift direction, maximum lift coefficient and minimum drag coefficient (look here to see some of the the synthetic polars used in the propeller code). The Reynolds number is fixed so that you might want to check the local Reynolds numbers to select the appropriate polar.

The selected airfoils are used for the design as well as the analysis.

Currently, you can select from the following canned airfoils only:

flat plate
Flat Plate, Re=100'000, Re=500'000
This is more for curiosity and I would not recommend to actually use this airfoil.
Clark Y
Clark Y, Re=100'000, Re=500'000
This is a flat bottom section of about 12% thickness, well suited for standard propellers starting from 50% of the radius outboard.
E 193
E 193, Re=100'000, Re=500'000
This airfoil also has an almost flat bottom and performs similar to the Clark Y.
ARA-D 6%
ARA D 6%, Re=50'000, Re=100'000
This section was designed for the tip region of full size propellers but can also be used at lower Reynolds numbers, e.g. of folding free flight model propellers. It performs much better than a simple cambered plate.
MH 126
MH 126, Re=500'000
This airfoil was designed for the root section of a full size propeller. It covers a wide angle of attack range without separation and has the required thickness for this region.
MH 112
MH 112 16.2%, Re=500'000
This airfoil was designed to follow the root section. It covers the typically needed range of lift coefficients for the inboard region.
MH 114
MH 114 13%, Re=500'000
This airfoil is well suited for the middle part of the propeller halfway between root and tip.
MH 116
MH 116 9.8%, Re=500'000
This airfoil can be used for the tip of propellers operating at tip Mach numbers of 0.6 and below.
MH 120
MH 120 11.5%, Re=400'000, M=0.75
This airfoil was designed for the tip section of propellers and can be operated at high subsonic Mach numbers. As the lift gradient is much steeper under these conditions, its design point should be chosen at a Cl well below 0.7, better below 0.4 for good off design performance.

Geometry Card

This card shows the geometry of the current propeller. Besides the distributions of the chord length c and the blade angle ß in normalized as well as in true dimensions it also shows the local pitch height distribution H.
The button bar has an "Import..." button, which can be used to import any arbitrary geometry. The Import window contains a text area, where you can enter rows of radius, chord and blade angle to describe your blade. Each row should describe a single radial station and entries must be separated by blanks or tabs. JavaProp performs a linear interpolation by assuming straight lines between the data you have supplied. If you specify a single station only these data will be assumed to be valid for the whole blade, two rows of data describe a straight tapered blade, with a linear twist distribution. In most cases it is a better idea to start with an optimum design propeller and to use the Modify card to change the chord and pitch distribution to your likening.

Note: When the Import window is brought up and the clipboard contains some text, this text is preloaded into the text area. So you can copy a table prepared e.g. in Excel to the clipboard, bring up the Import window and import the geometry into JavaProp.

Note about my x-y graphs: You can copy most of the graphs to the clipboard in AutoCad DXF, Adobe Illustrator encapsulated Postscript or SVG vector graphics format by pressing the right mouse button while the mouse pointer is located over the graph (context menu).
Paste the text into a text editor, save as filename.dxf, .eps/.ai or .svg and import into your favorite graphics, CAD or word processing program.
If you have allowed the applet to write files on your system, you can also export the graphics directly to a file.
Additionally, you can import data into a graph to enhance it. For example you can import test results into the the polar plot for comparison. The data is lost when the graph is cleared for a new calculation, though.

You can export the geometry to a file in several formats:
  • a text (*.txt) file containing the geometry table, or
  • an AutoCAD (*.dxf) drawing file containing the surface of the propeller with a coarse representation of the airfoils (31 points),
  • an IGES (*.igs or *.iges) CAD file containing the sections of the propeller.

Depending on the file name extension, one of these formats is selected (extensions are case sensitive!).

Propeller Geometry (45366 Byte)

The sketch shows the parameters which describe the geometry of a propeller. The local chord length c and the blade angle ß (twist angle) are depending on the radius coordinate r.

Modify Card

This card makes it possible to modify a propeller in several ways. These geometric modifications are applied to the current geometry. Therefore a sequence of modifications adds each modification to the result of the previous change.
Often you want to modify a blade so that it better fits your needs or manufacturing methods. For example it is sometimes  desirable to have a straight tapered blade instead of the curved planform coming out of the optimum design method.

To achieve this, you can modify the blade in various ways. The card offers several modifications, which are all applied in sequence, from top to bottom. Usually it makes sense to perform only one modification and to reset the parameter afterwards to avoid any further, undesired changes.

An additional feature on this card is to specify a simplified axial inflow profile, e.g. resulting from a wide fuselage or a large spinner.

Change Blade Angle by ...
Adds the given angle to all stations along the blade. This acts like the blade angle adjustment of a variable pitch propeller.
Scale Blade Angle by ...
Multiplies the blade angle at each station with a factor, which changes the angle in a different way than a variable pitch propeller does: the blade is not rotated as a rigid blade, but it twisted.
Increase Chord by ...
Adds the given length to the chord all along the radius. This works like gluing a strip of constant width to the trailing edge of the blade and to modify the airfoils accordingly.
Scale Chord by ...
Multiplies the chord length at each station with a factor, which changes the chord length but keeps the chord distribution similar to the initial planform shape.
Taper Chord by ...
Similar to the "Scale Chord by..." method, but the scaling factor varies from 1.0 at the root to the given value at the tip. An initial rectangular blade will be tapered to the given tip/root chord ratio. By specifying a taper ratio larger than 1.0, the chord will be increased towards the tip.
To specify an axial inflow profile you can enter two values:
  • the inflow velocity ratio (v/V)* at the hub section (r/R=0) and
  • the station (r/R)* at which the undisturbed inflow velocity (v/V=1) is reached again.

The incoming flow is assumed to vary linearly from (v/V)* at r/R=0 to a value of 1.0 at (r/R)*.
This results in a velocity profile composed of two straight segments:

Multi-Analysis Card

This card can be used to start an automatic analysis run, which starts at static conditions and proceeds to higher advance ratios until the efficiency drops down to negative values and the propeller starts to act as a windmill.

The analysis is performed at fixed intervals of v/(nD) but the step size is adapted and reduced when the efficiency begins to drop.

Results are listed in form of the usual propeller performance coefficients as well as actual velocity, thrust and power values. The output also contains values of η* (eta*) which is the maximum possible efficiency for the current power loading. One column is labeled stalled - it lists the percentage of the blade where the local airfoils are operating at angles of attack beyond stall. Additionally an exclamation mark (!) appears in this column when the power loading is too high for the theory to give accurate results. This usually happens at low advance ratios.

Graphs of some results are placed on separate cards in the lower part of the card. These can be selected by clicking on the appropriate tab.

Note that all results in coefficient form are generally applicable. On the other hand all dimensional data like thrust and power are calculated for the settings found on the Design card. Additionally the fluid density is taken from the Options card. 

If you mount a propeller on a given engine its speed of rotation will depend on the characteristics of the engine. Therefore you have to check and possibly adjust the speed of rotation to match points on the performance curve of your specific engine.

Note: You can copy the graphs to the clipboard in various graphics formats using the right mouse button context menu.

Single-Analysis Card

This card can be used to start an analysis for a single advance ratio, which is determined by the values of axial velocity v, speed of rotation n and diameter D from the Design card.
The table lists the distribution of the aerodynamic coefficients for lift and drag, ratio of lift to drag L/D as well as the local Reynolds and Mach number. Information about the slip stream behind the propeller is included in form of the induced flow factors a and a', which describe the magnitude of the additional velocity in the slip stream at the propeller . The angles δ (delta) and δff (delta_ff) describe the swirl angle of the flow immediately at the propeller and far behind it (far field). finally some coefficients to calculate structural loads are included.

More details can be found on the page Propeller Analysis.

Flow-Field Card

This card presents an approximated view of the slipstream of the propeller. Like the "Single Analysis Card" it runs an analysis for a single advance ratio. It shows a cross section of the flow, extending from in front of the propeller (x = -2R) to behind the propeller (x = +2R).

The border of the slipstream is indicated by a black outline. The color spectrum in the upper part of the card shows the axial velocity from undisturbed inflow (blue) to fully accelerated flow (yellow). The acceleration takes place in front as well as behind the propeller plane and the ratio of the axial velocity to the inflow velocity Vx/V is printed for two locations. In front of the propeller the ratio should be close to 1.0, whereas behind the propeller, the acceleration can be seen. A value of 1.3 means that the axial flow Vx is 30% faster than the flight speed (inflow velocity V).

Options Card

This card offers some information about your Java system and it contains a combo box to select a different country setting. The country setting affects the decimal separator only, the language will be automagically selected based on your system settings (or according to your command line parameters).

The default language is English, but if you want to provide a new language, contact me by email to receive a file with the required text to translate.

Also, you can specify some properties of the fluid where you want the propeller to operate. The most important parameter is the density of the fluid, which controls the chord width of the propeller blades. The kinematic viscosity is needed for the calculation of the local Reynolds number as the speed of sound is used to derive the Mach number.

 

JavaProp can also be used to design and analyze propellers for marine applications ("Hydroprops") provided that these operate fully submerged and without cavitation.

Note that the density of water is higher by a factor of about 1000 than the density of air. This directly affects power and thrust.

 

25°C = 59 F      35°C = 95 F

Typical values for air are given in the following table:
Condition Density
[kg/m³]
kin. Viscosity
[m²/s]
Speed of Sound
[m/s]
15°C @ sea level 1.225 0.000014607 340.29
35°C @ sea level 1.145 0.000016450 351.91
15°C @ 2000 m 0.961 0.000018616 340.29
35°C @ 2000 m 0.898 0.000020964 351.91


Some typical values for water are given below
(the density of salt water is about 2.5% higher):

Condition Density
[kg/m³]
kin. Viscosity
[m²/s]
Speed of Sound
[m/s]
0°C 999.3 0.0000018 n.a.
10°C 999.3 0.0000013 n.a.
20°C 997.3 0.0000010 n.a.
40°C 991.5 0.00000066 n.a.

Last modification of this page: 21.05.18

[Back to Home Page] Suggestions? Corrections? Remarks? e-mail: Martin Hepperle.

Due to the increasing amount of SPAM mail, I have to change this e-Mail address regularly. You will always find the latest version in the footer of all my pages.

It might take some time until you receive an answer and in some cases you may even receive no answer at all. I apologize for this, but my spare time is limited. If you have not lost patience, you might want to send me a copy of your e-mail after a month or so.
This is a privately owned, non-profit page of purely educational purpose. Any statements may be incorrect and unsuitable for practical usage. I cannot take any responsibility for actions you perform based on data, assumptions, calculations etc. taken from this web page.

© 1996-2018 Martin Hepperle
You may use the data given in this document for your personal use. If you use this document for a publication, you have to cite the source. A publication of a recompilation of the given material is not allowed, if the resulting product is sold for more than the production costs.

This document may accidentally refer to trade names and trademarks, which are owned by national or international companies, but which are unknown by me. Their rights are fully recognized and these companies are kindly asked to inform me if they do not wish their names to be used at all or to be used in a different way.

This document is part of a frame set and can be found by navigating from the entry point at the Web site http://www.MH-AeroTools.de/.

Impressum       Datenschutz