# GoodData Pandas
This package contains a thin layer that utilizes gooddata-sdk and allows you to conveniently create pandas series and
data frames from the computations done against semantic model in your [GoodData.CN](https://www.gooddata.com/developers/cloud-native/) workspace.
See [DOCUMENTATION](https://gooddata-pandas.readthedocs.io/en/latest/) for more details.
## Requirements
- GoodData.CN installation; either running on your cloud
infrastructure or the free Community Edition running on your workstation
- Python 3.9 or newer
## Installation
Run the following command to install the `gooddata-pandas` package on your system:
pip install gooddata-pandas
## Example
Create an indexed and a not-indexed series:
```python
from gooddata_pandas import GoodPandas
# GoodData.CN host in the form of uri eg. "http://localhost:3000"
host = "http://localhost:3000"
# GoodData.CN user token
token = "some_user_token"
# initialize the adapter to work on top of GD.CN host and use the provided authentication token
gp = GoodPandas(host, token)
workspace_id = "demo"
series = gp.series(workspace_id)
# create indexed series
indexed_series = series.indexed(index_by="label/label_id", data_by="fact/measure_id")
# create non-indexed series containing just the values of measure sliced by elements of the label
non_indexed = series.not_indexed(data_by="fact/measure_id", granularity="label/label_id")
```
## Bugs & Requests
Please use the [GitHub issue tracker](https://github.com/gooddata/gooddata-python-sdk/issues) to submit bugs
or request features.
## Changelog
Consult [Github releases](https://github.com/gooddata/gooddata-python-sdk/releases) for a released versions
and list of changes.
Raw data
{
"_id": null,
"home_page": null,
"name": "gooddata-pandas",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9.0",
"maintainer_email": null,
"keywords": "gooddata, pandas, series, data, frame, data_frame, analytics, headless, business, intelligence, headless-bi, cloud, native, semantic, layer, sql, metrics",
"author": "GoodData",
"author_email": "support@gooddata.com",
"download_url": "https://files.pythonhosted.org/packages/dd/c4/2943f52c51695be8b1139edf1d6de32c71d4f74827e36207c7e2e4d2c941/gooddata_pandas-1.46.0.tar.gz",
"platform": null,
"description": "# GoodData Pandas\n\nThis package contains a thin layer that utilizes gooddata-sdk and allows you to conveniently create pandas series and\ndata frames from the computations done against semantic model in your [GoodData.CN](https://www.gooddata.com/developers/cloud-native/) workspace.\n\nSee [DOCUMENTATION](https://gooddata-pandas.readthedocs.io/en/latest/) for more details.\n\n## Requirements\n\n- GoodData.CN installation; either running on your cloud\n infrastructure or the free Community Edition running on your workstation\n\n- Python 3.9 or newer\n\n## Installation\n\nRun the following command to install the `gooddata-pandas` package on your system:\n\n pip install gooddata-pandas\n\n## Example\n\nCreate an indexed and a not-indexed series:\n\n```python\nfrom gooddata_pandas import GoodPandas\n\n# GoodData.CN host in the form of uri eg. \"http://localhost:3000\"\nhost = \"http://localhost:3000\"\n# GoodData.CN user token\ntoken = \"some_user_token\"\n# initialize the adapter to work on top of GD.CN host and use the provided authentication token\ngp = GoodPandas(host, token)\n\nworkspace_id = \"demo\"\nseries = gp.series(workspace_id)\n\n# create indexed series\nindexed_series = series.indexed(index_by=\"label/label_id\", data_by=\"fact/measure_id\")\n\n# create non-indexed series containing just the values of measure sliced by elements of the label\nnon_indexed = series.not_indexed(data_by=\"fact/measure_id\", granularity=\"label/label_id\")\n```\n\n## Bugs & Requests\n\nPlease use the [GitHub issue tracker](https://github.com/gooddata/gooddata-python-sdk/issues) to submit bugs\nor request features.\n\n## Changelog\n\nConsult [Github releases](https://github.com/gooddata/gooddata-python-sdk/releases) for a released versions\nand list of changes.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "GoodData Cloud to pandas",
"version": "1.46.0",
"project_urls": {
"Documentation": "https://gooddata-pandas.readthedocs.io/en/v1.46.0",
"Source": "https://github.com/gooddata/gooddata-python-sdk"
},
"split_keywords": [
"gooddata",
" pandas",
" series",
" data",
" frame",
" data_frame",
" analytics",
" headless",
" business",
" intelligence",
" headless-bi",
" cloud",
" native",
" semantic",
" layer",
" sql",
" metrics"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "fbc7790401d99ad98a58f7a77fe7475aae796f08117a2a03d4883f6c26c83901",
"md5": "1ec9ee4b68b2f1e8a2797f0423d69740",
"sha256": "b899b3ece6a8b9ed46c1a9a0a449c9113dd320eaf6a69ed1f7fe7091ebb9057f"
},
"downloads": -1,
"filename": "gooddata_pandas-1.46.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1ec9ee4b68b2f1e8a2797f0423d69740",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9.0",
"size": 49856,
"upload_time": "2025-07-11T07:48:58",
"upload_time_iso_8601": "2025-07-11T07:48:58.624966Z",
"url": "https://files.pythonhosted.org/packages/fb/c7/790401d99ad98a58f7a77fe7475aae796f08117a2a03d4883f6c26c83901/gooddata_pandas-1.46.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ddc42943f52c51695be8b1139edf1d6de32c71d4f74827e36207c7e2e4d2c941",
"md5": "945baa931513d04835bf4a96980c0663",
"sha256": "f2c9ae5465e35979b0b7f9fe6296040290db587f844a627b32fe8e55b33fb2ed"
},
"downloads": -1,
"filename": "gooddata_pandas-1.46.0.tar.gz",
"has_sig": false,
"md5_digest": "945baa931513d04835bf4a96980c0663",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9.0",
"size": 47423,
"upload_time": "2025-07-11T07:49:10",
"upload_time_iso_8601": "2025-07-11T07:49:10.251250Z",
"url": "https://files.pythonhosted.org/packages/dd/c4/2943f52c51695be8b1139edf1d6de32c71d4f74827e36207c7e2e4d2c941/gooddata_pandas-1.46.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-11 07:49:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gooddata",
"github_project": "gooddata-python-sdk",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "gooddata-pandas"
}