Package-redvox-to-hdf5 is a utility to convert Redvox a collection of infrasound packets a HDF5 file. Converting to one file eases the burden on analysts who are both familiar with the HDF5 format, and who want to work with a small number of files (Redvox-enabled phones can produce 1000's of infrasound recordings a day).
This work was performed under the auspices of the U.S. Department of Energy by Lawrence Livermore National Laboratory under Contract DE-AC52-07NA27344.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
GitHub hosts certain releases of this software which would save you the effort of downloading Maven to build the code. You can find all released versions here.
To build and run the code, you will need to download and install the following tools:
- HDF View : Installing HDF View will provide the HDF5 libraries necessary to run package-redvox-to-hdf5 and it will also provide a viewer for you to see what is contained in the output files.
- Java 8: This code is written for Java 8. I have not tried to compile on later versions of Java.
- Apache Maven: Maven is used to manage the external library dependencies and build this software.
1. Clone this repository.
2. Change directory (cd) to the project's root folder.
3. Execute: mvn install
To run this program, you will have to specify the location of the HDF5 libraries on your computer as part of the java command. The program takes two input parameters, the path to a directory containing Redvox packets in JSON format, and the desired output filename.
- On OS X:
java -Xmx2G -Djava.library.path=/Applications/HDFView.app/Contents/MacOS -cp target/PackageRedvoxToHdf5-1.0.1.jar gov.llnl.gmp.minos.uhtolbnlpipeline.PackageRedvoxToHdf5 <input directory> <output filename>
- HDF View: A program that lets you visually explore the contents of HDF5 files. You can view groups, datasets, attributes, and even view the dataset contents if they fit in memory.
- h5py: A python library for programatically interacting with a dataset.
- Maven - Dependency Management
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
- Steven Magaña-Zook - Initial work - Stevenmz
This project is licensed under the GPL 3.0 License - see the COPYING file for details
- Dr. Anthony Christe for his tireless efforts creating the Redvox infrastructure and software.
- Dr. Milton Garces for his leadership in getting the Redvox technology into researcher hands.
- The rest of the University of Hawaii Infrasound Laboratory (ISLA) that made Redvox Infrasound tools accessible to the research community.
This document was prepared as an account of work sponsored by an agency of the United States government. Neither the United States government nor Lawrence Livermore National Security, LLC, nor any of their employees makes any warranty, expressed or implied, or assumes any legal liability or responsibility for the accuracy, completeness, or usefulness of any information, apparatus, product, or process disclosed, or represents that its use would not infringe privately owned rights. Reference herein to any specific commercial product, process, or service by trade name, trademark, manufacturer, or otherwise does not necessarily constitute or imply its endorsement, recommendation, or favoring by the United States government or Lawrence Livermore National Security, LLC. The views and opinions of authors expressed herein do not necessarily state or reflect those of the United States government or Lawrence Livermore National Security, LLC, and shall not be used for advertising or product endorsement purposes.