REDUCE, IMPROVE, RESTORE

REDUCE-IMPROVE-RESTORE

Wayne Stahnke's Punch Matrix Reconstruction Software

The programs are:

		Current Version
REDUCE.EXE	Converts the MAP bitmap image into a RAW vector image file.	12.24 28 Aug 2018	Advanced options
IMPROVE.EXE	The clever part that manipulates the RAW file to align all the punches into neat rows and columns.	12.67 10 Sep 2023	Advanced options
RESTORE.EXE	Converts the processed RAW file into a WEB punch file.	12.03 26 Sep 2018	Advanced options

These are MS-DOS programs which cannot be run directly under the latest 64-bit versions of Windows,
however it is still possible to run them using a DOS emulator such as DOSBox.

Batch File

The EXE files are invoked from a BAT file placed in the same folder as the MAP and ANN files.
The BAT file specifies the MAP/ANN filename (minus the file extension)
and can also include the path to the EXE files.

SET FN=[insert filename without an extension]
PATH=[insert path to EXE files here];%PATH%

REDUCE %FN%
IF ERRORLEVEL 1 GOTO END
IMPROVE %FN%
IF ERRORLEVEL 1 GOTO END
RESTORE %FN%
IF ERRORLEVEL 1 GOTO END
ERASE %FN%.RAW

:END

Annotation File

The associated ANN file should include as a bare minimum the following keywords:

	/roll_type:	see here* for full details*
	/roll_class:	see here* for full details*
	/read_step:	0.001 mm or 0.0001 mm	/read_step: defines the resolution of all internal calculations and is set small enough for accumulated rounding errors to be insignificant
	/punch_step:	punch advance (mm)	equals 304.8 / Steps Per Foot
For round punches:
	/punch_size:	punch diameter (mm)
For square or rectangular punches:
	/punch_width:	punch width (mm)
	/punch_length:	punch height (mm)
For obround or oval punches:
	/punch_size:	punch width (mm)
	/punch_length:	punch height (mm)

Three optional keywords that add blank rows
	/prefix:	n	Adds n blank rows at the start
	/suffix:	n	Adds n blank rows at the end
	/auto:	n (2 or 3)	Used mainly with Licensee rolls which benefit from a coherent webbing phase. Automatically adds blank rows at the start so that punches fall on rows that are multiples of n. Row slips may then be readily detected by setting View's fast advance to the same value.

Download Punch Matrix Reconstruction Software

STAHNKE.ZIP

Download Example

EXAMPLE.ZIP

Skew, Scatter, and Pitch in Music Rolls by Wayne Stahnke

release3.pdf (28 Nov 2023)