Improved plotting features, more publications and error fixing

Version 2.0.4 documentation

Software updates

New features (thanks to @cplee1)

• The matplotlib plotting options to change the figure, model, and markers are now stored in a config file which is built using build_plotting_config.py.
• Can now generate a set of unique marker types that can be used to easily create a consistent set of markers for a multi-pulsar plot (example in the docs).

Bug fixes (thanks to @cplee1 and @robotopia)

• Corrected typo in model equations
• Plot limits now scale to the freqs/bands/fit_range in the x-axis and the fluxs/flux_errs in the y-axis, which fixes an issue with the plot scaling to the model in the y-axis
• The legend is now ordered using the Python sort method (catalogue yamls only; not ATNF or Your Work)

Catalogue updates

New publications (thanks to @YuTing-pulsar and @harvey0908)

• Gitika et al. (2023)
• Crowter et al. (2020)
• Janssen et al. (2009)
• Weisberg et al. (1999)
• Stokes et al. (1985)
• Stokes et al. (1986)
• Tan et al. (2020)
• Ng et al. (2015)
• McLean et al. (1973)
• McGary et al. (2001)
• Lazarus et al. (2015)
• Curylo et al. (2020)
• Shrauner et al. (1998)
• Foster et al. (1991)
• Bhattacharyya et al. (2016)
• Kouwenhoven et al. (2000)
• Dowell et al. (2013)
• Deneva et al. (2016)
• Malofeev et al. (1993)

Updated publications (thanks to @YuTing-pulsar, @cplee1 and @Edgar-Degas)

• Kaur et al. (2019)
• Seiradakis et al. (1995)
• Lorimer et al. (1995)
• Lorimer et al. (2006)
• Lorimer et al. (2007)
• Lynch et al. (2012)
• Manchester et al. (1993)
• Mikhailov et al. (2016)
• Bartel et al. (1978)
• Bates et al. (2011)
• Bhat et al. (2023)
• Deller et al. (2009)
• Demorest et al. (2013)
• Esamdin et al. (2004)
• Han et al. (2016)
• Izvekova et al. (1981)
• Johnston et al. (1992)
• Joshi et al. (2009)
• Kramer et al. (1999)
• Kuniyoshi et al. (2015)
• Ng et al. (2015)

Thesis version

This is the version of pulsar_spectra that was used in Nicholas Swainston's Thesis

More publications

Version 2.0.3 documentation

Software updates

• Uses a new version of psrqpy that can request a specific version of the references. This prevents common reference errors.
• Expanded the documentation on how to add publications to the database to make it easier for new developers
• Reduced high-frequency cut-off limit to 10x max frequency which gives more reasonable fits

Catalogue updates

New publications (thanks to @harvey0908)

• Aloisi et al. (2019)
• Bailes et al. (1997)
• Basu et al. (2018)
• Biggs et al. (1996)
• Boyles et al. (2012)
• Brinkman et al. (2018)
• Champion et al. (2005a)
• Champion et al. (2005b)
• Crawford et al. (2001)
• Crawford et al. (2007)
• Deller et al. (2009)
• Dembska et al. (2015)
• Demorest et al. (2013)
• Esamdin et al. (2004)
• Freire et al. (2007)
• Gentile et al. (2018)
• Giacani et al. (2001)
• Han et al. (1999)
• Hoensbroech et al. (1997)
• Joshi et al. (2009)
• Kaspi et al. (1997)
• Kijak et al. (1998)
• Kramer et al. (1997)
• Kuniyoshi et al. (2015)
• Lewandowski et al. (2004)
• Lorimer et al. (1995)
• Lorimer et al. (1996)
• Lorimer et al. (2005)
• Lorimer et al. (2007)
• Lynch et al. (2012)
• Lynch et al. (2013)
• Manchester et al. (1995)
• Manchester et al. (2013)
• Michilli et al. (2020)
• Mickaliger et al. (2012)
• Mikhailov et al. (2016)
• Ng et al. (2015)
• RoZko et al. (2018)
• Sayer et al. (1997)
• Seiradakis et al. (1995)
• Shapiro and Albert (2021)
• Stovall et al. (2014)
• Surnis et al. (2019)
• Titus et al. (2019)
• Zhao et al. (2017)
• Bhat et al. (2023)

psrqpy fix

Version 2.0.1 documentation

Software updates

• Using the latest version of psrqpy that allows specific versions of the references to prevent errors.
• Created a docker container for easier installation

v2.0 Bandwidth Integration

Version 2.0 documentation

Software updates

• Added the bandwidth of all flux density measurements in the catalogue
• Now take into account the bandwidth of flux density measurements by integrating the model over the bandwidth to more accurately fit data with large fractional bandwidths
• Made an executable script, quick_fit.py to do a quick spectra fit
• No longer use log parabolic spectrum model by default
• Added some docs on how to add a model and what the _ATNF label means
• All psrqpy queries will use version 1.68 of the ATNF pulsar catalogue
• Created tests that use GitHub actions. They test the catalogue to assert pulsar names are consistent with the ATNF, it's correctly formatted, there is no redundant ATNF data, and there ADS links are recorded

Catalogue updates

New publications

• Stappers et al. (2008)
• McEwen et al. (2020)
• Lorimer et al. (2006)
• Kramer et al. (2003a)
• Han et al. (2021)
• Dembska et al. (2014)
• Camilo et al. (1995)
• Robinson et al. (1995)
• McConnell et al. (1991)
• Manchester et al. (1996)
• Qiao et al. (1995)
• Manchester et al. (1993)
• Zepka et al. (1996)
• Manchester et al. (1978a)
• Lundgren et al. (1995)
• Dewey et al. (1985)
• Nicastro et al. (1995)
• Johnston et al. (1992)
• Wolszczan et al. (1992)
• Xie et al. (2019)
• Bhat et al. (2022)
• Lee et al. (2022)
• Kaur et al. (2019)
• Manchester et al. (2001)
• Morris et al. (2002)
• Kondratiev et al. (2016)
• Kravtsov et al. (2022)
• Toscano et al. (1998)
• Kuzmin et al. (2001)
• Stairs et al. (1999)
• Spiewak et al. (2022)
• Zhang et al. (2019)
• Lommen et al. (2000)
• Alam et al. (2021)
• Bondonneau et al. (2021)
• Kramer et al. (1998)
• Kramer et al. (1999)
• Frail et al. (2016)

Updated publications

• Rounded McEwen_2020 to one decimal place
• Renamed Hobbs_2004 as Hobbs_2004a
• Modified Hobbs_2004a to include the discovery fluxes and not use the fluxes from other papers
• Changed Lorimer_1995 to Lorimer_1995a, Kramer_2003 to Kramer_2003a and Lorimer_1995 to Lorimer_1995b
• I believe there was a typo in the Murphy_2017 table, so fixed a frequency value
• Removed Sieber_1973 and Taylor_1993 because it is full of other publications and has no bandwidth recorded
• Fixed Johnston_2018 and Qiao_1995. There were typos that caused their uncertainties to be zero

v1.4

Some updates before submitting comment revisions for Lee et al. 2022.

Version 1.4 documentation

Software updates

• Added a function to calculate the peak frequency for log parabolic spectrum fit (thank you Sammy McSweeney for helping me with the math)
• Made it so that the high-frequency cut-off fit's cut-off frequency has a maximum of 100 times the data's max frequency
• Updated the models so the scaling constant is always c
• Added a ref_markers argument which can override the plot's default data markers
• Added docs for:
  • Publication-quality plots
  • Custom marker types
  • Secondary model plotting
• Added the spectral index to the high-frequency cut-off model instead of having it set at -2
• Implemented a function to perform the emission height calculation.

Catalogue updates

Updated publications

• Fixed error in Bates_2011 uncertainties

Catalogue coverage compared to ATNF

Source	# pulsars
Only ANTF	1640
Both catalogues	650
Only pulsar_spectra	537
Neither catalogues	493

Publication ready

This software is now ready to be used by the public and has been published in Swainstion et al. 2022 and Lee et al. 2022.

Version 1.3 documentation

Software updates

• Added alternate plotting style for publications
• Added the ability to plot multiple fits to compare spectra before and after adding new data
• Improved fitting by adjusting model limits and reducing fit tolerance
• Improved the documentation to include more examples and explanations of the fitting, catalogue and how to add to the catalogue
• Put all model defaults into a model_settings function so it will be easier to add new models or play with defaults in the future
• Implemented double broken power-law, but kept it de-activated for now

Catalogue updates

New publications

• Johnston et al. (1993)
• Taylor et al. (1993)
• Mignani et al. (2017)
• Johnston et. al. (2018)
• Jankowski et al. (2019)
• Sanidas et. al. (2019)
• Bilous et al. (2020)

Updated publications

• Fixed Xue et al. 2017, Bondonneau et. al. 2020, Bilous et. al. 2016
• Fixed the van Ommen et al. (1997) file names
• Removed the internal references from Sieber (1973) (had data that didn't show the Crab turning over at low frequencies)
• Reduced the uncertainty of Taylor et al. (1993) from a factor of 2 to 50%
• Reduced the Zhao et al. (2019) data to just the average values
• Changed Taylor et al. (1993) name and uncertainties
• Fixed error bars in Sieber (1973), which were set as the errors in pulse energies not flux densities
• Fixed error in Xue et al. (2017) data. It included 200 MHz points, however, if you look at the paper, those points are just Murphy et al. (2017) data points.
• Fixed mistake in data from Zakharenko et al. (2013). It included points from Malofeev et al. (2000) and Izvekova et al. (1981).

Catalogue coverage compared to ATNF

Source	# pulsars
Only ANTF	1667
Both catalogues	866
Only pulsar_spectra	298
Neither catalogues	488

Simple Documentation

Rewrote how the catalogue data is handled to make it simpler and added an example to the documentation

Quick fix

Made the versioning manual to prevent pip errors

Version 1.0

The repository is now in a reasonable state so releasing the first version.