Tkwant is a python package to simulate time-dependent quantum dynamics of
mesoscopic systems. It is the time-dependent generalization of the
`Kwant <https://kwant-project.org>`_ package and distributed under `2-clause BSD license <https://tkwant.kwant-project.org/doc/stable/pre/license.html>`_.
Tkwant is developed by the following `authors <https://tkwant.kwant-project.org/doc/stable/pre/authors.html>`_.
- Website: https://tkwant.kwant-project.org
Installation
------------
Installation from source
~~~~~~~~~~~~~~~~~~~~~~~~
Tkwant can currently only installed from its source.
Please visit the `installation instructions <https://tkwant.kwant-project.org/doc/stable/pre/installation.html>`_.
Development
-----------
Source code
~~~~~~~~~~~
The official tkwant repository is:
- Source code repository: https://gitlab.kwant-project.org/kwant/tkwant.git
The *master* branch holds the current development version.
Test suite
~~~~~~~~~~
Unittests can be run directly in the local tkwant source repository from the command line::
pytest
Integration tests, that require more time to run, are started with the command::
pytest --integtest
Tests involving MPI can be run by the command::
pytest --mpitest
The test suite needs the Python packages ``pytest`` to be installed and tkwant compiled.
Please visit the `installation instructions <https://tkwant.kwant-project.org/doc/stable/pre/installation.html>`_.
Additional pep8 compliance checks can be activated with::
pytest --flake8
when the optional `pytest-flake8 <https://pypi.org/project/pytest-flake8/>`_
package is installed.
Building the documentation
~~~~~~~~~~~~~~~~~~~~~~~~~~
The documentation can be build directly in the ``doc`` folder of the
local tkwant source repository from the command line::
make html
The generated html documentation can be browsed
by opening the file ``doc/build/html/index.html`` with a web browser.
To build the documentation, additional Python packages need to be installed.
Please visit the `installation instructions <https://tkwant.kwant-project.org/doc/stable/pre/installation.html>`_.
Contribution
~~~~~~~~~~~~
Contributions and feedback to tkwant are always welcome.
We also appreciate if you have suggestions for the documentation or find new bugs.
If you like to contribute new features,
feel free do discuss your ideas on the mailing list before opening a merge request.
Moreover, please make sure that the tkwant test suite runs without errors before opening
a new merge request.
See the `Contribution <https://kwant-project.org/contribute>`_
section of kwant for coding style and general advice.
Authors
~~~~~~~
Tkwant is developed by the following
`authors <https://tkwant.kwant-project.org/doc/stable/pre/authors.html>`_.
License
~~~~~~~
Tkwant is distributed under
`2-clause BSD license <https://tkwant.kwant-project.org/doc/stable/pre/license.html>`_.
The license can be also found in file ``LICENSE.rst`` in the project repository.
Help and Support
----------------
Documentation
~~~~~~~~~~~~~
The official user and developer documentation is found under:
- stable: https://tkwant.kwant-project.org/doc/stable
- development (master branch): https://tkwant.kwant-project.org/doc/dev
Communication
~~~~~~~~~~~~~
The kwant-discuss mailing list is the main communication channel for
questions and discussions around tkwant. Searching and using the mailing list
is explained in section
`mailing list <https://kwant-project.org/community#mailing-list>`_.
- Mailing list: kwant-discuss@kwant-project.org
Reporting bugs
~~~~~~~~~~~~~~
If you encounter a problem that seems to be a bug of tkwant, you can open a ticket
with the issue tracker.
- Issue tracker: https://gitlab.kwant-project.org/kwant/tkwant/issues
Please make sure that the problem has not yet been reported in the
`List of known tkwant bugs <https://gitlab.kwant-project.org/kwant/tkwant/issues?label_name=bug>`_.
You may also `search the mailing list <https://kwant-project.org/community#mailing-list>`_
prior to open a new ticket.
See the the `Reporting bugs <https://kwant-project.org/community#reporting-bugs>`_
section of kwant for general advice.
Citation
~~~~~~~~
If you have used tkwant for work that has lead to a scientific publication,
we would appreciate if you cite the publication which introduces tkwant:
T. Kloss, J. Weston, B. Gaury, B. Rossignol, C. Groth and X. Waintal,
`Tkwant: a software package for time-dependent quantum transport <https://doi.org/10.1088/1367-2630/abddf7>`_
New J. Phys. **23**, 023025 (2021),
`arXiv:2009.03132 [cond-mat.mes-hall]. <https://arxiv.org/abs/2009.03132>`_
Raw data
{
"_id": null,
"home_page": "https://tkwant.kwant-project.org/",
"name": "tkwant",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "tkwant authors",
"author_email": "tkwant-authors@kwant-project.org",
"download_url": "https://files.pythonhosted.org/packages/42/95/67af40c084e4bc4fbf240b68d3b0faf0b3388e8a476437373635bf0eb821/tkwant-1.1.0.tar.gz",
"platform": "Unix",
"description": "Tkwant is a python package to simulate time-dependent quantum dynamics of\nmesoscopic systems. It is the time-dependent generalization of the\n`Kwant <https://kwant-project.org>`_ package and distributed under `2-clause BSD license <https://tkwant.kwant-project.org/doc/stable/pre/license.html>`_.\nTkwant is developed by the following `authors <https://tkwant.kwant-project.org/doc/stable/pre/authors.html>`_.\n\n- Website: https://tkwant.kwant-project.org\n\n\nInstallation\n------------\n\nInstallation from source\n~~~~~~~~~~~~~~~~~~~~~~~~\n\nTkwant can currently only installed from its source.\nPlease visit the `installation instructions <https://tkwant.kwant-project.org/doc/stable/pre/installation.html>`_.\n\n\nDevelopment\n-----------\n\nSource code\n~~~~~~~~~~~\n\nThe official tkwant repository is:\n\n- Source code repository: https://gitlab.kwant-project.org/kwant/tkwant.git\n\nThe *master* branch holds the current development version.\n\nTest suite\n~~~~~~~~~~\n\nUnittests can be run directly in the local tkwant source repository from the command line::\n\n pytest\n\nIntegration tests, that require more time to run, are started with the command::\n\n pytest --integtest\n\nTests involving MPI can be run by the command::\n\n pytest --mpitest\n\nThe test suite needs the Python packages ``pytest`` to be installed and tkwant compiled.\nPlease visit the `installation instructions <https://tkwant.kwant-project.org/doc/stable/pre/installation.html>`_.\nAdditional pep8 compliance checks can be activated with::\n\n pytest --flake8\n\nwhen the optional `pytest-flake8 <https://pypi.org/project/pytest-flake8/>`_\npackage is installed.\n\n\nBuilding the documentation\n~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nThe documentation can be build directly in the ``doc`` folder of the\nlocal tkwant source repository from the command line::\n\n make html\n\n\nThe generated html documentation can be browsed\nby opening the file ``doc/build/html/index.html`` with a web browser.\nTo build the documentation, additional Python packages need to be installed.\nPlease visit the `installation instructions <https://tkwant.kwant-project.org/doc/stable/pre/installation.html>`_.\n\nContribution\n~~~~~~~~~~~~\nContributions and feedback to tkwant are always welcome.\nWe also appreciate if you have suggestions for the documentation or find new bugs.\nIf you like to contribute new features,\nfeel free do discuss your ideas on the mailing list before opening a merge request.\nMoreover, please make sure that the tkwant test suite runs without errors before opening\na new merge request.\nSee the `Contribution <https://kwant-project.org/contribute>`_\nsection of kwant for coding style and general advice.\n\nAuthors\n~~~~~~~\n\nTkwant is developed by the following\n`authors <https://tkwant.kwant-project.org/doc/stable/pre/authors.html>`_.\n\nLicense\n~~~~~~~\nTkwant is distributed under\n`2-clause BSD license <https://tkwant.kwant-project.org/doc/stable/pre/license.html>`_.\nThe license can be also found in file ``LICENSE.rst`` in the project repository.\n\nHelp and Support\n----------------\n\nDocumentation\n~~~~~~~~~~~~~\n\nThe official user and developer documentation is found under:\n\n- stable: https://tkwant.kwant-project.org/doc/stable\n- development (master branch): https://tkwant.kwant-project.org/doc/dev\n\nCommunication\n~~~~~~~~~~~~~\n\nThe kwant-discuss mailing list is the main communication channel for\nquestions and discussions around tkwant. Searching and using the mailing list\nis explained in section\n`mailing list <https://kwant-project.org/community#mailing-list>`_.\n\n- Mailing list: kwant-discuss@kwant-project.org\n\n\nReporting bugs\n~~~~~~~~~~~~~~\n\nIf you encounter a problem that seems to be a bug of tkwant, you can open a ticket\nwith the issue tracker.\n\n- Issue tracker: https://gitlab.kwant-project.org/kwant/tkwant/issues\n\nPlease make sure that the problem has not yet been reported in the\n`List of known tkwant bugs <https://gitlab.kwant-project.org/kwant/tkwant/issues?label_name=bug>`_.\nYou may also `search the mailing list <https://kwant-project.org/community#mailing-list>`_\nprior to open a new ticket.\nSee the the `Reporting bugs <https://kwant-project.org/community#reporting-bugs>`_\nsection of kwant for general advice.\n\nCitation\n~~~~~~~~\n\nIf you have used tkwant for work that has lead to a scientific publication,\nwe would appreciate if you cite the publication which introduces tkwant:\n\nT. Kloss, J. Weston, B. Gaury, B. Rossignol, C. Groth and X. Waintal,\n`Tkwant: a software package for time-dependent quantum transport <https://doi.org/10.1088/1367-2630/abddf7>`_\nNew J. Phys. **23**, 023025 (2021),\n`arXiv:2009.03132 [cond-mat.mes-hall]. <https://arxiv.org/abs/2009.03132>`_",
"bugtrack_url": null,
"license": "BSD",
"summary": "Package for time-dependent quantum transport simulations",
"version": "1.1.0",
"project_urls": {
"Homepage": "https://tkwant.kwant-project.org/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "429567af40c084e4bc4fbf240b68d3b0faf0b3388e8a476437373635bf0eb821",
"md5": "406327caecb9d26d7bed6a80adb3e205",
"sha256": "56d02cb9d21edbe4a5d8cd76741dee546ef05566681ecd5346f6da35460922f4"
},
"downloads": -1,
"filename": "tkwant-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "406327caecb9d26d7bed6a80adb3e205",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 2213191,
"upload_time": "2023-06-07T11:25:31",
"upload_time_iso_8601": "2023-06-07T11:25:31.235348Z",
"url": "https://files.pythonhosted.org/packages/42/95/67af40c084e4bc4fbf240b68d3b0faf0b3388e8a476437373635bf0eb821/tkwant-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-07 11:25:31",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tkwant"
}
JSON