Added documentation

Author: lindonroberts

.gitignore

@@ -1,7 +1,6 @@
 *.pyc
 */__pycache__
 *.egg-info
-docs/_build
 dist/
 venv/
 .eggs/

dfbgn/exit_information.py

@@ -118,7 +118,9 @@ def __str__(self):
             output += "Needed %g objective evaluations\n" % (self.nf)
             if self.nruns > 1:
                 output += "Did a total of %g runs\n" % self.nruns
-            if np.size(self.jacobian) < 200:
+            if self.jacobian is None:
+                output += "No approximate Jacobian available\n"
+            elif np.size(self.jacobian) < 200:
                 output += "Approximate Jacobian = %s\n" % str(self.jacobian)
             else:
                 output += "Not showing approximate Jacobian because it is too long; check self.jacobian\n"

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/_build/doctrees/environment.pickle

@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: e7e4519aca41910b746d8b9cb3eee0db
+tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/_build/doctrees/index.doctree

@@ -0,0 +1,37 @@
+.. DFBGN documentation master file, created by
+   sphinx-quickstart on Fri Oct 23 17:28:35 2020.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+DFBGN: Derivative-Free Block Gauss-Newton Optimizer for Least-Squares Minimization
+==================================================================================
+
+**Release:** |version|
+
+**Date:** |today|
+
+**Author:** `Lindon Roberts <[email protected]>`_
+
+DFBGN is a package for finding local solutions to large-scale nonlinear least-squares minimization problems, without requiring any derivatives of the objective. DFBGN stands for Derivative-Free Block Gauss-Newton.
+
+That is, DFBGN solves
+
+.. math::
+
+   \min_{x\in\mathbb{R}^n} \quad  f(x) := \sum_{i=1}^{m}r_{i}(x)^2
+
+If you wish to solve small-scale least-squares problems, you may wish to try `DFO-LS <https://github.com/numericalalgorithmsgroup/dfols>`_. If you are interested in solving general optimization problems (without a least-squares structure), you may wish to try `Py-BOBYQA <https://github.com/numericalalgorithmsgroup/pybobyqa>`_.
+
+DFBGN is released under the GNU General Public License. Please `contact NAG <http://www.nag.com/content/worldwide-contact-information>`_ for alternative licensing.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   install
+   userguide
+
+Acknowledgements
+----------------
+This software was developed under the supervision of `Coralia Cartis <https://www.maths.ox.ac.uk/people/coralia.cartis>`_, and was supported by the EPSRC Centre For Doctoral Training in `Industrially Focused Mathematical Modelling <https://www.maths.ox.ac.uk/study-here/postgraduate-study/industrially-focused-mathematical-modelling-epsrc-cdt>`_ (EP/L015803/1) in collaboration with the `Numerical Algorithms Group <http://www.nag.com/>`_.
+