Metadata-Version: 2.1
Name: edge-ml
Version: 0.2.1
Summary: Python library of edge-ml.org: end-to-end machine learning for embedded devices
Home-page: https://github.com/edge-ml/python
Author: KIT/TECO
Author-email: KIT/TECO <info@edge-ml.org>
Project-URL: Home, https://edge-ml.org
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# edge-ml python
[![Tests](https://github.com/edge-ml/python/actions/workflows/tests.yml/badge.svg)](https://github.com/edge-ml/python/actions/workflows/tests.yml)
[![PyPI Publish](https://github.com/edge-ml/python/actions/workflows/PyPIPublish.yml/badge.svg)](https://github.com/edge-ml/python/actions/workflows/PyPIPublish.yml)

Python package for [edge-ml.org](https://edge-ml.org).

## Usage
### Installation
Install edge-ml using the follwing command.
```bash
pip install edge-ml
```

### Retrieve Project
This functionality comes in handy if you would like to train a machine learning model from edge-ml data.
```python
from edgeml import edgeml

# get the API key from the settings of your project
project = edgeml.getProject("https://app.edge-ml.org", PROJECT_API_KEY) 
```

### Push Data from Python
```python
from edgeml import edgeml
import time

key = "YOUR_API_KEY"
startTime = time.time()
collector = edgeml.datasetCollector("https://app.edge-ml.org",
                                    key,
                                    "Example Dataset", # name the dataset you would like to upload
                                    False) # do not use server timestamps

for i in range(500):
    current_time = startTime + i * 10 # adding samples at 10 ms time steps
    collector.addDataPoint("Accelerometer X", random.randint(1,50) / 10.0, current_time) 
    collector.addDataPoint("Accelerometer Y", random.randint(1,50) / 10.0, current_time) 
    collector.addDataPoint("Accelerometer Z", random.randint(1,50) / 10.0, current_time) 

collector.onComplete()
```

## Development
### Testing
To run the tests please enter:

```bash
python -m unittest -v tests/all.py
```
