From 322ae0b0199528a247ecb64627c1d412b137a48d Mon Sep 17 00:00:00 2001 From: Thomas Albers Raviola Date: Fri, 23 Aug 2024 12:28:25 +0200 Subject: Update sphinx documentation --- docs/schrodinger_plot.rst | 6 ++++-- docs/schrodinger_solve.rst | 52 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 56 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/schrodinger_plot.rst b/docs/schrodinger_plot.rst index b47fbae..e70ac01 100644 --- a/docs/schrodinger_plot.rst +++ b/docs/schrodinger_plot.rst @@ -14,6 +14,10 @@ axis limits to better visualize the solution. If no custom scale or limits are g schrodinger_solve will limit the plot by the limits of the potential as well as the energies of the solution for a better initial result. +**Usage** +:: + + schrodinger_plot.py [-h] [-s SOLUTION_DIR] [-o OUTPUT_DIR] [--show SHOW] [-e EXPORT] [--scale SCALE] [-x XLIM] [-y1 ENERGY_LIM] [-y2 UNCERTAINTY_LIM] **Command line options** :: @@ -40,5 +44,3 @@ energies of the solution for a better initial result. Limit of the y-axis of the right plot. None or tuple[float, float] of shape (y_min, y_max)(default: None) - -:: diff --git a/docs/schrodinger_solve.rst b/docs/schrodinger_solve.rst index a4535b0..46a4596 100644 --- a/docs/schrodinger_solve.rst +++ b/docs/schrodinger_solve.rst @@ -1,3 +1,55 @@ ***************** Schrodinger Solve ***************** + +Solves the one-dimensional, time independent Schroedinger's equation for a given +system and generates files with the energies, potential, wave functions and +expectation value of the position of the particles. schrodinger_solve takes a +file describing the parameters to use and the potential (see below for file +format). + +**Usage** +:: + + schrodinger_solve [-h] [-o OUTPUT_DIR] filename + +**Command line options** +:: + + positional arguments: + filename File describing the system to solve + + options: + -h, --help show this help message and exit + -o OUTPUT_DIR, --output-dir OUTPUT_DIR + Output directory for the results + + +**Input file format** + +The input file format consist of a five line header followed by a csv style, two +column table describing the potential. Lines in the header that specify multiple +parameters are separated by whitespace characters (tab or space). Parameters +must be given in a fixed order. Comments discard the rest of the line and +may be added with a ``#`` character. An empty line is discarded and the next +non-empty line specifies the next parameter. A concrete example is given below. +:: + + + + + + + + + ... + + +- mass: (real) Mass of the particle +- x-min, x-max: (real) Solution interval +- n-points: (integer) Number of points in the discretization of the solution + interval +- first-eigenvalue, last-eigenvalue: (integer) Interval of energy eigenvalues to + generate + +Further examples can be found in the subfolders inside ``test`` -- cgit v1.2.3