# ILThermoPy: Python API for the ILThermo 2.0 database
**ILThermoPy** is a Python library to access [ILThermo 2.0](https://ilthermo.boulder.nist.gov/), which is the NIST standard reference database, containing measured physico-chemical properties for a wide spectrum of ionic liquids. Despite the significant amount of stored data, ILThermo 2.0 cannot be used for machine learning, parametrization of empirical physical models, and other data-driven approaches as is. The reason is that ILThermo 2.0 describes molecular structure of IL's components with a chemical name only, whereas SMILES, InChI and other structure identifiers are not available.
**ILThermoPy** solves this problem via the preliminary semi-automatic conversion of compound names to SMILES with subsequent manual validation. This allows one to conduct a substructural search and to immediately generate chemoinformatic descriptors for the extracted data.
## Please note:
- There is no official web API available to access ILThermo 2.0, therefore the stability of this library depends on the stability of the JSON/javascript framework of the webservice.
- ILThermo 2.0 database is regularly updated, at least once a year. Those updates change internal compound IDs, which are used to add SMILES to the extracted data. Therefore, after database's update old versions of **ILThermoPy** can fail to retrieve structural data at least for some of the new entries.
## Installation
**ILThermoPy** can be installed via [PyPI](https://pypi.org/project/ilthermopy/):
```ssh
> pip install ilthermopy
```
## Requirements
1. Python 3.7+;
2. requests;
3. pandas;
4. importlib_resources (for Python 3.7 and 3.8).
## Useful links
1. [ILThermo 2.0](https://ilthermo.boulder.nist.gov/): webapp accessing ILThermo 2.0 database.
2. [PyPI package](https://pypi.org/project/ilthermopy/): PyPI page of the package.
3. [Documentation](https://ilthermopy.readthedocs.io/): cookbook, descriptive API, and other useful information.
Raw data
{
"_id": null,
"home_page": "https://pypi.org/project/ilthermopy/",
"name": "ILThermoPy",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "ionic liquids ilthermo nist api chemistry cheminformatics",
"author": "Ivan Chernyshov",
"author_email": "ivan.chernyshoff@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/95/af/670fa714b2ec2ada915d68491044632948156712a6133048e02869fd06d9/ILThermoPy-1.0.0.tar.gz",
"platform": null,
"description": "# ILThermoPy: Python API for the ILThermo 2.0 database\r\n\r\n**ILThermoPy** is a Python library to access [ILThermo 2.0](https://ilthermo.boulder.nist.gov/), which is the NIST standard reference database, containing measured physico-chemical properties for a wide spectrum of ionic liquids. Despite the significant amount of stored data, ILThermo 2.0 cannot be used for machine learning, parametrization of empirical physical models, and other data-driven approaches as is. The reason is that ILThermo 2.0 describes molecular structure of IL's components with a chemical name only, whereas SMILES, InChI and other structure identifiers are not available.\r\n\r\n**ILThermoPy** solves this problem via the preliminary semi-automatic conversion of compound names to SMILES with subsequent manual validation. This allows one to conduct a substructural search and to immediately generate chemoinformatic descriptors for the extracted data.\r\n\r\n\r\n## Please note:\r\n \r\n- There is no official web API available to access ILThermo 2.0, therefore the stability of this library depends on the stability of the JSON/javascript framework of the webservice.\r\n\r\n- ILThermo 2.0 database is regularly updated, at least once a year. Those updates change internal compound IDs, which are used to add SMILES to the extracted data. Therefore, after database's update old versions of **ILThermoPy** can fail to retrieve structural data at least for some of the new entries.\r\n\r\n\r\n## Installation\r\n\r\n**ILThermoPy** can be installed via [PyPI](https://pypi.org/project/ilthermopy/):\r\n\r\n```ssh\r\n> pip install ilthermopy\r\n```\r\n\r\n\r\n## Requirements\r\n\r\n1. Python 3.7+;\r\n\r\n2. requests;\r\n\r\n3. pandas;\r\n\r\n4. importlib_resources (for Python 3.7 and 3.8).\r\n\r\n\r\n## Useful links\r\n\r\n1. [ILThermo 2.0](https://ilthermo.boulder.nist.gov/): webapp accessing ILThermo 2.0 database.\r\n\r\n2. [PyPI package](https://pypi.org/project/ilthermopy/): PyPI page of the package.\r\n\r\n3. [Documentation](https://ilthermopy.readthedocs.io/): cookbook, descriptive API, and other useful information.\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "",
"summary": "A simple Python wrapper around the ILThermo 2.0 database",
"version": "1.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/IvanChernyshov/ILThermoPy/issues",
"GitHub": "https://github.com/IvanChernyshov/ILThermoPy",
"Homepage": "https://pypi.org/project/ilthermopy/"
},
"split_keywords": [
"ionic",
"liquids",
"ilthermo",
"nist",
"api",
"chemistry",
"cheminformatics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fc5084d4531f885692f5dc9f48583b31f53bd27c0be206e27f4f79089a1d11df",
"md5": "4f9b03afafe149d8e0bc8e149692b1a6",
"sha256": "35b77fe36cf62d40b9c62489a4bf4e16f42ff5f1b5db67ea9947d4d4684e3558"
},
"downloads": -1,
"filename": "ILThermoPy-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4f9b03afafe149d8e0bc8e149692b1a6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 100916,
"upload_time": "2023-06-28T20:53:31",
"upload_time_iso_8601": "2023-06-28T20:53:31.182283Z",
"url": "https://files.pythonhosted.org/packages/fc/50/84d4531f885692f5dc9f48583b31f53bd27c0be206e27f4f79089a1d11df/ILThermoPy-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "95af670fa714b2ec2ada915d68491044632948156712a6133048e02869fd06d9",
"md5": "72a5a928a0ef6c715dcffbc4a1f54c6f",
"sha256": "0e26bceb8aff8c20b30e0456e1cc8a18d1ca8bdb47181b04f6ccdae65d544c76"
},
"downloads": -1,
"filename": "ILThermoPy-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "72a5a928a0ef6c715dcffbc4a1f54c6f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 98702,
"upload_time": "2023-06-28T20:53:33",
"upload_time_iso_8601": "2023-06-28T20:53:33.009990Z",
"url": "https://files.pythonhosted.org/packages/95/af/670fa714b2ec2ada915d68491044632948156712a6133048e02869fd06d9/ILThermoPy-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-28 20:53:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "IvanChernyshov",
"github_project": "ILThermoPy",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "ilthermopy"
}