# Logix Trend Converter
If you use Rockwell/Allen-Bradley's RSTrendX tool (the trending tool bundled with RSLogix 5, RSLogix 500, and RSLogix 5000/Studio 5000) and want to export the data you've trended, you'll find the "Create Snapshot" option gives you two files: a `*.DBF` file and a `*.IDX` file. These files contain your data and tag (trend pen) names, but they're a binary-encoded file using a defunct database format (["dBASE"](https://en.wikipedia.org/wiki/DBase)).
This package allows you to quickly convert those files into a more accessible format (CSV).
It's important to give credit where it's due: much of the heavy lifting of this project is performed by two other packages:
- `simpledbf` [(PyPI.org)](https://pypi.org/project/simpledbf/) - the relevant code from the `simpledbf` package is bundled within this package, so it is not necessary to install the `simpledbf` package to your environment.
- `pandas` [(PyData.org)](https://pandas.pydata.org/) - the indispensable.
## Installation
Logix Trend Converter can be installed with `pip` using the following command:
```bash
pip install logix-trend-converter
```
## Suggested Usage
```python
from logix_trend_converter import converter as ltc
from pathlib import Path
dbf_file = Path("data/my_data.dbf")
idx_file = Path("data/my_data.idx")
df = ltc.convert_file_to_pd_dataframe(dbf_file, idx_file)
df.head()
```
## Contributing
Pull requests are welcome. For major changes, please open an issue first
to discuss what you would like to change.
Please make sure to update tests as appropriate.
## License
[MIT](https://choosealicense.com/licenses/mit/)
Raw data
{
"_id": null,
"home_page": "https://github.com/jminnion/logix-trend-converter",
"name": "logix-trend-converter",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "rstrendx,rslogix,plc5,slc500,dbf,rockwell,allen-bradley",
"author": "Justin Minnion",
"author_email": "justin@minnion.io",
"download_url": "https://files.pythonhosted.org/packages/76/94/e2dc823deada4b64a89a5ac839767255598d819d7c62e3d7a2c22f24153e/logix_trend_converter-0.1.0.tar.gz",
"platform": null,
"description": "# Logix Trend Converter\n\nIf you use Rockwell/Allen-Bradley's RSTrendX tool (the trending tool bundled with RSLogix 5, RSLogix 500, and RSLogix 5000/Studio 5000) and want to export the data you've trended, you'll find the \"Create Snapshot\" option gives you two files: a `*.DBF` file and a `*.IDX` file. These files contain your data and tag (trend pen) names, but they're a binary-encoded file using a defunct database format ([\"dBASE\"](https://en.wikipedia.org/wiki/DBase)).\n\nThis package allows you to quickly convert those files into a more accessible format (CSV).\n\nIt's important to give credit where it's due: much of the heavy lifting of this project is performed by two other packages:\n\n- `simpledbf` [(PyPI.org)](https://pypi.org/project/simpledbf/) - the relevant code from the `simpledbf` package is bundled within this package, so it is not necessary to install the `simpledbf` package to your environment.\n- `pandas` [(PyData.org)](https://pandas.pydata.org/) - the indispensable.\n\n## Installation\n\nLogix Trend Converter can be installed with `pip` using the following command:\n\n```bash\npip install logix-trend-converter\n```\n\n## Suggested Usage\n\n```python\nfrom logix_trend_converter import converter as ltc\nfrom pathlib import Path\n\ndbf_file = Path(\"data/my_data.dbf\")\nidx_file = Path(\"data/my_data.idx\")\n\ndf = ltc.convert_file_to_pd_dataframe(dbf_file, idx_file)\ndf.head()\n\n```\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first\nto discuss what you would like to change.\n\nPlease make sure to update tests as appropriate.\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A tool for converting RSLogix 5/500/5000 data trend files (with *.DBF file format) to more friendly formats.",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/jminnion/logix-trend-converter",
"Repository": "https://github.com/jminnion/logix-trend-converter"
},
"split_keywords": [
"rstrendx",
"rslogix",
"plc5",
"slc500",
"dbf",
"rockwell",
"allen-bradley"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "23662705136ed32e600b46126154e454735584cadec674d04bbd0398bcd1620e",
"md5": "880de0cc016a82ca372a05bbc3f38d82",
"sha256": "8a2c9e1274bfce877f3684d330c639f62b4f1b510f8bdf4ba23bbd64cfd6d5ed"
},
"downloads": -1,
"filename": "logix_trend_converter-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "880de0cc016a82ca372a05bbc3f38d82",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 15957,
"upload_time": "2023-10-14T05:03:42",
"upload_time_iso_8601": "2023-10-14T05:03:42.589992Z",
"url": "https://files.pythonhosted.org/packages/23/66/2705136ed32e600b46126154e454735584cadec674d04bbd0398bcd1620e/logix_trend_converter-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7694e2dc823deada4b64a89a5ac839767255598d819d7c62e3d7a2c22f24153e",
"md5": "5e2ceee6fd58aef04837a2e12ee52e9b",
"sha256": "0271f88673f5ffa11361a10e555f283b3869a4c23684e6d1d7e19e7d6a4a7da4"
},
"downloads": -1,
"filename": "logix_trend_converter-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "5e2ceee6fd58aef04837a2e12ee52e9b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 14713,
"upload_time": "2023-10-14T05:03:44",
"upload_time_iso_8601": "2023-10-14T05:03:44.363540Z",
"url": "https://files.pythonhosted.org/packages/76/94/e2dc823deada4b64a89a5ac839767255598d819d7c62e3d7a2c22f24153e/logix_trend_converter-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-14 05:03:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jminnion",
"github_project": "logix-trend-converter",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "logix-trend-converter"
}
JSON
