| Name | aiida-dataframe JSON |
| Version |
0.2.0
JSON |
| download |
| home_page | None |
| Summary | AiiDA data plugin for pandas DataFrame objects |
| upload_time | 2025-07-17 10:29:50 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.7 |
| license | None |
| keywords |
aiida
plugin
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[![Build Status][ci-badge]][ci-link]
[![Coverage Status][cov-badge]][cov-link]
[![Docs status][docs-badge]][docs-link]
[![PyPI version][pypi-badge]][pypi-link]
# aiida-dataframe
AiiDA data plugin for pandas DataFrame objects
## Features
* Store `pandas.DataFrame` objects in the Database:
```python
import pandas as pd
PandasFrameData = DataFactory('dataframe.frame')
df = pd.DataFrame(
{
"A": 1.0,
"B": pd.Timestamp("20130102"),
"C": pd.Series(1, index=list(range(4)), dtype="float32"),
"D": np.array([3] * 4, dtype="int32"),
"E": pd.Categorical(["test", "train", "test", "train"]),
"F": "foo",
}
)
df_node = PandasFrameData(df)
df_node.store()
```
* Retrieving the `pandas.DataFrame` from the Database :
```python
from aiida.orm import QueryBuilder
df_node = QueryBuilder().append(PandasFrameData).first()[0]
df = df_node.df #The df property reconstructs the pandas DataFrame
print(df.head())
```
## Installation
```shell
pip install aiida-dataframe
verdi quicksetup # better to set up a new profile
verdi plugin list aiida.data # should now show your data plugins
```
## Usage
The plugin also includes verdi commands to inspect its data types:
```shell
verdi data dataframe list
verdi data dataframe export <PK>
verdi data dataframe show <PK>
```
## Development
```shell
git clone https://github.com/janssenhenning/aiida-dataframe .
cd aiida-dataframe
pip install --upgrade pip
pip install -e .[pre-commit,testing] # install extra dependencies
pre-commit install # install pre-commit hooks
pytest -v # discover and run all tests
```
See the [developer guide](http://aiida-dataframe.readthedocs.io/en/latest/developer_guide/index.html) for more information.
## License
MIT
## Contact
henning.janssen@gmx.net
[ci-badge]: https://github.com/janssenhenning/aiida-dataframe/actions/workflows/ci.yml/badge.svg?branch=main
[ci-link]: https://github.com/janssenhenning/aiida-dataframe/actions/workflows/ci.yml
[cov-badge]: https://codecov.io/gh/janssenhenning/aiida-dataframe/branch/main/graph/badge.svg
[cov-link]: https://codecov.io/gh/janssenhenning/aiida-dataframe
[docs-badge]: https://readthedocs.org/projects/aiida-dataframe/badge
[docs-link]: http://aiida-dataframe.readthedocs.io/
[pypi-badge]: https://badge.fury.io/py/aiida-dataframe.svg
[pypi-link]: https://badge.fury.io/py/aiida-dataframe
Raw data
{
"_id": null,
"home_page": null,
"name": "aiida-dataframe",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "aiida, plugin",
"author": null,
"author_email": "Henning Jan\u00dfen <henning.janssen@gmx.net>",
"download_url": "https://files.pythonhosted.org/packages/ee/1b/a01387f75fccf8ddab0ee549930f13ad0e8d6053c3358a99108db89f0225/aiida_dataframe-0.2.0.tar.gz",
"platform": null,
"description": "[![Build Status][ci-badge]][ci-link]\n[![Coverage Status][cov-badge]][cov-link]\n[![Docs status][docs-badge]][docs-link]\n[![PyPI version][pypi-badge]][pypi-link]\n\n# aiida-dataframe\n\nAiiDA data plugin for pandas DataFrame objects\n\n## Features\n\n * Store `pandas.DataFrame` objects in the Database:\n ```python\n import pandas as pd\n PandasFrameData = DataFactory('dataframe.frame')\n df = pd.DataFrame(\n {\n \"A\": 1.0,\n \"B\": pd.Timestamp(\"20130102\"),\n \"C\": pd.Series(1, index=list(range(4)), dtype=\"float32\"),\n \"D\": np.array([3] * 4, dtype=\"int32\"),\n \"E\": pd.Categorical([\"test\", \"train\", \"test\", \"train\"]),\n \"F\": \"foo\",\n }\n )\n df_node = PandasFrameData(df)\n df_node.store()\n ```\n\n * Retrieving the `pandas.DataFrame` from the Database :\n ```python\n from aiida.orm import QueryBuilder\n df_node = QueryBuilder().append(PandasFrameData).first()[0]\n df = df_node.df #The df property reconstructs the pandas DataFrame\n print(df.head())\n ```\n\n## Installation\n\n```shell\npip install aiida-dataframe\nverdi quicksetup # better to set up a new profile\nverdi plugin list aiida.data # should now show your data plugins\n```\n\n## Usage\n\nThe plugin also includes verdi commands to inspect its data types:\n```shell\nverdi data dataframe list\nverdi data dataframe export <PK>\nverdi data dataframe show <PK>\n```\n\n## Development\n\n```shell\ngit clone https://github.com/janssenhenning/aiida-dataframe .\ncd aiida-dataframe\npip install --upgrade pip\npip install -e .[pre-commit,testing] # install extra dependencies\npre-commit install # install pre-commit hooks\npytest -v # discover and run all tests\n```\n\nSee the [developer guide](http://aiida-dataframe.readthedocs.io/en/latest/developer_guide/index.html) for more information.\n\n## License\n\nMIT\n## Contact\n\nhenning.janssen@gmx.net\n\n\n[ci-badge]: https://github.com/janssenhenning/aiida-dataframe/actions/workflows/ci.yml/badge.svg?branch=main\n[ci-link]: https://github.com/janssenhenning/aiida-dataframe/actions/workflows/ci.yml\n[cov-badge]: https://codecov.io/gh/janssenhenning/aiida-dataframe/branch/main/graph/badge.svg\n[cov-link]: https://codecov.io/gh/janssenhenning/aiida-dataframe\n[docs-badge]: https://readthedocs.org/projects/aiida-dataframe/badge\n[docs-link]: http://aiida-dataframe.readthedocs.io/\n[pypi-badge]: https://badge.fury.io/py/aiida-dataframe.svg\n[pypi-link]: https://badge.fury.io/py/aiida-dataframe\n",
"bugtrack_url": null,
"license": null,
"summary": "AiiDA data plugin for pandas DataFrame objects",
"version": "0.2.0",
"project_urls": {
"Documentation": "https://aiida-dataframe.readthedocs.io",
"Home": "https://aiida-dataframe.readthedocs.io",
"Source": "https://github.com/janssenhenning/aiida-dataframe"
},
"split_keywords": [
"aiida",
" plugin"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3631d4ebe6ec396ae1ddd856ad8a4f4b96822111ff974ed968422b919ac7a147",
"md5": "4e2751e293665a76525e0726c99175ef",
"sha256": "c81873f1628189804f33129dfbb4386943440cdf4f49c5b0aa8184bd28f774c3"
},
"downloads": -1,
"filename": "aiida_dataframe-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4e2751e293665a76525e0726c99175ef",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 7778,
"upload_time": "2025-07-17T10:29:49",
"upload_time_iso_8601": "2025-07-17T10:29:49.507734Z",
"url": "https://files.pythonhosted.org/packages/36/31/d4ebe6ec396ae1ddd856ad8a4f4b96822111ff974ed968422b919ac7a147/aiida_dataframe-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ee1ba01387f75fccf8ddab0ee549930f13ad0e8d6053c3358a99108db89f0225",
"md5": "813a1bf7e335df22d32561698aa5e313",
"sha256": "99b88c23f778c5f568e6cda5bb4ea95f971da7f7f39b80809952eaa6a4143fd6"
},
"downloads": -1,
"filename": "aiida_dataframe-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "813a1bf7e335df22d32561698aa5e313",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 93680,
"upload_time": "2025-07-17T10:29:50",
"upload_time_iso_8601": "2025-07-17T10:29:50.439735Z",
"url": "https://files.pythonhosted.org/packages/ee/1b/a01387f75fccf8ddab0ee549930f13ad0e8d6053c3358a99108db89f0225/aiida_dataframe-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-17 10:29:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "janssenhenning",
"github_project": "aiida-dataframe",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "aiida-dataframe"
}
