raccoon


Nameraccoon JSON
Version 3.1.1 PyPI version JSON
download
home_page
SummaryPython DataFrame with fast insert and appends
upload_time2023-08-22 13:34:57
maintainer
docs_urlhttps://pythonhosted.org/raccoon/
author
requires_python>=3.4
licenseMIT
keywords dataframe data structure
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            raccoon
=======
Python DataFrame with fast insert and appends

.. image:: https://badge.fury.io/py/raccoon.svg
    :target: https://badge.fury.io/py/raccoon

.. image:: https://app.travis-ci.com/rsheftel/raccoon.svg?branch=master
    :target: https://app.travis-ci.com/rsheftel/raccoon

.. image:: https://coveralls.io/repos/github/rsheftel/raccoon/badge.svg?branch=master
    :target: https://coveralls.io/github/rsheftel/raccoon?branch=master
    
.. image:: https://readthedocs.org/projects/raccoon/badge/?version=latest
   :target: http://raccoon.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status

Documentation
-------------
http://raccoon.readthedocs.io/en/latest/

Source location
~~~~~~~~~~~~~~~
Hosted on GitHub: https://github.com/rsheftel/raccoon

Overview
--------
Raccoon is a lightweight DataFrame and Series implementation inspired by the phenomenal Pandas package for the one use
case where Pandas is known to be sub-optimal: DataFrames and Series that grow in size by adding rows frequently in the code.
Additionally Raccoon DataFrames and Series can be parametrized to be sorted so that additions to the DataFrame keep the
index in sorted order to speed inserts and retrievals.

A simple speed comparison of Raccoon vs Pandas for typical functionality is located in the documentation.

Inspiration
~~~~~~~~~~~
Pandas DataFrames and Series are excellent multi-purpose data structures for data management and analysis. One of the
use cases I had was to use DataFrames as a type of in-memory database table. The issue was that this required lots of
growing the number rows of the DataFrame, something that is known to be slow in Pandas. The reason it is slow in Pandas is that
the underlying data structure is numpy which does a complete copy of the data when the size of the array grows.

Functionality
~~~~~~~~~~~~~
Raccoon implements what is needed to use the DataFrame as an in memory store of index and column data structure
supporting simple and tuple indexes to mimic the hierarchical indexes of Pandas. The methods included are primarily
about setting values of the data frame, growing and appending the data frame and getting values from the data frame.
The raccoon DataFrame is not intended for math operations like pandas and only limited basic math methods are included.

Underlying Data Structure
~~~~~~~~~~~~~~~~~~~~~~~~~
Raccoon uses the standard built in lists as its default underlying data structure. There is an option on object
construction to use any other drop-in replacement for lists. For example the fast blist package
http://stutzbachenterprises.com/blist/ could be used as a list replacement for the underlying data structure.

Why Raccoon?
~~~~~~~~~~~~
According to wikipedia some scientists believe the panda is related to the raccoon

Contributing
~~~~~~~~~~~~
Contribution in the form of pull requests are welcome. Use pytest to run the test suite. Be sure any new additions
come with accompanying tests.

Future
~~~~~~
This package serves the needs it was originally created for. Any future additions by myself will be driven by my own
needs, but it is completely open source so I encourage anyone to add on and expand.

My hope is that one day Pandas solves the speed problem with growing DataFrames and this package becomes obsolete.

Python Version
~~~~~~~~~~~~~~
Raccoon requires Python 3.4 or greater. Python 2.7 support was eliminated as of version 3.0. If you need to use raccoon
with Python 2.7 use any version less than 3.0

Helper scripts
~~~~~~~~~~~~~~
There is helper function to generate these docs from the source code. On windows cd into the docs directory and
execute make_docs.bat from the command line. To run the test coverage report run the coverage.sh script.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "raccoon",
    "maintainer": "",
    "docs_url": "https://pythonhosted.org/raccoon/",
    "requires_python": ">=3.4",
    "maintainer_email": "",
    "keywords": "dataframe,data,structure",
    "author": "",
    "author_email": "Ryan Sheftel <rsheftel@alumni.upenn.edu>",
    "download_url": "https://files.pythonhosted.org/packages/92/84/ba9207d068117856ff423a72fd8e1f9154e3905d285b015445c4a0b8727a/raccoon-3.1.1.tar.gz",
    "platform": null,
    "description": "raccoon\r\n=======\r\nPython DataFrame with fast insert and appends\r\n\r\n.. image:: https://badge.fury.io/py/raccoon.svg\r\n    :target: https://badge.fury.io/py/raccoon\r\n\r\n.. image:: https://app.travis-ci.com/rsheftel/raccoon.svg?branch=master\r\n    :target: https://app.travis-ci.com/rsheftel/raccoon\r\n\r\n.. image:: https://coveralls.io/repos/github/rsheftel/raccoon/badge.svg?branch=master\r\n    :target: https://coveralls.io/github/rsheftel/raccoon?branch=master\r\n    \r\n.. image:: https://readthedocs.org/projects/raccoon/badge/?version=latest\r\n   :target: http://raccoon.readthedocs.io/en/latest/?badge=latest\r\n   :alt: Documentation Status\r\n\r\nDocumentation\r\n-------------\r\nhttp://raccoon.readthedocs.io/en/latest/\r\n\r\nSource location\r\n~~~~~~~~~~~~~~~\r\nHosted on GitHub: https://github.com/rsheftel/raccoon\r\n\r\nOverview\r\n--------\r\nRaccoon is a lightweight DataFrame and Series implementation inspired by the phenomenal Pandas package for the one use\r\ncase where Pandas is known to be sub-optimal: DataFrames and Series that grow in size by adding rows frequently in the code.\r\nAdditionally Raccoon DataFrames and Series can be parametrized to be sorted so that additions to the DataFrame keep the\r\nindex in sorted order to speed inserts and retrievals.\r\n\r\nA simple speed comparison of Raccoon vs Pandas for typical functionality is located in the documentation.\r\n\r\nInspiration\r\n~~~~~~~~~~~\r\nPandas DataFrames and Series are excellent multi-purpose data structures for data management and analysis. One of the\r\nuse cases I had was to use DataFrames as a type of in-memory database table. The issue was that this required lots of\r\ngrowing the number rows of the DataFrame, something that is known to be slow in Pandas. The reason it is slow in Pandas is that\r\nthe underlying data structure is numpy which does a complete copy of the data when the size of the array grows.\r\n\r\nFunctionality\r\n~~~~~~~~~~~~~\r\nRaccoon implements what is needed to use the DataFrame as an in memory store of index and column data structure\r\nsupporting simple and tuple indexes to mimic the hierarchical indexes of Pandas. The methods included are primarily\r\nabout setting values of the data frame, growing and appending the data frame and getting values from the data frame.\r\nThe raccoon DataFrame is not intended for math operations like pandas and only limited basic math methods are included.\r\n\r\nUnderlying Data Structure\r\n~~~~~~~~~~~~~~~~~~~~~~~~~\r\nRaccoon uses the standard built in lists as its default underlying data structure. There is an option on object\r\nconstruction to use any other drop-in replacement for lists. For example the fast blist package\r\nhttp://stutzbachenterprises.com/blist/ could be used as a list replacement for the underlying data structure.\r\n\r\nWhy Raccoon?\r\n~~~~~~~~~~~~\r\nAccording to wikipedia some scientists believe the panda is related to the raccoon\r\n\r\nContributing\r\n~~~~~~~~~~~~\r\nContribution in the form of pull requests are welcome. Use pytest to run the test suite. Be sure any new additions\r\ncome with accompanying tests.\r\n\r\nFuture\r\n~~~~~~\r\nThis package serves the needs it was originally created for. Any future additions by myself will be driven by my own\r\nneeds, but it is completely open source so I encourage anyone to add on and expand.\r\n\r\nMy hope is that one day Pandas solves the speed problem with growing DataFrames and this package becomes obsolete.\r\n\r\nPython Version\r\n~~~~~~~~~~~~~~\r\nRaccoon requires Python 3.4 or greater. Python 2.7 support was eliminated as of version 3.0. If you need to use raccoon\r\nwith Python 2.7 use any version less than 3.0\r\n\r\nHelper scripts\r\n~~~~~~~~~~~~~~\r\nThere is helper function to generate these docs from the source code. On windows cd into the docs directory and\r\nexecute make_docs.bat from the command line. To run the test coverage report run the coverage.sh script.\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Python DataFrame with fast insert and appends",
    "version": "3.1.1",
    "project_urls": {
        "Documentation": "https://raccoon.readthedocs.io/en/latest/",
        "Homepage": "https://github.com/rsheftel/raccoon",
        "Source": "https://github.com/rsheftel/raccoon"
    },
    "split_keywords": [
        "dataframe",
        "data",
        "structure"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "13928ff926c896dc6dc394a9d727edbeae4d9e933372cf713673bddca9343ccb",
                "md5": "da6729746ac24ad6f32c06e88ee8c638",
                "sha256": "8ddc84706761e46d57d6da38505f7559e889dfcc1c5059d9ccc3f28fe4a7dcee"
            },
            "downloads": -1,
            "filename": "raccoon-3.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "da6729746ac24ad6f32c06e88ee8c638",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.4",
            "size": 24344,
            "upload_time": "2023-08-22T13:34:55",
            "upload_time_iso_8601": "2023-08-22T13:34:55.546635Z",
            "url": "https://files.pythonhosted.org/packages/13/92/8ff926c896dc6dc394a9d727edbeae4d9e933372cf713673bddca9343ccb/raccoon-3.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9284ba9207d068117856ff423a72fd8e1f9154e3905d285b015445c4a0b8727a",
                "md5": "f2ecd2fcb40b4125210edc423a9c43c2",
                "sha256": "a8d16fdc8671a35c9652046cb5122aa6b1b21954ccf00a654afa7d159287b7ab"
            },
            "downloads": -1,
            "filename": "raccoon-3.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "f2ecd2fcb40b4125210edc423a9c43c2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.4",
            "size": 24524,
            "upload_time": "2023-08-22T13:34:57",
            "upload_time_iso_8601": "2023-08-22T13:34:57.806893Z",
            "url": "https://files.pythonhosted.org/packages/92/84/ba9207d068117856ff423a72fd8e1f9154e3905d285b015445c4a0b8727a/raccoon-3.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-08-22 13:34:57",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "rsheftel",
    "github_project": "raccoon",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "raccoon"
}
        
Elapsed time: 0.11718s