BornAgain ≻ git-develop ≻ Documentation ≻ Python scripting

Python scripting

The Python application programming interface (API) enables users to run simulations and fits from the high-level programming language Python. This can be done in interactive sessions or by executing a script, using the command line, a Jupyter notebook, or an integrated development environment (IDE) like PyCharm.

Python scripting provides full control. For instance, one can

  • set up arbitrarily complicated combined and constrained fits;
  • batch process huge data sets;
  • react to a simulation or fit outcome through control clauses;
  • extend the functionality of the BornAgain core, for instance by adding custom particle form factors.

Install

Install Python and the BornAgain Python module as explained in the installation instructions.

Check installation

Launch a Python shell, notebook or IDE. At the Python command prompt, enter the command

import bornagain

If the BornAgain module is found, Python prints the next command prompt. Otherwise it will raise a ModuleNotFoundError.

Run a first example script

Run a first example script. Then read the explanation.

Adapt an example

Finally, to start productive work, choose an example script that resembles your application problem, and modify it step by step.

The example catalog provides scripts, input data, and a ZIP archive. Examples also appear throughout the reference section.

Examples are covered by automated tests. If nonetheless an example does not work as expected, then please report this as a bug.

Further tutorials