https://github.com/abougouffa/m2hpf
HPF - DT High Performance File Format high speed decoding library, aka. a library to read Delsys EMGworks *.hpf files
https://github.com/abougouffa/m2hpf
delsys emgworks high-performance-file-format hpf modula-2
Last synced: 3 months ago
JSON representation
HPF - DT High Performance File Format high speed decoding library, aka. a library to read Delsys EMGworks *.hpf files
- Host: GitHub
- URL: https://github.com/abougouffa/m2hpf
- Owner: abougouffa
- License: lgpl-3.0
- Created: 2019-05-30T22:39:35.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-04-08T22:15:01.000Z (about 2 years ago)
- Last Synced: 2023-10-20T16:06:20.448Z (over 1 year ago)
- Topics: delsys, emgworks, high-performance-file-format, hpf, modula-2
- Language: Modula-2
- Homepage:
- Size: 83 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://forums.ni.com/ni/attachments/ni/170/813238/1/high_performance_file_format_spec%5B1%5D.pdf) 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 (508) 481-3700
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](https://www.delsys.com) 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](https://www.modula2.org/adwm2/)** 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`](https://github.com/abougouffa/m2hpf/blob/master/def/HPFFile.def#L62-L68) enumeration.
For example, in **[GNU Modula-2](https://www.nongnu.org/gm2/homepage.html)**, there is an equivalent [`<* bytealignment (x) *>` pragma](https://www.nongnu.org/gm2/12/packed.html) 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](high_performance_file_format_spec.pdf), 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](https://abougouffa.github.io) 2019-2021