Libctl manual
From AbInitio
(diff) ←Older revision | Current revision | Newer revision→ (diff)
libctl |
Manual: Introduction |
Basic User Experience |
Advanced User Experience |
User Reference |
Developer Experience |
Guile and Scheme links |
License and Copyright |
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:
libctl Introduction
The introductory section describes the motivation, history, and high-level structure of libctl.
libctl Basic User Experience
Here, we disuss what a basic ctl control file looks like. From this perspective, ctl is just another control-file format with lots of parentheses.
libctl Advanced User Experience
The advanced user can take advantage of the fact that the ctl file is actually a Scheme program running in a full interpreter (called Guile). Literally anything is possible, especially since the simulation program can support dynamic passing of information back and forth with the control file.
libctl User Reference
A compact listing of the various functions provided for the user by libctl.
libctl Developer Experience
libctl is powerful for the developer, too. One merely specifies an abstract specification file that describes the information that is exchanged with the ctl file, and nearly everything else is automatic.
libctl 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.
libctl License and Copyright
libctl is free software under the GNU Lesser General Public License (GNU LGPL).
Feedback
If you have comments or questions regarding libctl, you can contact Steven G. Johnson at stevenj@alum.mit.edu.
Pages related to libctl.