autofit_workspace

The PyAutoFit workspace

https://github.com/jammy2211/autofit_workspace

Repository

The PyAutoFit workspace

README.rst

PyAutoFit Workspace
====================

.. |binder| image:: https://mybinder.org/badge_logo.svg
   :target: https://mybinder.org/v2/gh/Jammy2211/autofit_workspace/HEAD

.. |JOSS| image:: https://joss.theoj.org/papers/10.21105/joss.02550/status.svg
   :target: https://doi.org/10.21105/joss.02550

|binder| |JOSS|

`Installation Guide `_ |
`readthedocs `_ |
`Introduction on Binder `_ |
`HowToFit `_

Welcome to the **PyAutoFit** Workspace! 

Getting Started
---------------

You can get set up on your personal computer by following the installation guide on
our `readthedocs `_.

Alternatively, you can try **PyAutoFit** out in a web browser by going to the `autofit workspace
Binder `_.

Where To Go?
------------

We recommend that you start with the ``autofit_workspace/notebooks/overview/overview_1_the_basics.ipynb``
notebook, which will give you a concise overview of **PyAutoFit**'s core features and API.

Next, read through the overview example notebooks of features you are interested in, in the folder: ``autofit_workspace/notebooks/overview``.

Then, you may wish to implement your own model in **PyAutoFit**, using the ``cookbooks`` for help with the API. Alternative,
you may want to checkout the ``features`` package for a list of advanced statistical modeling features.

HowToFit
--------

For users less familiar with Bayesian inference and scientific analysis you may wish to read through
the **HowToFits** lectures. These teach you the basic principles of Bayesian inference, with the
content pitched at undergraduate level and above.

A complete overview of the lectures `is provided on the HowToFit readthedocs page `_

Workspace Structure
-------------------

The workspace includes the following main directories:

- ``notebooks``: **PyAutoFit** examples written as Jupyter notebooks.
- ``scipts``: **PyAutoFit** examples written as Python scripts.
- ``projects``: Example projects which use **PyAutoFit**, which serve as a illustration of model-fitting problems and the **PyAutoFit** API.
- ``config``: Configuration files which customize **PyAutoFit**'s behaviour.
- ``dataset``: Where data is stored, including example datasets distributed with **PyAutoFit**.
- ``output``: Where the **PyAutoFit** analysis and visualization are output.

The **examples** in the notebooks and scripts folders are structured as follows:

- ``overview``: Examples using **PyAutoFit** to compose and fit a model to data via a non-linear search.
- ``cookbooks``: Concise API reference guides for **PyAutoFit**'s core features.
- ``features``: Examples of **PyAutoFit**'s advanced modeling features.
- ``howtofit``: Detailed step-by-step tutorials.
- ``searches``: Example scripts of every non-linear search supported by **PyAutoFit**.
- ``plot``: An API reference guide for **PyAutoFits**'s plotting tools.

The following **projects** are available in the project folder:

- ``astro``: An Astronomy project which fits images of gravitationally lensed galaxies.

Workspace Version
-----------------

This version of the workspace are built and tested for using **PyAutoFit v2025.5.7.16**.

Support
-------

Support for installation issues and integrating your modeling software with **PyAutoFit** is available by
`raising an issue on the autofit_workspace GitHub page `_. or
joining the **PyAutoFit** `Slack channel `_, where we also provide the latest updates on
**PyAutoFit**.

Slack is invitation-only, so if you'd like to join send an `email `_ requesting an
invite.

Owner

Citation (CITATIONS.rst)

.. _references:

Citations & References
======================

The bibtex entries for **PyAutoFit** and its affiliated software packages can be found
`here <https://github.com/rhayes777/PyAutoFit/blob/main/files/citations.bib>`_, with example text for citing **PyAutoFit**
in `.tex format here <https://github.com/rhayes777/PyAutoFit/blob/main/files/citation.tex>`_ format here and
`.md format here <https://github.com/rhayes777/PyAutoFit/blob/main/files/citations.md>`_.

As shown in the examples, we would greatly appreciate it if you mention **PyAutoFit** by name and include a link to our GitHub page!

**PyAutoFit** is published in the `Journal of Open Source Software <https://joss.theoj.org/papers/10.21105/joss.02550#>`_ and its
entry in the above .bib file is under the key ``pyautofit``.

GitHub Events