.. _Sec:overview: .. image:: images/SORA_logo.png :width: 500 :align: center :alt: SORA: Stellar Occultation Reduction and Analysis | | Overview ======== Stellar Occultations -------------------- A stellar occultation occurs when a solar system object passes in front of a star for an observer on Earth, and its shadow causes a temporary drop in the observed flux of the star. This technique allows the determination of sizes and shapes with kilometre precision and to obtain characteristics of the object, such as its albedo, the presence of an atmosphere, rings, jets, or other structures around the body (Sicardy et al. |BS2011|, |BS2016|, Braga-Ribas et al. |FBR2013|, |FBR2014|, |FBR2019|, Dias-Oliveira et al., |ADO2015|, Benedetti-Rossi et al., |GBR2016|, |GBR2019|, Ortiz et al., |JLO2015|, |JLO2017|, |JLO2020|, Leiva et al., |RL2017|, Bérard et al., |DB2017|, Morgado et al., |BEM2019|, Gomes-Júnior et al., |ARGJ2020|, Souami et al., |DS2020|, Santos-Sanz et al., |PSS2021|) or even the detection of topographic features (Dias-Oliveira et al. |ADO2017|). .. image:: images/stellar_occ.jpg :width: 800 :align: center :alt: Stellar Occultation geometry **Figure 1:** Illustration of a stellar occultation geometry. Original source: IOTA, editted by G. Benedetti-Rossi. The SORA library ---------------- SORA is a Python-based, object-oriented library for optimal analysis of stellar occultation data. The user can use this library to build pipelines to analyse their stellar occultation’s data. It includes processes starting on the prediction of such events to the resulting size, shape and position of the Solar System object. The main modules available at version 0.2 are: **star**, **body**, **observer**, **lightCurve** and **occultation**. It is important to note that new modules and other improvements and implementations can be available in future versions. A stellar occultation is defined by the occulting body (**Body**), the occulted star (**Star**), and the time of the occultation. On the other hand, each observational station (**Observer**) will be associated with their light curve (**LightCurve**). SORA has tasks that allow the user to determine the immersion and emersion times and project them to the tangent sky plane, using the information within the **Observer**, **Body** and **Star** Objects. That projection will lead to chords that will be used to obtain the object’s apparent size, shape and position at the moment of the occultation. Automatic processes were developed for optimising the reduction of typical events. However, users have full control over the parameters and methods and can make changes in every step of the processes. The Classes developed within SORA were built as an integrated system, and they are controlled by the **Occultation** Class. Combining these Classes and the functions therein, the user can perform the complete data reduction, pre- and post-occultation. Jupyter-Notebooks with the features of each Class can be found in the example folder. Acknowledgements ---------------- The SORA library is hosted on a |GitHub| repository. It was developed with support of the |LuckyStar|, that agglomerates the efforts of the Paris, Granada, and Rio teams :superscript:`(1)`. The |LuckyStar| is funded by the ERC (European Research Council) under the European Community’s H2020 (2014-2020/ERC Grant Agreement No. 669416). Also, this project is supported by |LIneA| (Laboratório Interinstitucional de e-Astronomia), INCT do e-Universo (CNPQ grants 465376/2014-2), by FAPESP (proc. 2018/11239-8), by CNPQ (proc. 300472/2020-0, 150612/2020-6), and by CAPES-PRINT/UNESP (88887.571156/2020-00) in Brazil. .. image:: images/Thanks.png :width: 800 :align: center :alt: Acknowledgements **Figure 2:** The SORA team thanks the following institutions, groups and projects for their support: ERC Lucky Star, LIneA/Brazil, INCT do e-Universo/Brazil, UNESP/Brazil, GDOP/Brazil, Observatoire de Paris/France, Observatório Nacional/Brazil and CNPq/Brazil. :superscript:`(1)` The Paris, Granada, and Rio teams are professionals astronomers affiliated mainly in the following institutions: * LESIA - Observatoire de Paris, France; * Institut Polytechnique des Sciences Avancées, France; * IMCCE - Observatoire de Paris, France; * Instituto de Astrofísica de Andalucía, Spain; * Laboratório Interinstitucional de e-Astronomia, Brazil; * INCT do e-Universo, Brazil; * Observatório Nacional/MCTI, Brazil; * Federal University of Technology - Paraná, Brazil; * UNESP - São Paulo State University, Brazil; * Universidade Federal do Rio de Janeiro - Observatório do Valongo, Brazil; .. |BS2011| raw:: html 2011 .. |BS2016| raw:: html 2016 .. |FBR2013| raw:: html 2013 .. |FBR2014| raw:: html 2014 .. |FBR2019| raw:: html 2019 .. |ADO2015| raw:: html 2015 .. |ADO2017| raw:: html 2017 .. |GBR2016| raw:: html 2016 .. |GBR2019| raw:: html 2019 .. |JLO2015| raw:: html 2015 .. |JLO2017| raw:: html 2017 .. |JLO2020| raw:: html 2020 .. |RL2017| raw:: html 2017 .. |DB2017| raw:: html 2017 .. |BEM2019| raw:: html 2019 .. |ARGJ2020| raw:: html 2020 .. |DS2020| raw:: html 2020 .. |PSS2021| raw:: html 2021 .. |GitHub| raw:: html GitHub .. |LuckyStar| raw:: html ERC LuckyStar .. |LIneA| raw:: html LIneA