Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DataHerb/dataherb-python
Python Package for DataHerb: create, search, and load datasets.
https://github.com/DataHerb/dataherb-python
data data-analysis data-mining database dataset python
Last synced: 3 months ago
JSON representation
Python Package for DataHerb: create, search, and load datasets.
- Host: GitHub
- URL: https://github.com/DataHerb/dataherb-python
- Owner: DataHerb
- License: mit
- Created: 2020-02-13T21:08:03.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-07-21T11:57:22.000Z (4 months ago)
- Last Synced: 2024-07-21T13:06:53.007Z (4 months ago)
- Topics: data, data-analysis, data-mining, database, dataset, python
- Language: Python
- Homepage: https://dataherb.github.io/dataherb-python
- Size: 1.12 MB
- Stars: 3
- Watchers: 3
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
The Python Package for DataHerb
A DataHerb Core Service to Create and Load Datasets.
## Install
```
pip install dataherb
```
Documentation: [dataherb.github.io/dataherb-python](https://dataherb.github.io/dataherb-python)
## The DataHerb Command-Line Tool
> Requires Python 3
The DataHerb cli provides tools to create dataset metadata, validate metadata, search dataset in flora, and download dataset.
### Search and Download
Search by keyword
```
dataherb search covid19
# Shows the minimal metadata
```
Search by dataherb id
```
dataherb search -i covid19_eu_data
# Shows the full metadata
```
Download dataset by dataherb id
```
dataherb download covid19_eu_data
# Downloads this dataset: http://dataherb.io/flora/covid19_eu_data
```
### Create Dataset Using Command Line Tool
We provide a template for dataset creation.
Within a dataset folder where the data files are located, use the following command line tool to create the metadata template.
```bash
dataherb create
```
### Upload dataset to remote
Within the dataset folder, run
```bash
dataherb upload
```
### UI for all the datasets in a flora
```bash
dataherb serve
```
## Use DataHerb in Your Code
### Load Data into DataFrame
```
# Load the package
from dataherb.flora import Flora
# Initialize Flora service
# The Flora service holds all the dataset metadata
use_flora = "path/to/my/flora.json"
dataherb = Flora(flora=use_flora)
# Search datasets with keyword(s)
geo_datasets = dataherb.search("geo")
print(geo_datasets)
# Get a specific file from a dataset and load as DataFrame
tz_df = pd.read_csv(
dataherb.herb(
"geonames_timezone"
).get_resource(
"dataset/geonames_timezone.csv"
)
)
print(tz_df)
```
## The DataHerb Project
### What is DataHerb
DataHerb is an open-source data discovery and management tool.
- A **DataHerb** or **Herb** is a dataset. A dataset comes with the data files, and the metadata of the data files.
- A **Herb Resource** or **Resource** is a data file in the DataHerb.
- A **Flora** is the combination of all the DataHerbs.
In many data projects, finding the right datasets to enhance your data is one of the most time consuming part. DataHerb adds flavor to your data project. By creating metadata and manage the datasets systematically, locating an dataset is much easier.
Currently, dataherb supports sync dataset between local and S3/git. Each dataset can have its own remote location.
### What is DataHerb Flora
We desigined the following workflow to share and index open datasets.
> The repo [dataherb-flora](https://github.com/DataHerb/dataherb-flora) is a demo flora that lists some datasets and demonstrated on the website [https://dataherb.github.io](https://dataherb.github.io). At this moment, the whole system is being renovated.
## Development
1. Create a conda environment.
2. Install requirements: `pip install -r requirements.txt`
## Documentation
The source of the documentation for this package is located at `docs`.
## References and Acknolwedgement
- `dataherb` uses `datapackage` in the core. `datapackage` is a python library for the [data-package standard](https://specs.frictionlessdata.io/data-package/). The core schema of the dataset is essentially the data-package standard.