=============== Getting Started =============== First follow the installation instructions, then come here to learn how to use AstroPhot for the first time. Basic AstroPhot code organization --------------------------------- AstroPhot is a modular and object oriented astronomical image modelling package. Modularity means that it is relatively simple to change or replace one aspect of the code without breaking everything else. A modular framework makes the code extensible to a wide range of photometry applications, though it comes with a small performance penalty (which is made up for by the powerful pytorch backend). As an object oriented package that means the code can be interfaced more intuitively. For example if you have two image objects ``image1`` and ``image2`` it is possible to combine them with a plus sign: ``image3 = image1 + image2`` and the behaviour should be as expected. Most interfaces to AstroPhot functionality have relatively intuitive names and try to behave the way you would expect. This makes the experience more user friendly hopefully meaning that you can quickly take advantage of the powerful features available. One of the core components of AstroPhot is the model objects, these are organized in a class hierarchy with several layers of inheritance. With this hierarchy it is very easy to customize a model to suit your needs without needing to rewrite a great deal of code. Simply access the point in the hierarchy which most closely matches your desired result and make minor modifications. In the tutorials you can see how detailed models can be implemented with only a few lines of code even though the user has complete freedom to change any aspect of the model. Install ------- For most users, you can just run:: pip install astrophot If you wish to help with the development, then see the `contributing guide `_. Fit Something Fast! ------------------- Check out this page if you have some data and you just want results fast! :doc:`fastfit` Using the Tutorials ------------------- The easiest way to get started using AstroPhot is to try running the jupyter notebook tutorials. Simply make a new directory where you want to run the tutorials then run the:: astrophot tutorials command to download the AstroPhot tutorials. If you run into difficulty with this, you can also access the tutorials directly at :doc:`tutorials` to download as PDFs or jupyter notebooks. Once you have the tutorials, start a jupyter session and run through them. Model Zoo --------- The best way to see what models are available in AstroPhot is to peruse the :doc:`tutorials/ModelZoo`. Here you can see the models evaluated on a regular grid, and play around with the values if you are running the tutorial locally. Detailed Documentation ---------------------- Detailed documentation can be found by navigating the :doc:`astrophot` link tree on the left. Currently it is not very organized, but detailed information can be found on just about every AstroPhot system there. Further organization will come to make it easier to navigate. For now you can also just search the model type you are interested in, in the search bar.