polarizationtools

Tools to deal with astrophysical polarization data in python3

https://github.com/skiehl/polarizationtools

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (7.2%) to scientific vocabulary

Keywords

astrophysics blazar evpa evpa-rotation polarization randomwalk stochastic-processes stokes-parameters time-series-analysis
Last synced: 6 months ago · JSON representation ·

Repository

Tools to deal with astrophysical polarization data in python3

Basic Info
  • Host: GitHub
  • Owner: skiehl
  • License: bsd-3-clause
  • Language: HTML
  • Default Branch: main
  • Homepage:
  • Size: 75.2 KB
Statistics
  • Stars: 5
  • Watchers: 1
  • Forks: 1
  • Open Issues: 4
  • Releases: 0
Topics
astrophysics blazar evpa evpa-rotation polarization randomwalk stochastic-processes stokes-parameters time-series-analysis
Created over 2 years ago · Last pushed almost 2 years ago
Metadata Files
Readme License Citation

README.md

polarizationtools

Python3 tools to deal with astrophysical polarization data.

Modules

  • evpatools.py Tools to analyze EVPA time series data.
  • misc.py Miscellaneous tools.
  • randomwalk.py Simulate random walks in the Stokes Q-U plane.
  • stokesconversion.py Convert Stokes parameters into linear polarization parameters and vice versa.

Module details

  • evpatools.py
    • EVPAanalyzer class:
      • Shift EVPA data points to account for the 180 degrees ambiguity, following [1].
      • Identify rotations according to the definitions of [4] or [1].
  • misc.py
    • debias_pol function: Debias the fractional linear polarization, following [2].
  • randomwalk.py
    • RWsim class: Simulate random walks in the Stokes Q-U plane, following [1].
  • stokesconversion.py
    • StokesConversion class: Convert Stokes parameters into linear polarization parameters with proper treatment of the uncertainties as explained in [3].
    • StokesConversionSimple class: Convert Stokes parameters into linear polarization parameters and vice versa with simple Gaussian error propagation.

Citation

Bibtex:

@software{2024ascl.soft02006K, author = {{Kiehlmann}, Sebastian}, title = "{polarizationtools: Polarization analysis and simulation tools in python}", howpublished = {Astrophysics Source Code Library, record ascl:2402.006}, year = 2024, month = feb, eid = {ascl:2402.006}, adsurl = {https://ui.adsabs.harvard.edu/abs/2024ascl.soft02006K}, adsnote = {Provided by the SAO/NASA Astrophysics Data System} }

This software package is indexed on ASCL and ADS.

License

polarizationtools is licensed under the BSD 3-Clause License - see the LICENSE file.

References

  1. Kiehlmann et al, 2016
  2. Pavlidou et al, 2014
  3. Blinov et al, 2021
  4. Blinov et al, 2015

Owner

  • Name: Dr. Sebastian Kiehlmann
  • Login: skiehl
  • Kind: user

Citation (CITATION.cff)

cff-version: 1.1.0
message: "Please cite the following works when using this software: https://ui.adsabs.harvard.edu/abs/2024ascl.soft02006K"
authors:
- family-names: Kiehlmann
  given-names: Sebastian
title: "polarizationtools: Polarization analysis and simulation tools in python"
version: PLACEHOLDER
date-released: PLACEHOLDER
identifiers:
 - type: "ascl-id"
   value: "2402.006"
 - type: "doi"
   value: PLACEHOLDER
 - type: "bibcode"
   value: "2024ascl.soft02006K"
abstract: "polarizationtools converts, analyzes, and simulates polarization data. The different python scripts (1) convert Stokes parameters into linear polarization parameters with proper treatment of the uncertainties and vice versa; (2) shift electric vector position angle (EVPA) data points in time series to account for the 180 degrees ambiguity; (3) identify rotations of the EVPA e.g. in blazar polarization monitoring data according to various rotation definitions; and (4) simulate polarization time series as a random walk in the Stokes Q-U plane."

GitHub Events

Total
  • Watch event: 1
Last Year
  • Watch event: 1