Welcome to the manual for libctl, a Guile-based library implementing flexible control files for scientific simulations. This documentation is divided into the following sections, which you should read roughly in order if you are new to libctl:

  • Introduction — Motivation, history, and high-level structure of libctl.
  • Installation — Instructions for installing libctl on Unix-like systems such as Linux and macOS
  • Basic User Experience — Features of a basic ctl control file.
  • Advanced User Experience — The ctl file is actually a Scheme program running in a full interpreter (called Guile) which enables a broad range of functionality.
  • User Reference — Compact listing of the various functions provided for the user.
  • Developer Experience — By specifying an abstract specification file that describes the information that is exchanged with the ctl file, nearly everything else can be automated.
  • Guile and Scheme Information — Guile is a standard GNU program for adding scripting and extensibility to software. It implements an embeddable interpreter for the Scheme language. There are many places that you can go to learn more about Guile and Scheme, and we link to a few of them here.
  • License and Copyright — libctl is free and open-source software under the GNU General Public License (GNU LGPL).


For questions, bug reports, and feature requests, please file a GitHub issue.