squirrel-datasets-core


Namesquirrel-datasets-core JSON
Version 0.3.1 PyPI version JSON
download
home_pagehttps://merantix-momentum.com/technology/squirrel/
SummarySquirrel public datasets collection
upload_time2023-03-27 15:03:46
maintainer
docs_urlNone
authorMerantix Momentum
requires_python>=3.8,<4.0
licenseApache 2.0
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            <div align="center">
  
# <img src="docs/_static/logo.png" width="150px"> Squirrel Datasets Core
  
[![Python](https://img.shields.io/pypi/pyversions/squirrel-datasets-core.svg?style=plastic)](https://badge.fury.io/py/squirrel-datasets-core)
[![PyPI](https://badge.fury.io/py/squirrel-datasets-core.svg)](https://badge.fury.io/py/squirrel-datasets-core)
[![Conda](https://img.shields.io/conda/vn/conda-forge/squirrel-datasets-core)](https://anaconda.org/conda-forge/squirrel-datasets-core)
[![Documentation Status](https://readthedocs.org/projects/squirrel-datasets-core/badge/?version=latest)](https://squirrel-datasets-core.readthedocs.io)
[![Downloads](https://static.pepy.tech/personalized-badge/squirrel-datasets-core?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/squirrel-datasets-core)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://raw.githubusercontent.com/merantix-momentum/squirrel-datasets-core/main/LICENSE)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.6420214.svg)](https://doi.org/10.5281/zenodo.6420214)
[![Generic badge](https://img.shields.io/badge/Website-Merantix%20Momentum-blue)](https://merantix-momentum.com)
[![Slack](https://img.shields.io/badge/slack-chat-green.svg?logo=slack)](https://join.slack.com/t/squirrel-core/shared_invite/zt-14k6sk6sw-zQPHfqAI8Xq5WYd~UqgNFw)

</div>

---
## What is Squirrel Datasets Core?

`squirrel-datasets-core` is an extension of the [Squirrel](https://github.com/merantix-momentum/squirrel-core) library. `squirrel-datasets-core` is a hub where the user can 
1) explore existing public datasets registered in the data mesh and load them with the ease and speed of `squirrel`
2) preprocess their datasets and share them with other users. 

For preprocessing, we currently support Spark as the main tool to carry out the task.

If you have any questions or would like to contribute, join our [Slack community](https://join.slack.com/t/squirrel-core/shared_invite/zt-14k6sk6sw-zQPHfqAI8Xq5WYd~UqgNFw)!

## Installation
Install `squirrel-core` and `squirrel-datasets-core` with pip. Note that you can install with different dependencies based on your requirements for squirrel drivers.
For using the Torchvision driver call:
```shell
pip install "squirrel-core[torch]"
pip install "squirrel-datasets-core[torchvision]"
```
For using the Huggingface or Deeplake driver call:
```shell
pip install "squirrel-datasets-core[huggingface]"
pip install "squirrel-datasets-core[deeplake]"
```
For using the Spark preprocessing pipelines call:
```shell
pip install "squirrel-datasets-core[preprocessing]"
```
If you would like to get Squirrel's full functionality, install squirrel-core and squirrel-datasets-core with all their dependencies.
```shell
pip install "squirrel-core[all]"
pip install "squirrel-datasets-core[all]"
```

## Huggingface, Deeplake, Hub and Torchvision Integration

A great feature of squirrel-datasets-core is that you can easily load data from common databases such as Huggingface, Activeloop Deeplake, Hub and Torchvision with one line of code. And you get to enjoy all of Squirrel’s benefits for free! Check out the [documentation](https://squirrel-datasets-core.readthedocs.io/en/latest/driver_integration.html) on how to interface with these libraries.
```python
from squirrel_datasets_core.driver.huggingface import HuggingfaceDriver

it = HuggingfaceDriver("cifar100").get_iter("train").filter(custom_filter).map(custom_augmentation)

# your train loop
for item in it:
  out = model(item)
  # ...
```

## Documentation

Visit our documentation on [Readthedocs](https://squirrel-datasets-core.readthedocs.io).

## Contributing
`squirrel-datasets-core` is open source and community contributions are welcome!

Check out the [contribution guide](https://squirrel-datasets-core.readthedocs.io/en/latest/contribute.html) to learn how to get involved. 
Please follow our recommendations for best practices and code style. 

## The Humans behind Squirrel
We are [Merantix Momentum](https://merantix-momentum.com/), a team of ~30 machine learning engineers, developing machine learning solutions for industry and research. Each project comes with its own challenges, data types and learnings, but one issue we always faced was scalable data loading, transforming and sharing. We were looking for a solution that would allow us to load the data in a fast and cost-efficient way, while keeping the flexibility to work with any possible dataset and integrate with any API. That's why we build Squirrel – and we hope you'll find it as useful as we do! By the way, [we are hiring](https://merantix-momentum.com/about#jobs)!


## Citation

If you use Squirrel Datasets in your research, please cite Squirrel using:
```bibtex
@article{2022squirrelcore,
  title={Squirrel: A Python library that enables ML teams to share, load, and transform data in a collaborative, flexible, and efficient way.},
  author={Squirrel Developer Team},
  journal={GitHub. Note: https://github.com/merantix-momentum/squirrel-core},
  year={2022}
}
```


            

Raw data

            {
    "_id": null,
    "home_page": "https://merantix-momentum.com/technology/squirrel/",
    "name": "squirrel-datasets-core",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8,<4.0",
    "maintainer_email": "",
    "keywords": "",
    "author": "Merantix Momentum",
    "author_email": "",
    "download_url": "https://files.pythonhosted.org/packages/c0/b3/b5b59add9bd5ef738eee84313930fc9702da56e9d43009a0a573d6fdad16/squirrel_datasets_core-0.3.1.tar.gz",
    "platform": null,
    "description": "<div align=\"center\">\n  \n# <img src=\"docs/_static/logo.png\" width=\"150px\"> Squirrel Datasets Core\n  \n[![Python](https://img.shields.io/pypi/pyversions/squirrel-datasets-core.svg?style=plastic)](https://badge.fury.io/py/squirrel-datasets-core)\n[![PyPI](https://badge.fury.io/py/squirrel-datasets-core.svg)](https://badge.fury.io/py/squirrel-datasets-core)\n[![Conda](https://img.shields.io/conda/vn/conda-forge/squirrel-datasets-core)](https://anaconda.org/conda-forge/squirrel-datasets-core)\n[![Documentation Status](https://readthedocs.org/projects/squirrel-datasets-core/badge/?version=latest)](https://squirrel-datasets-core.readthedocs.io)\n[![Downloads](https://static.pepy.tech/personalized-badge/squirrel-datasets-core?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/squirrel-datasets-core)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://raw.githubusercontent.com/merantix-momentum/squirrel-datasets-core/main/LICENSE)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.6420214.svg)](https://doi.org/10.5281/zenodo.6420214)\n[![Generic badge](https://img.shields.io/badge/Website-Merantix%20Momentum-blue)](https://merantix-momentum.com)\n[![Slack](https://img.shields.io/badge/slack-chat-green.svg?logo=slack)](https://join.slack.com/t/squirrel-core/shared_invite/zt-14k6sk6sw-zQPHfqAI8Xq5WYd~UqgNFw)\n\n</div>\n\n---\n## What is Squirrel Datasets Core?\n\n`squirrel-datasets-core` is an extension of the [Squirrel](https://github.com/merantix-momentum/squirrel-core) library. `squirrel-datasets-core` is a hub where the user can \n1) explore existing public datasets registered in the data mesh and load them with the ease and speed of `squirrel`\n2) preprocess their datasets and share them with other users. \n\nFor preprocessing, we currently support Spark as the main tool to carry out the task.\n\nIf you have any questions or would like to contribute, join our [Slack community](https://join.slack.com/t/squirrel-core/shared_invite/zt-14k6sk6sw-zQPHfqAI8Xq5WYd~UqgNFw)!\n\n## Installation\nInstall `squirrel-core` and `squirrel-datasets-core` with pip. Note that you can install with different dependencies based on your requirements for squirrel drivers.\nFor using the Torchvision driver call:\n```shell\npip install \"squirrel-core[torch]\"\npip install \"squirrel-datasets-core[torchvision]\"\n```\nFor using the Huggingface or Deeplake driver call:\n```shell\npip install \"squirrel-datasets-core[huggingface]\"\npip install \"squirrel-datasets-core[deeplake]\"\n```\nFor using the Spark preprocessing pipelines call:\n```shell\npip install \"squirrel-datasets-core[preprocessing]\"\n```\nIf you would like to get Squirrel's full functionality, install squirrel-core and squirrel-datasets-core with all their dependencies.\n```shell\npip install \"squirrel-core[all]\"\npip install \"squirrel-datasets-core[all]\"\n```\n\n## Huggingface, Deeplake, Hub and Torchvision Integration\n\nA great feature of squirrel-datasets-core is that you can easily load data from common databases such as Huggingface, Activeloop Deeplake, Hub and Torchvision with one line of code. And you get to enjoy all of Squirrel\u2019s benefits for free! Check out the [documentation](https://squirrel-datasets-core.readthedocs.io/en/latest/driver_integration.html) on how to interface with these libraries.\n```python\nfrom squirrel_datasets_core.driver.huggingface import HuggingfaceDriver\n\nit = HuggingfaceDriver(\"cifar100\").get_iter(\"train\").filter(custom_filter).map(custom_augmentation)\n\n# your train loop\nfor item in it:\n  out = model(item)\n  # ...\n```\n\n## Documentation\n\nVisit our documentation on [Readthedocs](https://squirrel-datasets-core.readthedocs.io).\n\n## Contributing\n`squirrel-datasets-core` is open source and community contributions are welcome!\n\nCheck out the [contribution guide](https://squirrel-datasets-core.readthedocs.io/en/latest/contribute.html) to learn how to get involved. \nPlease follow our recommendations for best practices and code style. \n\n## The Humans behind Squirrel\nWe are [Merantix Momentum](https://merantix-momentum.com/), a team of ~30 machine learning engineers, developing machine learning solutions for industry and research. Each project comes with its own challenges, data types and learnings, but one issue we always faced was scalable data loading, transforming and sharing. We were looking for a solution that would allow us to load the data in a fast and cost-efficient way, while keeping the flexibility to work with any possible dataset and integrate with any API. That's why we build Squirrel \u2013 and we hope you'll find it as useful as we do! By the way, [we are hiring](https://merantix-momentum.com/about#jobs)!\n\n\n## Citation\n\nIf you use Squirrel Datasets in your research, please cite Squirrel using:\n```bibtex\n@article{2022squirrelcore,\n  title={Squirrel: A Python library that enables ML teams to share, load, and transform data in a collaborative, flexible, and efficient way.},\n  author={Squirrel Developer Team},\n  journal={GitHub. Note: https://github.com/merantix-momentum/squirrel-core},\n  year={2022}\n}\n```\n\n",
    "bugtrack_url": null,
    "license": "Apache 2.0",
    "summary": "Squirrel public datasets collection",
    "version": "0.3.1",
    "project_urls": {
        "Documentation": "https://squirrel-datasets-core.readthedocs.io/en/latest/",
        "Homepage": "https://merantix-momentum.com/technology/squirrel/",
        "Repository": "https://github.com/merantix-momentum/squirrel-datasets-core"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "71c5f6316bb852a02b12469bda3f1d451a8a6c834ff09ea42a73ac6d0bc4b873",
                "md5": "a11d08e1ced31f337b058a4f685cb406",
                "sha256": "062d2c3461ef283d8a5fab1d12c1e61ce4bff10aa3017f2bbadf85bf56bc9096"
            },
            "downloads": -1,
            "filename": "squirrel_datasets_core-0.3.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a11d08e1ced31f337b058a4f685cb406",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8,<4.0",
            "size": 65900,
            "upload_time": "2023-03-27T15:03:44",
            "upload_time_iso_8601": "2023-03-27T15:03:44.565219Z",
            "url": "https://files.pythonhosted.org/packages/71/c5/f6316bb852a02b12469bda3f1d451a8a6c834ff09ea42a73ac6d0bc4b873/squirrel_datasets_core-0.3.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c0b3b5b59add9bd5ef738eee84313930fc9702da56e9d43009a0a573d6fdad16",
                "md5": "10588e94f46cfb5a3ce31f9b31d20705",
                "sha256": "7d22c05101bd40a0e7d8c668dc31d3590441349321ba0aa77a15de8fab534585"
            },
            "downloads": -1,
            "filename": "squirrel_datasets_core-0.3.1.tar.gz",
            "has_sig": false,
            "md5_digest": "10588e94f46cfb5a3ce31f9b31d20705",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8,<4.0",
            "size": 41495,
            "upload_time": "2023-03-27T15:03:46",
            "upload_time_iso_8601": "2023-03-27T15:03:46.459179Z",
            "url": "https://files.pythonhosted.org/packages/c0/b3/b5b59add9bd5ef738eee84313930fc9702da56e9d43009a0a573d6fdad16/squirrel_datasets_core-0.3.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-03-27 15:03:46",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "merantix-momentum",
    "github_project": "squirrel-datasets-core",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "requirements": [],
    "lcname": "squirrel-datasets-core"
}
        
Elapsed time: 0.07137s