Fast, secure, scalable quantum chemistry. A Python client for the the ChemCloud server.
Project description
chemcloud - A Python Client for ChemCloud
chemcloud
is a python client for the ChemCloud Server. The client provides a simple yet powerful interface to perform computational chemistry calculations using nothing but modern Python and an internet connection.
Documentation: https://mtzgroup.github.io/chemcloud-client
chemcloud
works in harmony with a suite of other quantum chemistry tools for fast, structured, and interoperable quantum chemistry.
The QC Suite of Programs
- qcio - Beautiful and user friendly data structures for quantum chemistry.
- qcparse - A library for efficient parsing of quantum chemistry data into structured
qcio
objects. - qcop - A package for operating quantum chemistry programs using
qcio
standardized data structures. Compatible withTeraChem
,psi4
,QChem
,NWChem
,ORCA
,Molpro
,geomeTRIC
and many more. - BigChem - A distributed application for running quantum chemistry calculations at scale across clusters of computers or the cloud. Bring multi-node scaling to your favorite quantum chemistry program.
ChemCloud
- A web application and associated Python client for exposing a BigChem cluster securely over the internet.
Installation
pip install chemcloud
Quickstart
- Create a ChemCloud account at https://chemcloud.mtzlab.com/signup (or the address of the ChemCloud Server you want to communicate with).
- Instantiate a client
- Configure client (only required the very first time you use
CCClient
)
from chemcloud import CCClient
client = CCClient()
client.configure() # only run this the very first time you use CCClient
# See supported compute engines on the ChemCloud Server
client.supported_engines
['psi4', 'terachem', ...]
# Test connection to ChemCloud
client.hello_world("Colton")
'Welcome to ChemCloud, Colton'
- Run calculations just like you would with
qcop
except callingclient.compute
instead ofqcop.compute
. Rather than getting back anOutput
object directly,client.compute
returns aFutureOutput
object which can be used to get the output of the computation once it is complete.
from qcio import Molecule, ProgramInput
from chemcloud import CCClient
client = CCClient()
# Create the molecule
h2o = Molecule.open("h2o.xyz")
# Define the program input
prog_input = ProgramInput(
molecule=h2o,
calctype="energy",
model={"method": "hf", "basis": "sto-3g"},
keywords={"purify": "no", "restricted": False},
)
# Submit the calculation to the server
future_output = client.compute("terachem", prog_input, collect_files=True)
# Status can be checked at any time
future_result.status
# Get the output (blocking)
output = future_output.get()
# Inspect the output
output.input_data # Input data used by the QC program
output.success # Whether the calculation succeeded
output.results # All structured results from the calculation
output.stdout # Stdout log from the calculation
output.pstdout # Shortcut to print out the stdout in human readable format
output.files # Any files returned by the calculation
output.provenance # Provenance information about the calculation
output.extras # Any extra information not in the schema
output.traceback # Stack trace if calculation failed
output.ptraceback # Shortcut to print out the traceback in human readable format
Examples
Examples of various computations can be found in the examples directory.
Support
If you have any issues with chemcloud
or would like to request a feature, please open an issue.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for chemcloud-0.8.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 03e104cb88ca7f875ac7c3bb1fc33cc568bc9e963f1f9e7fc2b4da3cf0a89173 |
|
MD5 | 0c3c9aba8afc08ecaeb709af1c9d8c46 |
|
BLAKE2b-256 | 2b4940e2bca2bad71af1418bd53bd59e32e32472d234493c43e39afe85a70625 |