# Database KnotInfo
This repository contains a snapshot of the complete content
of the [KnotInfo](https://knotinfo.math.indiana.edu/) and
[LinkInfo](https://linkinfo.sitehost.iu.edu/) databases.
Each database is provided as a Python list of Python dictionaries.
The data are from the corresponding Excel spreadsheets available
on the KnotInfo and LinkInfo homepages on the date of release.
Please note that the databases contain columns that are not visible on
the web pages (see also the [Release Notes 2023.4.8](https://github.com/soehms/database_knotinfo/releases/tag/2022.4.8)).
The validity of the information in such columns cannot be guaranteed.
Also, there are plans to remove them in the future.
This repository was created as a part of the
[SageMath](https://www.sagemath.org/) interface to these databases
(see the [corresponding section](https://doc.sagemath.org/html/en/reference/knots/sage/knots/knotinfo.html)
of the SageMath reference manual or [this tutorial](tutorials/sage_knotinfo_interface_tutorial.ipynb))
but can also be used independently.
In Python, it can be used as follows:
```python
>>> from database_knotinfo import link_list
>>> k = link_list()
>>> len(k)
2979
>>> names_k = k[0]
>>> type(names_k)
<type 'dict'>
>>> names_k['braid_index']
'Braid Index'
>>> k2 = k[2]
>>> k2['name']
'3_1'
>>> k2['braid_index']
'2'
>>> k2['homfly_polynomial']
'(2*v^2-v^4)+(v^2)*z^2'
>>> l = link_list(proper_links=True)
>>> len(l)
4189
>>> names_l = l[0]
>>> type(names_l)
<type 'dict'>
>>> names_l['braid_notation']
'Braid Notation'
>>> l2 = l[2]
>>> l2['name']
'L2a1{1}'
>>> l2['homflypt_polynomial']
'v/z-v^3/z + v*z'
```
To build a new release, the `CSV` files can be upgraded with the
`create_knotinfo_csv.py` script. A [cronjob](https://github.com/soehms/database_knotinfo/blob/main/.github/workflows/check_version_changed.yml)
executes it on the first day of every month and creates a new
release if differences are detected.
## Installation
### Python
```bash
pip install database_knotinfo
```
or
```bash
pip install database_knotinfo==2021.9.1
```
if you want to install a former version.
### SageMath
Since Release 9.4, the database can be installed in Sage by:
```bash
sage -i database_knotinfo
```
This will contain integration with the knot and link functionality of Sage.
Sage 9.4 ships the PyPI release [0.7](https://pypi.org/project/database-knotinfo/0.7/)
of the database. To use a more recent one you have to execute
```bash
sage -package update database_knotinfo <version>
```
before the installation command above, for example:
```bash
sage -package update database_knotinfo 2021.9.1
```
This procedure can be used to upgrade to the next version, as well. But note
that there is a bug in 9.4 concerning such upgrades which will be fixed in
SageMath 9.5 (see Trac ticket [#32099](https://trac.sagemath.org/ticket/32099)).
A workaround for 9.4 can be perfomed in a Sage session as follows:
```
sage: from sage.databases.knotinfo_db import KnotInfoDataBase
sage: KnotInfoDataBase().reset_filecache()
```
If you upgrade to a version of the database which is ahead of the version the
SageMath release is build on, you should keep in mind, that the examples shown
in the Sage reference manual may be outdated.
In case the installation via `sage -i` is failing on your system you can try:
```bash
sage -pip install database_knotinfo
```
or
```bash
sage -pip install database_knotinfo==0.7
```
for the version compatible the the current Sage release.
[](https://gitpod.io/#https://github.com/soehms/database_knotinfo)
## Versioning
Version numbers are automatically generated every month if differences to the
original databases are detected. They follow the scheme
\<year\>.\<month\>.\<day\>
## Help
If you note a divergence between this repository and the original data in case
the current release is older than a month please create an issue about that.
## Credits
Many thanks to Chuck Livingston and Allison Moore for making the data
available. For further acknowledgments see the corresponding homepages.
Raw data
{
"_id": null,
"home_page": "https://github.com/soehms/database_knotinfo",
"name": "database-knotinfo",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "KnotInfo, LinkInfo, SageMath, database, knot, link, mathematics, topology, invariants",
"author": "Sebastian Oehms",
"author_email": "seb.oehms@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/8d/d5/cf595be9263a13cd3ced7663d5a707703c1cd9f136d1215e5d0ee2fb4642/database_knotinfo-2024.4.1.tar.gz",
"platform": null,
"description": "# Database KnotInfo\n\nThis repository contains a snapshot of the complete content\nof the [KnotInfo](https://knotinfo.math.indiana.edu/) and\n[LinkInfo](https://linkinfo.sitehost.iu.edu/) databases.\nEach database is provided as a Python list of Python dictionaries.\nThe data are from the corresponding Excel spreadsheets available\non the KnotInfo and LinkInfo homepages on the date of release.\n\nPlease note that the databases contain columns that are not visible on\nthe web pages (see also the [Release Notes 2023.4.8](https://github.com/soehms/database_knotinfo/releases/tag/2022.4.8)).\nThe validity of the information in such columns cannot be guaranteed.\nAlso, there are plans to remove them in the future.\n\nThis repository was created as a part of the\n[SageMath](https://www.sagemath.org/) interface to these databases\n(see the [corresponding section](https://doc.sagemath.org/html/en/reference/knots/sage/knots/knotinfo.html)\nof the SageMath reference manual or [this tutorial](tutorials/sage_knotinfo_interface_tutorial.ipynb))\nbut can also be used independently.\n\nIn Python, it can be used as follows:\n\n```python\n>>> from database_knotinfo import link_list\n>>> k = link_list()\n>>> len(k)\n2979\n>>> names_k = k[0]\n>>> type(names_k)\n<type 'dict'>\n>>> names_k['braid_index']\n'Braid Index'\n>>> k2 = k[2]\n>>> k2['name']\n'3_1'\n>>> k2['braid_index']\n'2'\n>>> k2['homfly_polynomial']\n'(2*v^2-v^4)+(v^2)*z^2'\n\n>>> l = link_list(proper_links=True)\n>>> len(l)\n4189\n>>> names_l = l[0]\n>>> type(names_l)\n<type 'dict'>\n>>> names_l['braid_notation']\n'Braid Notation'\n>>> l2 = l[2]\n>>> l2['name']\n'L2a1{1}'\n>>> l2['homflypt_polynomial']\n'v/z-v^3/z + v*z'\n```\n\nTo build a new release, the `CSV` files can be upgraded with the\n`create_knotinfo_csv.py` script. A [cronjob](https://github.com/soehms/database_knotinfo/blob/main/.github/workflows/check_version_changed.yml)\nexecutes it on the first day of every month and creates a new\nrelease if differences are detected.\n\n## Installation\n\n### Python\n\n```bash\npip install database_knotinfo\n```\n\nor\n\n```bash\npip install database_knotinfo==2021.9.1\n```\n\nif you want to install a former version.\n\n\n### SageMath\n\nSince Release 9.4, the database can be installed in Sage by:\n\n```bash\nsage -i database_knotinfo\n```\n\nThis will contain integration with the knot and link functionality of Sage.\nSage 9.4 ships the PyPI release [0.7](https://pypi.org/project/database-knotinfo/0.7/)\nof the database. To use a more recent one you have to execute\n\n```bash\nsage -package update database_knotinfo <version>\n```\n\nbefore the installation command above, for example:\n\n```bash\nsage -package update database_knotinfo 2021.9.1\n```\n\nThis procedure can be used to upgrade to the next version, as well. But note\nthat there is a bug in 9.4 concerning such upgrades which will be fixed in\nSageMath 9.5 (see Trac ticket [#32099](https://trac.sagemath.org/ticket/32099)).\nA workaround for 9.4 can be perfomed in a Sage session as follows:\n\n```\nsage: from sage.databases.knotinfo_db import KnotInfoDataBase\nsage: KnotInfoDataBase().reset_filecache()\n```\n\nIf you upgrade to a version of the database which is ahead of the version the\nSageMath release is build on, you should keep in mind, that the examples shown\nin the Sage reference manual may be outdated.\n\nIn case the installation via `sage -i` is failing on your system you can try:\n\n```bash\nsage -pip install database_knotinfo\n```\n\nor\n\n```bash\nsage -pip install database_knotinfo==0.7\n```\n\nfor the version compatible the the current Sage release.\n\n[](https://gitpod.io/#https://github.com/soehms/database_knotinfo)\n\n\n\n## Versioning\n\nVersion numbers are automatically generated every month if differences to the\noriginal databases are detected. They follow the scheme\n\n\\<year\\>.\\<month\\>.\\<day\\>\n\n## Help\n\nIf you note a divergence between this repository and the original data in case\nthe current release is older than a month please create an issue about that.\n\n## Credits\n\nMany thanks to Chuck Livingston and Allison Moore for making the data\navailable. For further acknowledgments see the corresponding homepages.\n",
"bugtrack_url": null,
"license": "GPL",
"summary": "The KnotInfo and LinkInfo databases as lists of dictionaries",
"version": "2024.4.1",
"project_urls": {
"Homepage": "https://github.com/soehms/database_knotinfo"
},
"split_keywords": [
"knotinfo",
" linkinfo",
" sagemath",
" database",
" knot",
" link",
" mathematics",
" topology",
" invariants"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c865c3e4c4c7722fb2fe6cf22a03c522b0829421513d4bc2e25d9309238fab69",
"md5": "a4229eaed84375c69ff195940a729590",
"sha256": "877b9170510e9b963ab5e436efa75beddc4bbcdaee7af9c64116739f81901666"
},
"downloads": -1,
"filename": "database_knotinfo-2024.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a4229eaed84375c69ff195940a729590",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 15294326,
"upload_time": "2024-04-01T22:18:02",
"upload_time_iso_8601": "2024-04-01T22:18:02.895851Z",
"url": "https://files.pythonhosted.org/packages/c8/65/c3e4c4c7722fb2fe6cf22a03c522b0829421513d4bc2e25d9309238fab69/database_knotinfo-2024.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8dd5cf595be9263a13cd3ced7663d5a707703c1cd9f136d1215e5d0ee2fb4642",
"md5": "a71a191cf28a4957d949000cec5aa013",
"sha256": "4f9eb35db3a34b38814bbd07a594ebc6c2f3339026d57a800455a50435e7528e"
},
"downloads": -1,
"filename": "database_knotinfo-2024.4.1.tar.gz",
"has_sig": false,
"md5_digest": "a71a191cf28a4957d949000cec5aa013",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14763102,
"upload_time": "2024-04-01T22:18:06",
"upload_time_iso_8601": "2024-04-01T22:18:06.833577Z",
"url": "https://files.pythonhosted.org/packages/8d/d5/cf595be9263a13cd3ced7663d5a707703c1cd9f136d1215e5d0ee2fb4642/database_knotinfo-2024.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-01 22:18:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "soehms",
"github_project": "database_knotinfo",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "database-knotinfo"
}
JSON
