To use the example files, you must save the indicated example file as in.mlt in the main Michlet directory (i.e. the directory that contains the executable file). This will overwrite the current in.mlt with the example input file. You may be required to save additional files in the directory before running some examples.
Remember to use the Esc to escape from any screen when running the examples.
When you first install Michlet, the in.mlt file is a copy of the wigley_ex1a.mlt file described below.
wigley_ex1a.mlt: The table of offsets is contained inside the input file.
wigley_ex1b.mlt: Offsets are generated using hull Series 1.
wigley_ex1c.mlt: Offsets are generated using hull Series 8.
wigley_ex1d.mlt: Offsets are contained in a separate file. To run this example, first save the file wigley_ex1d.mlt as in.mlt in the same directory as the executable. You must also save the file wigley_useroff1.csv as useroff1.mlt in that directory.
wigley_ex1e.mlt: Offsets are generated using splines that are defined in a separate file. To run this example, first save the file wigley_ex1e.mlt as in.mlt in the same directory as the executable. You must also save the file wigley_sploff1.mlt as sploff1.csv in that directory.
To calculate resistance, press R from the main screen, then choose one of the display options.
To examine wave pattern plots, press Esc until you are back at the original screen. Now press W and choose the Transverse Cut view by pressing T. Note the small oscillations near the left-hand and right-hand edges of the graph. These are due to an insufficient number of theta intervals being used in the calculations. If Ntheta was increased to, say 1024, in the input file, these oscillations would not be apparent, however, calculations will take roughly twice as long.
Press Esc and the press R to see a contour plot of a rectangular region of the wave field. The striations inside the V-shape are due to an insufficient number of points being used. If the number of nodes in the x-direction and the y-direction were both increased to, say 301, the striations would disappear, but calculations would take almost nine times longer. Clearly, it is important to use as many points as is necessary for the particular task at hand.
Twenty-one stations and waterlines have been used in all five examples. When a table of offsets is used, as in examples 1a and 1d, it is not easy to increase (or decrease) the number of stations and/or waterlines. For the mathematical series (examples 1b and 1c) and the spline method (example 1e), all that is required is for the number of stations and the number of waterlines to be changed. Remember to use odd integers for both!
If you want a permanent copy of the input file you have just modified, save it using a meaningful filename in another directory. You should also save any associated files (e.g. useroff1.csv or sploff1.csv) in the same directory.
Note that there will be small differences between the hull parameters calculated for the five examples due to the different methods for representing hull offsets. Results will be most accurate for the method using the mathematical series. Less accurate are the methods using tables of offsets. The spline method is the least accurate of the five methods, but could be improved by using more nodes.
Note that the offsets for the NPL examples use the spline input method to generate offsets. Before running an example, make sure that you have saved the file npl_sploff1.csv as sploff1.csv in the same directory as the Michlet executable. The same spline file can be used for all NPL series hulls.
Comparisons of Michlet resistance predictions with experimental data for this series of hulls is available in the Excel spreadsheet located in the 'docs' directory.
NOTE: Michlet's calculations have not yet been validated, and the scaling of the pressure has not been checked. Please treat this as an illustrative example only.
Run this example and press P from the opening screen to invoke the Pressure Signature menu. Then press R to calculate the bottom pressures. The maximum absolute pressure (above atmospheric) is about 590 Pa.
Press c and then enter 200. The high pressure zone forward of the bow should now be more apparent.
You can save the pressure data by pressing s. You can also save the contour plot as a .pcx file by pressing S.
This example calculates elevations at 151x151=22801 field points using Ntheta=512 which should take about 30 seconds on a 1GHz PC.
Remember to save wave elevation plots and data from the Waves screen before you exit the program if you require a permanent copy of the output.
This example calculates elevations at 301x301=90601 field points using Ntheta=1024 which should take about 4 minutes on a 1GHz PC. Since the wave field is (laterally) symmetric, that time could be halved by considering only one side of the vessel.