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 v2023.7.5.2**. 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.