Welcome to ichor’s documentation!

Introduction

ichor is a Python package used to simplify data management from computational chemistry programs and aid with machine learning force field development.

Here is a list of things that the package is intended to do:

  • provide interfaces to any computational chemistry software to allow for easy switching between similar software and results comparison.

  • implement flexible data structures to allow for data management of hundreds of thousands of calculations from multiple programs.

  • integrate common database formats for efficient data storage, sharing, and post-processing

  • provide interfaces to workload managers on compute clusters to automate job submission

  • collate tools for machine learning dataset and model analysis, as well as molecular dynamics simulation benchmarking

Realistically, the file management portion of ichor (as well as the workload manager integration) is very general, so it can be used for any type of data that might not even be computational chemistry related. However, the focus of the source code itself is on computational chemistry and machine learning force field development.

The ichor package is a namespace package that contains three packages: ichor.core, ichor.hpc, and ichor.cli. The ichor.core packages contains mostly file management and analysis tools for the different types of files that must be read (from Gaussian, AIMAll, etc.). The ichor.hpc package contains code allows a user to submit jobs on compute clusters (SGE and SLURM). The ichor.cli packages is a menu system that allows a user to do the most common tasks without having to write individual scripts.

Below are examples of how to use ichor.

full documentation of source code

Indices and tables