Metadata-Version: 2.5
Name: tessapps
Version: 0.3.0
Summary: TESS Aperture Photometry Pollution eStimator
Author: Leonidas Liponis
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: MIT License
License-File: LICENSE
Requires-Dist: numpy>=1.21.2
Requires-Dist: scipy>=1.7.2
Requires-Dist: astropy>=5.0
Requires-Dist: astroquery>=0.4.6
Requires-Dist: matplotlib>=3.5
Requires-Dist: lightkurve>=2.0
Project-URL: Homepage, https://codeberg.org/leolip128/tessapps
Project-URL: Repository, https://codeberg.org/leolip128/tessapps
Import-Name: tessapps

# TESS Aperture Photometry Pollution eStimator   [![PyPI](https://img.shields.io/pypi/v/tessapps)](https://pypi.org/project/tessapps/)

*Note: this module is not yet fully developed. For commercial use, please wait for v1.0.0. It is expected to be in development for at least another month.*

## Description

A python module that calculates a contamination factor in the aperture region of a tpf based on the relative flux of the background stars and the target.

<p align="center">
    <img src="https://codeberg.org/leolip128/tessapps/raw/branch/main/documentation/examples/images/HAT-P-1.png" alt="HAT-P-1 example" style="width:63.21%; height:auto;">
</p>

Full documentation is available [here](https://codeberg.org/leolip128/tessapps/src/branch/main/documentation/). Below is some useful information, taken from the documentation.

## Installation

### Prerequisites

- ```numpy``` (>=1.21.2): to make all calculations
- ```scipy``` (>=1.7.2): to integrate the gaussian function
- ```astropy``` (>=5.0): to build data used in this module
- ```astroquery``` (>=0.4.6): to find stars in the target's region
- ```matplotlib``` (>=3.5): to plot the result (shows aperture mask with a caption at the bottom)
- ```lightkurve``` (>=2.0): to fetch and load tpf files

Python >=3.10 is required. More information about dependencies can be found [here](https://codeberg.org/leolip128/tessapps/src/branch/main/documentation/installation).

### How to install

Run ```pip install tessapps```.

## Running the module

### Running from a notebook

A tpf is needed to run this module. If no tpf is supplied, the default is a file with HAT-P-1 (the example picture above). So, here is the minimal example:
```
import tessapps

tessapps.run()

>>> [0.57675, 0.00191]
```

The first number is the contamination factor, and the second is its error. Here is a more realistic example with CoRoT-1 (also in the example images):

```
import lightkurve as lk
import tessapps as tapps

CoRoT_1_tpf = lk.search_targetpixelfile('CoRoT 1')[1].download()
contamination, error = tapps.run(CoRoT_1_tpf, result=True)

>>> The background contributes (2.249 ± 0.020)% of the total flux in the aperture region.
```

This means that the contamination factor is 0.02249 ± 0.00020 (rounded).

### Running from a terminal

Alternatively, from a terminal you can run this module as:
```
tapps --tpf tpf_file
python3 -m tessapps --tpf tpf_file
```

More about usage information in [here](https://codeberg.org/leolip128/tessapps/src/branch/main/documentation/usage).

## Authors

Leonidas Liponis

## Links

PyPI page: https://pypi.org/project/tessapps/

Codeberg page: https://codeberg.org/leolip128/tessapps

Email (for contact): lliponis (at) physics.auth.gr

## AI Disclosure

No LLMs were used in the making of this project. All code was generated and verified by humans, so it will only contain human-made mistakes. All commits made by bots will be refused, and commits made by humans will be checked: published code should be fully understandable by the authors.

## To-Do list

- add description
- specify dependencies' versions
- add options to run the module
- redo the examples since they reference the flux instead of the contamination factor
- add the scoring function
- add more stuff in this to-do list
