From e1287b02c069f5e382e238b9d913a611cb9b899a Mon Sep 17 00:00:00 2001 From: dh00601 <dh00601@surrey.ac.uk> Date: Wed, 20 Jul 2022 10:45:31 +0100 Subject: [PATCH] added files for the JOSS paper --- papers/paper.bib | 144 +++++++++++++++++++++++++ papers/paper.crossref | 237 ++++++++++++++++++++++++++++++++++++++++++ papers/paper.md | 135 ++++++++++++++++++++++++ 3 files changed, 516 insertions(+) create mode 100644 papers/paper.bib create mode 100644 papers/paper.crossref create mode 100644 papers/paper.md diff --git a/papers/paper.bib b/papers/paper.bib new file mode 100644 index 000000000..a4ab8faaa --- /dev/null +++ b/papers/paper.bib @@ -0,0 +1,144 @@ +@article{izzardNewSyntheticModel2004, + title = {A New Synthetic Model for Asymptotic Giant Branch Stars}, + author = {Izzard, Robert G. and Tout, Christopher A. and Karakas, Amanda I. and Pols, Onno R.}, + year = {2004}, + month = may, + journal = {Monthly Notices of the Royal Astronomical Society}, + volume = {350}, + number = {2}, + pages = {407--426}, + issn = {0035-8711}, + doi = {10.1111/j.1365-2966.2004.07446.x}, + abstract = {Abstract. We present a synthetic model for thermally pulsing asymptotic giant branch (TPAGB) evolution constructed by fitting expressions to full evolutionary}, + langid = {english}, + keywords = {masterthesis}, + file = {/home/david/pdfs/Zotero/Izzard et al_2004_A new synthetic model for asymptotic giant branch stars.pdf;/home/david/Zotero/storage/DNNTAJQF/1113239.html} +} + +@article{izzardPopulationNucleosynthesisSingle2006, + title = {Population Nucleosynthesis in Single and Binary Stars - {{I}}. {{Model}}}, + author = {Izzard, R. G. and Dray, L. M. and Karakas, A. I. and Lugaro, M. and Tout, C. A.}, + year = {2006}, + month = dec, + journal = {Astronomy \& Astrophysics}, + volume = {460}, + number = {2}, + pages = {565--572}, + issn = {0004-6361, 1432-0746}, + doi = {10.1051/0004-6361:20066129}, + abstract = {We present a synthetic algorithm to rapidly calculate nucleosynthetic yields from populations of single and binary stars for use in population synthesis, globular cluster and Galactic chemical evolution simulations. Single star nucleosynthesis is fitted directly to full evolution models and our model includes first, second and third dredge-ups with \emph{s{$<$}i/{$>$}-process enhancements, an analytic calculation for hot-bottom burning of CNO, NeNa and MgAl isotopes, surface enhancements due to wind loss in massive stars and core-collapse supernova yields. Even though this algorithm operates about 10\textsuperscript{7{$<$}sup/{$>$} times faster than full evolution and nucleosynthesis calculations, agreement with such models is good. We extend the single star model to include prescriptions of binary star interactions, notably mass loss and gain by stellar winds and Roche-lobe overflow, novae and type Ia supernovae. As examples of the application of our algorithm we present models of some interesting systems containing chemically peculiar stars that may occur in binaries.}}}, + copyright = {\textcopyright{} ESO, 2006}, + langid = {english}, + keywords = {masterthesis}, + file = {/home/david/pdfs/Zotero/Izzard et al_2006_Population nucleosynthesis in single and binary stars - I.pdf;/home/david/Zotero/storage/8EB73LN9/aa6129-06.html} +} + +@article{izzardPopulationSynthesisBinary2009, + ids = {izzardPopulationSynthesisBinary2009a}, + title = {Population Synthesis of Binary Carbon-Enhanced Metal-Poor Stars}, + author = {Izzard, R. G. and Glebbeek, E. and Stancliffe, R. J. and Pols, O. R.}, + year = {2009}, + month = dec, + journal = {Astronomy and Astrophysics}, + volume = {508}, + number = {3}, + pages = {1359--1374}, + publisher = {{EDP Sciences}}, + issn = {0004-6361}, + doi = {10.1051/0004-6361/200912827}, + abstract = {The carbon-enhanced metal-poor (CEMP) stars constitute approximately one fifth of the metal-poor ([Fe/H] {$\lnapprox$} -2) population but their origin is not well understood. The most widely accepted formation scenario, at least for the majority of CEMP stars which are also enriched in s-process elements, invokes mass-transfer of carbon-rich material from a thermally-pulsing asymptotic giant branch (TPAGB) primary star to a less massive main-sequence companion which is seen today. Recent studies explore the possibility that an initial mass function biased toward intermediate-mass stars is required to reproduce the observed CEMP fraction in stars with metallicity [Fe/H]{$<$}-2.5. These models also implicitly predict a large number of nitrogen-enhanced metal-poor (NEMP) stars which is not seen. In this paper we investigate whether the observed CEMP and NEMP to extremely metal-poor (EMP) ratios can be explained without invoking a change in the initial mass function. We construct binary-star populations in an attempt to reproduce the observed number and chemical abundance patterns of CEMP stars at a metallicity [Fe/H]\texttildelow -2.3. Our binary-population models include synthetic nucleosynthesis in TPAGB stars and account for mass transfer and other forms of binary interaction. This approach allows us to explore uncertainties in the CEMP-star formation scenario by parameterization of uncertain input physics. In particular, we consider the uncertainty in the physics of third dredge up in the TPAGB primary, binary mass transfer and mixing in the secondary star. We confirm earlier findings that with current detailed TPAGB models, in which third dredge up is limited to stars more massive than about 1.25\textasciitilde M{$\odot$}, the large observed CEMP fraction cannot be accounted for. We find that efficient third dredge up in low-mass (less than 1.25\textasciitilde M{$\odot$}), low-metallicity stars may offer at least a partial explanation for the large observed CEMP fraction while remaining consistent with the small observed NEMP fraction. Appendices A-E are only available in electronic form at http://www.aanda.org}, + keywords = {abundances,binaries: close,Galaxy: halo,Galaxy: stellar content,masterthesis,nuclear reactions,nucleosynthesis,project_core,stars: carbon,stars: chemically peculiar,to_read}, + file = {/home/david/pdfs/Zotero/Izzard et al_2009_Population synthesis of binary carbon-enhanced metal-poor stars.pdf;/home/david/Zotero/storage/BAXNURKG/aa12827-09.html} +} + +@article{izzardBinaryStarsGalactic2018, + title = {Binary Stars in the {{Galactic}} Thick Disc}, + author = {Izzard, Robert G. and Preece, Holly and Jofre, Paula and Halabi, Ghina M. and Masseron, Thomas and Tout, Christopher A.}, + year = {2018}, + month = jan, + journal = {Monthly Notices of the Royal Astronomical Society}, + volume = {473}, + pages = {2984--2999}, + issn = {0035-8711}, + doi = {10.1093/mnras/stx2355}, + abstract = {The combination of asteroseismologically measured masses with abundances from detailed analyses of stellar atmospheres challenges our fundamental knowledge of stars and our ability to model them. Ancient red-giant stars in the Galactic thick disc are proving to be most troublesome in this regard. They are older than 5 Gyr, a lifetime corresponding to an initial stellar mass of about 1.2 M{$\odot$}. So why do the masses of a sizeable fraction of thick-disc stars exceed 1.3 M{$\odot$}, with some as massive as 2.3 M{$\odot$}? We answer this question by considering duplicity in the thick-disc stellar population using a binary population-nucleosynthesis model. We examine how mass transfer and merging affect the stellar mass distribution and surface abundances of carbon and nitrogen. We show that a few per cent of thick-disc stars can interact in binary star systems and become more massive than 1.3 M{$\odot$}. Of these stars, most are single because they are merged binaries. Some stars more massive than 1.3 M{$\odot$} form in binaries by wind mass transfer. We compare our results to a sample of the APOKASC data set and find reasonable agreement except in the number of these thick-disc stars more massive than 1.3 M{$\odot$}. This problem is resolved by the use of a logarithmically flat orbital-period distribution and a large binary fraction.}, + keywords = {binaries: general,binary,Galaxy: disc,Galaxy: stellar content,masterthesis,surrey,to_Read}, + file = {/home/david/pdfs/Zotero/Izzard et al_2018_Binary stars in the Galactic thick disc2.pdf} +} + +@article{foreman-mackeyEmceeMCMCHammer2013, + title = {Emcee: {{The MCMC Hammer}}}, + shorttitle = {Emcee}, + author = {{Foreman-Mackey}, Daniel and Hogg, David W. and Lang, Dustin and Goodman, Jonathan}, + year = {2013}, + month = mar, + journal = {Publications of the Astronomical Society of the Pacific}, + volume = {125}, + number = {925}, + eprint = {1202.3665}, + eprinttype = {arxiv}, + pages = {306--312}, + issn = {00046280, 15383873}, + doi = {10.1086/670067}, + abstract = {We introduce a stable, well tested Python implementation of the affine-invariant ensemble sampler for Markov chain Monte Carlo (MCMC) proposed by Goodman \& Weare (2010). The code is open source and has already been used in several published projects in the astrophysics literature. The algorithm behind emcee has several advantages over traditional MCMC sampling methods and it has excellent performance as measured by the autocorrelation time (or function calls per independent sample). One major advantage of the algorithm is that it requires hand-tuning of only 1 or 2 parameters compared to \$\textbackslash sim N\^2\$ for a traditional algorithm in an N-dimensional parameter space. In this document, we describe the algorithm and the details of our implementation and API. Exploiting the parallelism of the ensemble method, emcee permits any user to take advantage of multiple CPU cores without extra effort. The code is available online at http://dan.iel.fm/emcee under the MIT License.}, + archiveprefix = {arXiv}, + keywords = {Astrophysics - Instrumentation and Methods for Astrophysics,Physics - Computational Physics,Statistics - Computation}, + file = {/home/david/pdfs/Zotero/Foreman-Mackey et al_2013_emcee.pdf;/home/david/Zotero/storage/SSM96UY2/1202.html} +} + +@article{speagleDynestyDynamicNested2020, + title = {Dynesty: A Dynamic Nested Sampling Package for Estimating {{Bayesian}} Posteriors and Evidences}, + shorttitle = {Dynesty}, + author = {Speagle, Joshua S}, + year = {2020}, + month = apr, + journal = {Monthly Notices of the Royal Astronomical Society}, + volume = {493}, + number = {3}, + pages = {3132--3158}, + issn = {0035-8711}, + doi = {10.1093/mnras/staa278}, + abstract = {We present dynesty, a public, open-source, python package to estimate Bayesian posteriors and evidences (marginal likelihoods) using the dynamic nested sampling methods developed by Higson et~al. By adaptively allocating samples based on posterior structure, dynamic nested sampling has the benefits of Markov chain Monte Carlo (MCMC) algorithms that focus exclusively on posterior estimation while retaining nested sampling's ability to estimate evidences and sample from complex, multimodal distributions. We provide an overview of nested sampling, its extension to dynamic nested sampling, the algorithmic challenges involved, and the various approaches taken to solve them in this and previous work. We then examine dynesty's performance on a variety of toy problems along with several astronomical applications. We find in particular problems dynesty can provide substantial improvements in sampling efficiency compared to popular MCMC approaches in the astronomical literature. More detailed statistical results related to nested sampling are also included in the appendix.}, + file = {/home/david/pdfs/Zotero/Speagle_2020_dynesty.pdf;/home/david/Zotero/storage/PZBMLD2H/5721521.html} +} + +@article{astropycollaborationAstropyCommunityPython2013, + title = {Astropy: {{A}} Community {{Python}} Package for Astronomy}, + shorttitle = {Astropy}, + author = {{Astropy Collaboration} and Robitaille, Thomas P. and Tollerud, Erik J. and Greenfield, Perry and Droettboom, Michael and Bray, Erik and Aldcroft, Tom and Davis, Matt and Ginsburg, Adam and {Price-Whelan}, Adrian M. and Kerzendorf, Wolfgang E. and Conley, Alexander and Crighton, Neil and Barbary, Kyle and Muna, Demitri and Ferguson, Henry and Grollier, Fr{\'e}d{\'e}ric and Parikh, Madhura M. and Nair, Prasanth H. and Unther, Hans M. and Deil, Christoph and Woillez, Julien and Conseil, Simon and Kramer, Roban and Turner, James E. H. and Singer, Leo and Fox, Ryan and Weaver, Benjamin A. and Zabalza, Victor and Edwards, Zachary I. and Azalee Bostroem, K. and Burke, D. J. and Casey, Andrew R. and Crawford, Steven M. and Dencheva, Nadia and Ely, Justin and Jenness, Tim and Labrie, Kathleen and Lim, Pey Lian and Pierfederici, Francesco and Pontzen, Andrew and Ptak, Andy and Refsdal, Brian and Servillat, Mathieu and Streicher, Ole}, + year = {2013}, + month = oct, + journal = {Astronomy and Astrophysics}, + volume = {558}, + pages = {A33}, + issn = {0004-6361}, + doi = {10.1051/0004-6361/201322068}, + abstract = {We present the first public version (v0.2) of the open-source and community-developed Python package, Astropy. This package provides core astronomy-related functionality to the community, including support for domain-specific file formats such as flexible image transport system (FITS) files, Virtual Observatory (VO) tables, and common ASCII table formats, unit and physical quantity conversions, physical constants specific to astronomy, celestial coordinate and time transformations, world coordinate system (WCS) support, generalized containers for representing gridded as well as tabular data, and a framework for cosmological transformations and conversions. Significant functionality is under activedevelopment, such as a model fitting framework, VO client and server tools, and aperture and point spread function (PSF) photometry tools. The core development team is actively making additions and enhancements to the current code base, and we encourage anyone interested to participate in the development of future Astropy versions.}, + langid = {english}, + file = {/home/david/pdfs/Zotero/Collaboration et al_2013_Astropy.pdf;/home/david/Zotero/storage/VXZP754H/abstract.html} +} + +@article{astropycollaborationAstropyProjectBuilding2018, + title = {The {{Astropy Project}}: {{Building}} an {{Open-science Project}} and {{Status}} of the v2.0 {{Core Package}}}, + shorttitle = {The {{Astropy Project}}}, + author = {{Astropy Collaboration} and {Price-Whelan}, A. M. and Sip{\H o}cz, B. M. and G{\"u}nther, H. M. and Lim, P. L. and Crawford, S. M. and Conseil, S. and Shupe, D. L. and Craig, M. W. and Dencheva, N. and Ginsburg, A. and VanderPlas, J. T. and Bradley, L. D. and {P{\'e}rez-Su{\'a}rez}, D. and {de Val-Borro}, M. and Aldcroft, T. L. and Cruz, K. L. and Robitaille, T. P. and Tollerud, E. J. and Ardelean, C. and Babej, T. and Bach, Y. P. and Bachetti, M. and Bakanov, A. V. and Bamford, S. P. and Barentsen, G. and Barmby, P. and Baumbach, A. and Berry, K. L. and Biscani, F. and Boquien, M. and Bostroem, K. A. and Bouma, L. G. and Brammer, G. B. and Bray, E. M. and Breytenbach, H. and Buddelmeijer, H. and Burke, D. J. and Calderone, G. and Cano Rodr{\'i}guez, J. L. and Cara, M. and Cardoso, J. V. M. and Cheedella, S. and Copin, Y. and Corrales, L. and Crichton, D. and D'Avella, D. and Deil, C. and Depagne, {\'E}. and Dietrich, J. P. and Donath, A. and Droettboom, M. and Earl, N. and Erben, T. and Fabbro, S. and Ferreira, L. A. and Finethy, T. and Fox, R. T. and Garrison, L. H. and Gibbons, S. L. J. and Goldstein, D. A. and Gommers, R. and Greco, J. P. and Greenfield, P. and Groener, A. M. and Grollier, F. and Hagen, A. and Hirst, P. and Homeier, D. and Horton, A. J. and Hosseinzadeh, G. and Hu, L. and Hunkeler, J. S. and Ivezi{\'c}, {\v Z}. and Jain, A. and Jenness, T. and Kanarek, G. and Kendrew, S. and Kern, N. S. and Kerzendorf, W. E. and Khvalko, A. and King, J. and Kirkby, D. and Kulkarni, A. M. and Kumar, A. and Lee, A. and Lenz, D. and Littlefair, S. P. and Ma, Z. and Macleod, D. M. and Mastropietro, M. and McCully, C. and Montagnac, S. and Morris, B. M. and Mueller, M. and Mumford, S. J. and Muna, D. and Murphy, N. A. and Nelson, S. and Nguyen, G. H. and Ninan, J. P. and N{\"o}the, M. and Ogaz, S. and Oh, S. and Parejko, J. K. and Parley, N. and Pascual, S. and Patil, R. and Patil, A. A. and Plunkett, A. L. and Prochaska, J. X. and Rastogi, T. and Reddy Janga, V. and Sabater, J. and Sakurikar, P. and Seifert, M. and Sherbert, L. E. and {Sherwood-Taylor}, H. and Shih, A. Y. and Sick, J. and Silbiger, M. T. and Singanamalla, S. and Singer, L. P. and Sladen, P. H. and Sooley, K. A. and Sornarajah, S. and Streicher, O. and Teuben, P. and Thomas, S. W. and Tremblay, G. R. and Turner, J. E. H. and Terr{\'o}n, V. and {van Kerkwijk}, M. H. and {de la Vega}, A. and Watkins, L. L. and Weaver, B. A. and Whitmore, J. B. and Woillez, J. and Zabalza, V. and {Astropy Contributors}}, + year = {2018}, + month = sep, + journal = {The Astronomical Journal}, + volume = {156}, + pages = {123}, + issn = {0004-6256}, + doi = {10.3847/1538-3881/aabc4f}, + abstract = {The Astropy Project supports and fosters the development of open-source and openly developed Python packages that provide commonly needed functionality to the astronomical community. A key element of the Astropy Project is the core package astropy, which serves as the foundation for more specialized projects and packages. In this article, we provide an overview of the organization of the Astropy project and summarize key features in the core package, as of the recent major release, version 2.0. We then describe the project infrastructure designed to facilitate and support development for a broader ecosystem of interoperable packages. We conclude with a future outlook of planned new features and directions for the broader Astropy Project. .}, + keywords = {Astrophysics - Instrumentation and Methods for Astrophysics,methods: data analysis,methods: miscellaneous,methods: statistical,reference systems}, + annotation = {ADS Bibcode: 2018AJ....156..123A}, + file = {/home/david/pdfs/Zotero/Astropy Collaboration et al_2018_The Astropy Project2.pdf} +} + + +@article{mirouh_etal22, + author = {{Mirouh}, Giovanni M. and {Hendriks}, David D. and {Dykes}, Sophie and {Moe}, Maxwell and {Izzard}, Robert G.}, + title = "{Detailed equilibrium and dynamical tides: impact on circularization and synchronization in open clusters}", + journal = {\mnras}, + year = "submitted", +} \ No newline at end of file diff --git a/papers/paper.crossref b/papers/paper.crossref new file mode 100644 index 000000000..2c8fae872 --- /dev/null +++ b/papers/paper.crossref @@ -0,0 +1,237 @@ +<?xml version="1.0" encoding="UTF-8"?> +<doi_batch xmlns="http://www.crossref.org/schema/5.3.1" + xmlns:ai="http://www.crossref.org/AccessIndicators.xsd" + xmlns:rel="http://www.crossref.org/relations.xsd" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + version="5.3.1" + xsi:schemaLocation="http://www.crossref.org/schema/5.3.1 http://www.crossref.org/schemas/crossref5.3.1.xsd"> + <head> + <doi_batch_id>20220720T094307-31c226c27c5bafd915ddd929fd270d6cd13f2bf3</doi_batch_id> + <timestamp>20220720094307</timestamp> + <depositor> + <depositor_name>JOSS Admin</depositor_name> + <email_address>admin@theoj.org</email_address> + </depositor> + <registrant>The Open Journal</registrant> + </head> + <body> + <journal> + <journal_metadata> + <full_title>Journal of Open Source Software</full_title> + <abbrev_title>JOSS</abbrev_title> + <issn media_type="electronic">2475-9066</issn> + <doi_data> + <doi>10.21105/joss</doi> + <resource>https://joss.theoj.org/</resource> + </doi_data> + </journal_metadata> + <journal_issue> + <publication_date media_type="online"> + <month>01</month> + <year>1970</year> + </publication_date> + <journal_volume> + <volume>¿VOL?</volume> + </journal_volume> + <issue>¿ISSUE?</issue> + </journal_issue> + <journal_article publication_type="full_text"> + <titles> + <title>binary_c-python: A python-based stellar population +synthesis tool and interface to binary_c</title> + </titles> + <contributors> + <person_name sequence="first" contributor_role="author"> + <given_name>D. D.</given_name> + <surname>Hendriks</surname> + <ORCID>https://orcid.org/0000-0002-8717-6046</ORCID> + </person_name> + <person_name sequence="additional" + contributor_role="author"> + <given_name>R. G.</given_name> + <surname>Izzard</surname> + <ORCID>https://orcid.org/0000-0003-0378-4843</ORCID> + </person_name> + </contributors> + <publication_date> + <month>01</month> + <day>01</day> + <year>1970</year> + </publication_date> + <pages> + <first_page>¿PAGE?</first_page> + </pages> + <publisher_item> + <identifier id_type="doi">N/A</identifier> + </publisher_item> + <ai:program name="AccessIndicators"> + <ai:license_ref applies_to="vor">http://creativecommons.org/licenses/by/4.0/</ai:license_ref> + <ai:license_ref applies_to="am">http://creativecommons.org/licenses/by/4.0/</ai:license_ref> + <ai:license_ref applies_to="tdm">http://creativecommons.org/licenses/by/4.0/</ai:license_ref> + </ai:program> + <rel:program> + <rel:related_item> + <rel:description>Software archive</rel:description> + <rel:inter_work_relation relationship-type="references" identifier-type="doi">10.5281</rel:inter_work_relation> + </rel:related_item> + <rel:related_item> + <rel:description>GitHub review issue</rel:description> + <rel:inter_work_relation relationship-type="hasReview" identifier-type="uri">https://github.com/openjournals</rel:inter_work_relation> + </rel:related_item> + </rel:program> + <doi_data> + <doi>N/A</doi> + <resource>https://joss.theoj.org/papers/N/A</resource> + <collection property="text-mining"> + <item> + <resource mime_type="application/pdf">https://joss.theoj.org/papers/N/A.pdf</resource> + </item> + </collection> + </doi_data> + <citation_list> + <citation key="izzardNewSyntheticModel2004"> + <article_title>A new synthetic model for asymptotic giant +branch stars</article_title> + <author>Izzard</author> + <journal_title>Monthly Notices of the Royal Astronomical +Society</journal_title> + <issue>2</issue> + <volume>350</volume> + <doi>10.1111/j.1365-2966.2004.07446.x</doi> + <issn>0035-8711</issn> + <cYear>2004</cYear> + <unstructured_citation>Izzard, R. G., Tout, C. A., Karakas, +A. I., & Pols, O. R. (2004). A new synthetic model for asymptotic +giant branch stars. Monthly Notices of the Royal Astronomical Society, +350(2), 407–426. +https://doi.org/10.1111/j.1365-2966.2004.07446.x</unstructured_citation> + </citation> + <citation key="izzardPopulationNucleosynthesisSingle2006"> + <article_title>Population nucleosynthesis in single and +binary stars - I. Model</article_title> + <author>Izzard</author> + <journal_title>Astronomy & Astrophysics</journal_title> + <issue>2</issue> + <volume>460</volume> + <doi>10.1051/0004-6361:20066129</doi> + <issn>0004-6361</issn> + <cYear>2006</cYear> + <unstructured_citation>Izzard, R. G., Dray, L. M., Karakas, +A. I., Lugaro, M., & Tout, C. A. (2006). Population nucleosynthesis +in single and binary stars - I. Model. Astronomy & Astrophysics, +460(2), 565–572. +https://doi.org/10.1051/0004-6361:20066129</unstructured_citation> + </citation> + <citation key="izzardPopulationSynthesisBinary2009"> + <article_title>Population synthesis of binary +carbon-enhanced metal-poor stars</article_title> + <author>Izzard</author> + <journal_title>Astronomy and Astrophysics</journal_title> + <issue>3</issue> + <volume>508</volume> + <doi>10.1051/0004-6361/200912827</doi> + <issn>0004-6361</issn> + <cYear>2009</cYear> + <unstructured_citation>Izzard, R. G., Glebbeek, E., +Stancliffe, R. J., & Pols, O. R. (2009). Population synthesis of +binary carbon-enhanced metal-poor stars. Astronomy and Astrophysics, +508(3), 1359–1374. +https://doi.org/10.1051/0004-6361/200912827</unstructured_citation> + </citation> + <citation key="izzardBinaryStarsGalactic2018"> + <article_title>Binary stars in the Galactic thick +disc</article_title> + <author>Izzard</author> + <journal_title>Monthly Notices of the Royal Astronomical +Society</journal_title> + <volume>473</volume> + <doi>10.1093/mnras/stx2355</doi> + <issn>0035-8711</issn> + <cYear>2018</cYear> + <unstructured_citation>Izzard, R. G., Preece, H., Jofre, P., +Halabi, G. M., Masseron, T., & Tout, C. A. (2018). Binary stars in +the Galactic thick disc. Monthly Notices of the Royal Astronomical +Society, 473, 2984–2999. +https://doi.org/10.1093/mnras/stx2355</unstructured_citation> + </citation> + <citation key="foreman-mackeyEmceeMCMCHammer2013"> + <article_title>Emcee: The MCMC Hammer</article_title> + <author>Foreman-Mackey</author> + <journal_title>Publications of the Astronomical Society of +the Pacific</journal_title> + <issue>925</issue> + <volume>125</volume> + <doi>10.1086/670067</doi> + <cYear>2013</cYear> + <unstructured_citation>Foreman-Mackey, D., Hogg, D. W., +Lang, D., & Goodman, J. (2013). Emcee: The MCMC Hammer. Publications +of the Astronomical Society of the Pacific, 125(925), 306–312. +https://doi.org/10.1086/670067</unstructured_citation> + </citation> + <citation key="speagleDynestyDynamicNested2020"> + <article_title>Dynesty: A dynamic nested sampling package +for estimating Bayesian posteriors and evidences</article_title> + <author>Speagle</author> + <journal_title>Monthly Notices of the Royal Astronomical +Society</journal_title> + <issue>3</issue> + <volume>493</volume> + <doi>10.1093/mnras/staa278</doi> + <issn>0035-8711</issn> + <cYear>2020</cYear> + <unstructured_citation>Speagle, J. S. (2020). Dynesty: A +dynamic nested sampling package for estimating Bayesian posteriors and +evidences. Monthly Notices of the Royal Astronomical Society, 493(3), +3132–3158. https://doi.org/10.1093/mnras/staa278</unstructured_citation> + </citation> + <citation key="astropycollaborationAstropyCommunityPython2013"> + <article_title>Astropy: A community Python package for +astronomy</article_title> + <author>Astropy Collaboration</author> + <journal_title>Astronomy and Astrophysics</journal_title> + <volume>558</volume> + <doi>10.1051/0004-6361/201322068</doi> + <issn>0004-6361</issn> + <cYear>2013</cYear> + <unstructured_citation>Astropy Collaboration, Robitaille, T. +P., Tollerud, E. J., Greenfield, P., Droettboom, M., Bray, E., Aldcroft, +T., Davis, M., Ginsburg, A., Price-Whelan, A. M., Kerzendorf, W. E., +Conley, A., Crighton, N., Barbary, K., Muna, D., Ferguson, H., Grollier, +F., Parikh, M. M., Nair, P. H., … Streicher, O. (2013). Astropy: A +community Python package for astronomy. Astronomy and Astrophysics, 558, +A33. https://doi.org/10.1051/0004-6361/201322068</unstructured_citation> + </citation> + <citation key="astropycollaborationAstropyProjectBuilding2018"> + <article_title>The Astropy Project: Building an Open-science +Project and Status of the v2.0 Core Package</article_title> + <author>Astropy Collaboration</author> + <journal_title>The Astronomical Journal</journal_title> + <volume>156</volume> + <doi>10.3847/1538-3881/aabc4f</doi> + <issn>0004-6256</issn> + <cYear>2018</cYear> + <unstructured_citation>Astropy Collaboration, Price-Whelan, +A. M., Sipőcz, B. M., Günther, H. M., Lim, P. L., Crawford, S. M., +Conseil, S., Shupe, D. L., Craig, M. W., Dencheva, N., Ginsburg, A., +VanderPlas, J. T., Bradley, L. D., Pérez-Suárez, D., de Val-Borro, M., +Aldcroft, T. L., Cruz, K. L., Robitaille, T. P., Tollerud, E. J., … +Astropy Contributors. (2018). The Astropy Project: Building an +Open-science Project and Status of the v2.0 Core Package. The +Astronomical Journal, 156, 123. +https://doi.org/10.3847/1538-3881/aabc4f</unstructured_citation> + </citation> + <citation key="mirouh_etal22"> + <article_title>Detailed equilibrium and dynamical tides: +impact on circularization and synchronization in open +clusters</article_title> + <author>Mirouh</author> + <unstructured_citation>Mirouh, G. M., Hendriks, D. D., +Dykes, S., Moe, M., & Izzard, R. G. (submitted). Detailed +equilibrium and dynamical tides: impact on circularization and +synchronization in open clusters.</unstructured_citation> + </citation> + </citation_list> + </journal_article> + </journal> + </body> +</doi_batch> diff --git a/papers/paper.md b/papers/paper.md new file mode 100644 index 000000000..b31a8c1fc --- /dev/null +++ b/papers/paper.md @@ -0,0 +1,135 @@ +--- +title: '[binary\_c-python]{.smallcaps}: A python-based stellar population synthesis tool and interface to [binary\_c]{.smallcaps}' +tags: + - Python + - astronomy +authors: + - name: D. D. Hendriks[^1] + orcid: 0000-0002-8717-6046 + affiliation: 1 + - name: R. G. Izzard + orcid: 0000-0003-0378-4843 + affiliation: 1 +affiliations: + - name: Department of Physics, University of Surrey, Guildford, GU2 7XH, Surrey, UK + index: 1 +date: 18 June 2022 +bibliography: paper.bib +--- + +Summary {#sec:summary} +======= + +We present our package +[[binary\_c-python]{.smallcaps}](https://ri0005.pages.surrey.ac.uk/binary_c-python/), +which is aimed to provide a convenient and easy-to-use interface to the +[[binary\_c]{.smallcaps}](http://personal.ph.surrey.ac.uk/~ri0005/doc/binary_c/binary_c.html) [@izzardNewSyntheticModel2004; @izzardPopulationNucleosynthesisSingle2006; @izzardPopulationSynthesisBinary2009; @izzardBinaryStarsGalactic2018] +framework, allowing the user to rapidly evolve individual systems and +populations of stars. [binary\_c-python]{.smallcaps} is available on +[Pip](https://pypi.org/project/binarycpython/) and on +[Gitlab](https://gitlab.com/binary_c/binary_c-python). + +The user can control output from [binary\_c]{.smallcaps} by providing +[binary\_c-python]{.smallcaps} with logging statements that are +dynamically compiled and loaded into [binary\_c]{.smallcaps}. +[binary\_c-python]{.smallcaps} uses multiprocessing to utilise all the +cores on a particular machine, and can run populations with HPC cluster +workload managers like [HTCondor]{.smallcaps} and [Slurm]{.smallcaps}, +allowing the user to run simulations on very large computing clusters. + +[binary\_c-python]{.smallcaps} is easily interfaced or integrated with +other Python-based codes and libraries, e.g. sampling codes like +[Emcee]{.smallcaps} or [Dynesty]{.smallcaps}, or the astrophysics +oriented package +[Astropy]{.smallcaps} [@astropycollaborationAstropyCommunityPython2013; @foreman-mackeyEmceeMCMCHammer2013; @astropycollaborationAstropyProjectBuilding2018; @speagleDynestyDynamicNested2020]. +Moreover, it is possible to provide custom system-generating functions +through our function hooks, allowing third-party packages to manage the +properties of the stars in the populations and evolve them through +[binary\_c-python]{.smallcaps}. + +Recent developments in [binary\_c]{.smallcaps} include standardised +output datasets called *ensembles*. +[binary\_c-python]{.smallcaps} easily processes these datasets and +provides a suite of utility functions to handle them. Furthermore, +[binary\_c]{.smallcaps} now includes the *ensemble-manager* class, which +makes use of the core functions and classes of +[binary\_c-python]{.smallcaps} to evolve a grid of stellar populations +with varying input physics, allowing for large, automated parameter +studies through a single interface. + +We provide +[documentation](https://ri0005.pages.surrey.ac.uk/binary_c-python/index.html) +that is automatically generated based on docstrings and a suite of +[Jupyter]{.smallcaps} +[notebooks](https://ri0005.pages.surrey.ac.uk/binary_c-python/example_notebooks.html). +These notebooks consist of technical tutorials on how to use +[binary\_c-python]{.smallcaps}, and use-case scenarios aimed at doing +science. Much of [binary\_c-python]{.smallcaps} is covered by unit tests +to ensure reliability and correctness, and the test coverage is +continually increased as the package is being improved. + +Statement of need {#sec:statement} +================= + +In the current scientific climate [Python]{.smallcaps} is ubiquitous, +and while lower-level codes written in, e.g., [Fortran]{.smallcaps} or +[C]{.smallcaps} are still widely used, much of the newer software is +written in [Python]{.smallcaps}, either entirely or as a wrapper around +other codes and libraries. Education in programming also often includes +[Python]{.smallcaps} courses because of its ease of use and its +flexibility. Moreover, [Python]{.smallcaps} has a large community with +many resources and tutorials. We have created +[binary\_c-python]{.smallcaps} to allow students and scientists alike to +explore current scientific issues while enjoying the familiar syntax, +and at the same time make use of the plentiful scientific and +astrophysical packages like [Numpy]{.smallcaps}, [Scipy]{.smallcaps}, +[Pandas]{.smallcaps}, [Astropy]{.smallcaps} and platforms like +[Jupyter]{.smallcaps}. + +Earlier versions of [binary\_c-python]{.smallcaps} were written in Perl, +where much of the logic and structure were developed and debugged. This +made porting to [Python]{.smallcaps} relatively easy. + +Projects that use [binary\_c-python]{.smallcaps} {#sec:projects} +================================================ + +[binary\_c-python]{.smallcaps} has already been used in a variety of +situations, ranging from pure research to educational purposes, as well +as in outreach events. In the summer of 2021 we used +[binary\_c-python]{.smallcaps} as the basis for the interactive classes +on stellar ecosystems during the [International Max-Planck Research +School summer school 2021 in +Heidelberg](https://www2.mpia-hd.mpg.de/imprs-hd/SummerSchools/2021/), +where students were introduced to the topic of population synthesis and +were able to use our notebooks to perform their own calculations. +[binary\_c-python]{.smallcaps} has been used in @mirouh_etal22, where +improvements to tidal interactions between stars were implemented, and +initial birth parameter distributions were varied to match to observed +binary systems in star clusters. A Master's thesis project, aimed at +finding the birth system parameters of the V106 stellar system, +comparing observations to results of [binary\_c]{.smallcaps} and +calculating the maximum likelihood with Bayesian inference through +Markov chain Monte Carlo sampling. The project made use of +[binary\_c-python]{.smallcaps} and the [Emcee]{.smallcaps} package. + +Currently [binary\_c-python]{.smallcaps} is used in several ongoing +projects that study the effect of birth distributions on the occurrence +of carbon-enhanced metal-poor (CEMP) stars, the occurrence and +properties of accretion disks in main-sequence stars and the predicted +observable black hole distribution by combining star formation and +metallicity distributions with the output of [binary\_c]{.smallcaps}. +Moreover, we use the *ensemble* output structure to generate datasets +for galactic chemical evolution on cosmological timescales, where we +rely heavily on the utilities of [binary\_c-python]{.smallcaps}. + +Acknowledgements {#sec:orgf6f5520} +================ + +We acknowledge the helpful discussions and early testing efforts from M. +Delorme, G. Mirouh, and D. Tracey, and the early work of J. Andrews +which inspired our Python-C interface code. DDH thanks the UKRI/UoS for +the funding grant H120341A. RGI thanks STFC for funding grants +[ST/R000603/1](https://gtr.ukri.org/projects?ref=ST%2FR000603%2F1) and +[ST/L003910/2](https://gtr.ukri.org/projects?ref=ST/L003910/2). + +[^1]: E-mail: <dh00601@surrey.ac.uk> (DDH) -- GitLab