# SourceXtractor++
[![Conda](https://img.shields.io/conda/v/astrorama/sourcextractor)](https://anaconda.org/astrorama/sourcextractor)
[![Fedora package](https://img.shields.io/fedora/v/sourcextractor++/rawhide)](https://koji.fedoraproject.org/koji/packageinfo?packageID=30842)
[![Build RPM](https://github.com/astrorama/SourceXtractorPlusPlus/workflows/Build%20RPM/badge.svg)](https://github.com/astrorama/SourceXtractorPlusPlus/actions)
[![Coverity](https://scan.coverity.com/projects/19270/badge.svg?flat=1)](https://scan.coverity.com/projects/astrorama-sextractorxx)
[![Documentation](https://readthedocs.org/projects/sourcextractorplusplus/badge/?version=latest)](https://sourcextractorplusplus.readthedocs.io/en/latest/Introduction.html)
[![CodeFactor](https://www.codefactor.io/repository/github/astrorama/sourcextractorplusplus/badge/develop)](https://www.codefactor.io/repository/github/astrorama/sourcextractorplusplus/overview/develop)

The next generation SExtractor.

Documentation: https://astrorama.github.io/SourceXtractorPlusPlus/

# Installation

## Conda

SourceXtractor++ is available on [Anaconda Cloud for Linux and MacOSX](https://anaconda.org/astrorama/sourcextractor)

```bash
conda install -c conda-forge -c astrorama sourcextractor==1.1.0
 ```

We would recommend, however, to install it into its own environment.

```bash
conda create -n sourcex -c astrorama -c conda-forge sourcextractor==1.1.0
conda activate sourcex
 ```

**Note:** If you want the development version to test a future functionality or bugfix, it can also be done with conda:

```bash
conda create -n sourcex-dev -c astrorama/label/develop -c astrorama -c conda-forge sourcextractor=x.xx
conda activate sourcex-dev
```

We recommend always using an explicit version number as there is no guarantee that `conda` will install the latest version otherwise.

Fedora and RPM

RPM packages are temporarily not available due to technical problems.

## Test Data Set

A test data set covering various data reduction scenarios is available [here](https://cloud.physik.lmu.de/index.php/s/3K4KemBsw5y9yqd).
It contains the input data, all relevant configuration files, the SourceXtractor++ commands and the expected output results for a reference.
The test data set is described as a [pre-print](http://arxiv.org/abs/2212.02428) for the corresponding conference proceedings.

## Discussion group for SourceXtractor++ users

In order to facilitate an active discussion among SourceXtractor++ users we have created
a [users group](https://groups.google.com/g/sourcextractor_plusplus). We encourage all users to directly
join the group (if a google account is at hand) or to ask us to add you as a member
(open an issue on the [github page](https://astrorama.github.io/SourceXtractorPlusPlus/).


## References and Acknowledgment

While we are working on several refereed papers describing SourceXtractor++ and its software architecture, the software package can be referenced with two ADASS conference proceedings:

- [Bertin, E.; Schefer, M. ; Apostolakos, N. ; Álvarez-Ayllón, A.; Dubath, P. ; Kümmel, M.: 2020ASPC..527..461B](https://ui.adsabs.harvard.edu/abs/2020ASPC..527..461B/abstract)
- [Kümmel, M.; Álvarez-Ayllón, A.; Bertin, E.; Dubath, P.; Gavazzi, R.; Hartley, W.; Schefer, M.: 2022arXiv221202428K](https://ui.adsabs.harvard.edu/abs/2022arXiv221202428K/abstract) 

Resources for the SourceXtractor++ development are in most part provided by funding from the [Euclid satellite project](https://www.euclid-ec.org/) via the various national agencies.
For Euclid Consortium papers it is sufficient to point to the [SourceXtractor++ webpage](https://github.com/astrorama/SourceXtractorPlusPlus) and add
the standard EC acknowledgement text.

For scientific publication which are non EC papers we would be greatful if the following acknowledgment could be added:
```
This research made use of {\tt SourceXtractor++}\footnote{https://github.com/astrorama/SourceXtractorPlusPlus},
an open source software package developed for the Euclid satellite project.
```