abougouffa/m2hpf

HPF - DT High Performance File Format high speed decoding library, aka. a library to read Delsys EMGworks *.hpf files

m2hpf

HPF - DT High Performance File Format high speed decoding library (for the Modula-2 programming language)

The current version of m2hpf only support reading *.hpf files. It cannot be used to write files in HPF format.

This implementation is based on the DT HPF file format, which is described in a document I found some where on the internet entitled DT High Performance File Format Specification.

Copyrighted as:

DT High Performance File Format Specification
_______________________________
Document Number: 22760, Rev A
Copyright © 2007 Data Translation, Inc. All rights reserved.
_______________________________
Data Translation, Inc.
100 Locke Drive
Marlborough, MA 01752-1192, USA
Telephone [phone]
Home Page http://www.datatranslation.com/

---

The m2hpf library implements a slightly modified version of the format described in the document above, it has been written to support the actual format of Delsys EMGworks signals.

This library is made to provide quick data access, to be used in a real-time signal processing project. For example; using this library to implement a HPF to CSV file converter will be much more efficient than using the Delsys File Utility.

The library has been written in Modula-2 and it is published under the LGPL-3.0 license.

Compiling m2hpf

m2hpf has been tested on the ADW Modula-2 compiler on a Win 32-bit target.

The m2hpf is implemented using the Modula-2 ISO standard, but uses some ADW Modula-2 language extensions and the specific compiler directive <*/PACK*> in HPFFile.def.

For this implementation to work also with another ISO compliant compiler, you need to find an equivalent directive to <*/PACK*> for your compiler. You will need to modify the HPFFile.def to use the equivalent directive, and modify some ADW Modula-2 specific code, like in the hard-coded values in the CHUNK_ID enumeration.

For example, in GNU Modula-2, there is an equivalent <* bytealignment (x) *> pragma to implement the packed types. However, you still need to modify the code yourself, and find an alternative way to deal with the hard-coded enumerations issue.

---

THIS LIBRARY IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

IF YOU WANT USE THIS LIBRARY IN TOUR PROJECT, YOU MAY NEED TO READ THE FILE FORMAT SPECS DOCUMENT, SPECIALLY THE STATEMENT ON PAGE 1:

All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Data Translation, Inc.

Abdelhak Bougouffa 2019-2021