Reference Algorithm

How to use

Quick Start:

Step 1: Convert TXT, PRF, SDF, SMD files to SMD file format with Filter and Parameters information.

1.1 Click the Hyperlink below:
http://161.112.232.32/softgauges/Converter.aspx
1.2 Upload the data file;
1.3 Select the SMD format;
1.4 Choose the Lc value;
1.5 Click "Convert Now" button;
1.6 Save the SMD file to your computer.

Note:
Reference Algorithm will use the filter and calculate parameters which are listed in the SMD header.

Example:

ISO 5436 - 2000 ground01meas
PRF 1 ISO5436
CX I 22401 mm 1.0e0 D 2.5e-4
CZ A 22401 um 1.0e0 D

DATE 25-Nov-2004
TIME 10:57
CREATED_BY University of Huddersfield
PARAMETER_VALUE Pa 0 mm 0
PARAMETER_VALUE Ra 0 mm 0
PARAMETER_VALUE Wa 0 mm 0
PARAMETER_VALUE Pq 0 mm 0
PARAMETER_VALUE Rq 0 mm 0
PARAMETER_VALUE Wq 0 mm 0
PARAMETER_VALUE Pku 0 mm 0
PARAMETER_VALUE Rku 0 mm 0
PARAMETER_VALUE Wku 0 mm 0
PARAMETER_VALUE Psk 0 mm 0
PARAMETER_VALUE Rsk 0 mm 0
PARAMETER_VALUE Wsk 0 mm 0
PARAMETER_VALUE Pp 0 mm 0
PARAMETER_VALUE Rp 0 mm 0
PARAMETER_VALUE Wp 0 mm 0
PARAMETER_VALUE Pv 0 mm 0
PARAMETER_VALUE Rv 0 mm 0
PARAMETER_VALUE Wv 0 mm 0
PARAMETER_VALUE Pz 0 mm 0
PARAMETER_VALUE Rz 0 mm 0
PARAMETER_VALUE Wz 0 mm 0
PARAMETER_VALUE Pt 0 mm 0
PARAMETER_VALUE Rt 0 mm 0
PARAMETER_VALUE Wt 0 mm 0
PARAMETER_VALUE Pc 0 mm 0
PARAMETER_VALUE Rc 0 mm 0
PARAMETER_VALUE Wc 0 mm 0
PARAMETER_VALUE PSm 0 mm 0
PARAMETER_VALUE RSm 0 mm 0
PARAMETER_VALUE WSm 0 mm 0
PROFILE_FILTER Gaussian LS 0.0e0 LC 8.0e-1

Step 2: Run GUI, Open SMD file which has been converted using the site Softgauge site tools.

The GUI supplied with the software is only intended to show use of the functionality of:

  • Loading SMD files. The input to the software is an SMD file consistent with the requirements of ISO 5436-2 (2001)[1].
  • Calculations of the surface texture parameters Pa, Ra, Wa, Pq, Rq, Wq, Psk, Rsk, Wsk, Pku, Rku, Wku, Pp, Rp, Wp, Pv, Rv, Wv, Pz, Rz, Wz, PSm, RSm, WSm, Pc, Rc, Wc, Pt, Rt, Wt consistent with ISO 4287 (2000)[4].
  • The Data (blue) area displays only the first and last part of the data.

The GUI has four basic functions:

  • Open SMD file Opens an SMD file and calculates parameters as defined in the PARAMETER_VALUE option of record 2 of the file. If the Parameter_name field of PARAMETER_VALUE is one of Pa, Ra, Wa, Pq, Rq, Wq, Psk, Rsk, Wsk, Pku, Rku, Wku, Pp, Rp, Wp, Pv, Rv, Wv, Pz, Rz, Wz, PSm, RSm, WSm, Pc, Rc, Wc, Pt, Rt, the software will calculate a value for that parameter. The value is displayed in the GUI.
  • Save SMD file Saves an SMD file with the calculated parameter value. The Parameter_name field is given by the original one preceded by REF:, for example, REF:Ra for the roughness parameter Ra.
  • Save HTML file Saves the contents of the Select files (pink), Header (yellow) and Parameters (green) areas of the GUI as an HTML file.
  • Quit Quits the software.

Step 3: Saves an SMD file with the calculated parameter values. The Parameter_name field is given by the original name preceded by REF:, for example, REF:Ra for the roughness parameter Ra.

Documentation of the API[1] for softgauges

It is possible to interface to the Java methods for parsing SMD files and calculating values for the parameters. This has been shown to work for both Java and MATLAB http://www.mathworks.com/access/helpdesk/help/techdoc/matlab_external/matlab_external.html. The documentation for these methods is contained in the doc.zip file.

To look at the documentation it is necessary to extract the documentation from the file doc.zip using a suitable unzipping tool, and then open the file index.html using an appropriate browser.

Notes:
[1] API is an abbreviation for "application program interface".