specpolFlow 1.1.0

Tools for the analysis of stellar spectropolarimetric data

Welcome to SpecpolFlow!

SpecpolFlow is live on PyPI at:

pip install specpolFlow

Installing SpecpolFlow will automatically install LSDpy.

The spectrum normalization tool NormPlot is an optional extra. It can be installed at the same time as SpecpolFlow using:

pip install specpolFlow[norm]

or NormPlot can be installed separately using:

pip install normPlot

Documentation is live on our website at: folsomcp.github.io/specpolFlow/

About SpecpolFlow

SpecpolFlow is a software package that provides a completely pythonic workflow for the analysis of spectropolarimetric observations of stellar sources (for example, data acquired from ESPaDOnS at CFHT, Narval at TBL, etc). It is designed to provide a single, user-friendly pipeline from telescope to science product.

SpecpolFlow incorporates tools for spectra normalization (Github: folsomcp/normPlot) and LSD profile calculation (Github: folsomcp/LSDpy). It also provides several supporting tools, including tools for developing and cleaning line masks, calculating the longitudinal magnetic field, and visualizing LSD profiles. These tools can be used through a fully documented Python API, or through a command line interface.

We also maintain a series of detailed tutorials, with examples of how to construct a flexible workflow from SpecpolFlow's tools for your specific needs (e.g., automation for very large datasets using tools like pandas = Python for Data Analysis). These tutorials are in the form of Jupyter Notebooks, which can also be run using collaborative platforms such as Google Colab.

The full documentation can be found here: folsomcp.github.io/specpolFlow/

Citing

If you use SpecpolFlow in your research, please cite our paper in the Journal of Open Source Software: Folsom, Erba, et al., (2025). SpecpolFlow: a new software package for spectropolarimetry using Python. Journal of Open Source Software, 10(111), 7891

Contact us!

You can reach the SpF Development Team at: [e-mail]

SpF Development Team:

• Christi Erba (co-PI)
• Colin Folsom (co-PI)
• Veronique Petit
• Shaquann Seadrow
• Patrick Stanley
• Tali Natan
• Bonnie Zaire

Current Contributors:

• Gregg Wade
• Mary Oksala

Past Contributors:

• Federico Villadiego Forero
• DJ Meleney
• Robin Moore
• Dax Moraes
• Marisol Catalan Olais

Logo:

The SpecpolFlow logo was created by the talented Tali Natan! Please contact the SpF team if you would like to use this graphic in a publication.