Metadata-Version: 2.1
Name: rocketlogger
Version: 2.0.0
Summary: RocketLogger Python Support
Home-page: https://github.com/ETHZ-TEC/RocketLogger#readme
Author: ETH Zurich, Computer Engineering Group
License: BSD 3-Clause
Project-URL: Documentation, https://github.com/ETHZ-TEC/RocketLogger/wiki/python
Project-URL: Source, https://github.com/ETHZ-TEC/RocketLogger
Project-URL: Tracker, https://github.com/ETHZ-TEC/RocketLogger/issues
Keywords: rocketlogger,data analysis,calibration
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6, <4
Description-Content-Type: text/markdown
Provides-Extra: dataframe
Provides-Extra: plot
Provides-Extra: dev
Provides-Extra: test
License-File: LICENSE

# RocketLogger Python Support Library

This package provides RocketLogger data file handling support, as well as
basic processing and plotting of the data. Further, it provides the necessary
support to generate calibration data from measurements.

**Dependencies**
* Python 3: version 3.6-3.9
* NumPy: version 1.13-1.20

**Optional dependencies**
* Matplotlib: for plotting data overview
* pandas: for pandas DataFrame export


## Installation

The package is available from the [Python Package Index](https://pypi.org/project/rocketlogger/)
Install the package using pip:
```bash
python -m pip install rocketlogger
```


## Getting Started

### RocketLogger Data Processing

To import a RocketLogger data (`*.rld`) file, use the `RocketLoggerData` class:
```py
>>> from rocketlogger.data import RocketLoggerData
>>> rld = RocketLoggerData('data.rld')
```

To merge channels with auto-ranging, i.e. the current channels:
```py
>>> rld.merge_channels()
```

To get the loaded channel data (by name) and corresponding timestamps:
```py
>>> d = rld.get_data(['V1', 'I1'])
>>> t = rld.get_time()
```

For more details about the individual functions and their parameters, refer to
the documentation available at <https://github.com/ETHZ-TEC/RocketLogger/wiki/python>.


### RocketLogger Device Calibration

The `RocketLoggerCalibration` class from the `rocketlogger.calibration` module
provides the necessary support for generating RocketLogger device calibration.
See the [Calibration](https://github.com/ETHZ-TEC/RocketLogger/wiki/calibration) wiki section for more details on the calibration
procedure.


## Documentation

The documentation for the RocketLogger is found in the wiki pages at
<https://github.com/ETHZ-TEC/RocketLogger/wiki>.


## License

The RocketLogger Project is released under [3-clause BSD license](https://opensource.org/licenses/BSD-3-Clause).
For more details, refer the the [LICENSE](LICENSE) file.


