Skip to content

A Python library which allows construction and manipulation of complex molecules, as well as automatic molecular design and the creation of molecular databases.

License

Notifications You must be signed in to change notification settings

lukasturcani/stk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

maintainers:lukasturcani, andrewtarzia
documentation:https://stk.readthedocs.io
discord:https://discord.gg/zbCUzuxe2B
docs/source/_static/stk.png
https://github.com/lukasturcani/stk/actions/workflows/tests.yml/badge.svg?branch=master https://readthedocs.org/projects/stk/badge/?version=latest

Overview

stk is a Python library which allows construction and manipulation of complex molecules, as well as automatic molecular design, and the creation of molecular, and molecular property, databases. The documentation of stk is available on https://stk.readthedocs.io and the project's Discord server can be joined through https://discord.gg/zbCUzuxe2B.

Installation

To get stk, you can install it with pip:

pip install stk

If you would like to get updated when a new release of stk comes out, which happens pretty regularly, click on the watch button on the top right corner of the GitHub page. Then select Releases only from the dropdown menu.

You can see the latest releases here:

https://github.com/lukasturcani/stk/releases

There will be a corresponding release on pip for each release on GitHub, and you can update your stk with:

pip install stk --upgrade

Developer Setup

  1. Install just.
  2. In a new virtual environment run:
just dev
  1. Setup the MongoDB container (make sure docker is installed):
just mongo
  1. Run code checks:
just check

How To Cite

If you use stk please cite

https://github.com/lukasturcani/stk

and

https://aip.scitation.org/doi/10.1063/5.0049708

Publications

about stk

using stk

Acknowledgements

I began developing this code when I was working in the Jelfs group, http://www.jelfs-group.org/, whose members often provide me with very valuable feedback, which I gratefully acknowledge.