Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[REVIEW]: Halotools: A New Release Adding Intrinsic Alignments to Halo Based Methods #7421

Open
editorialbot opened this issue Nov 4, 2024 · 56 comments
Assignees
Labels
Cython Python review TeX Track: 1 (AASS) Astronomy, Astrophysics, and Space Sciences

Comments

@editorialbot
Copy link
Collaborator

editorialbot commented Nov 4, 2024

Submitting author: @nvanalfen (Nicholas Van Alfen)
Repository: https://github.com/nvanalfen/halotools
Branch with paper.md (empty if default branch): paper
Version: v0.9
Editor: @ivastar
Reviewers: @matroxel, @cmlamman, @fjcastander
Archive: Pending

Status

status

Status badge code:

HTML: <a href="https://joss.theoj.org/papers/e3768941d02ae5749fd764e77c8d9852"><img src="https://joss.theoj.org/papers/e3768941d02ae5749fd764e77c8d9852/status.svg"></a>
Markdown: [![status](https://joss.theoj.org/papers/e3768941d02ae5749fd764e77c8d9852/status.svg)](https://joss.theoj.org/papers/e3768941d02ae5749fd764e77c8d9852)

Reviewers and authors:

Please avoid lengthy details of difficulties in the review thread. Instead, please create a new issue in the target repository and link to those issues (especially acceptance-blockers) by leaving comments in the review thread below. (For completists: if the target issue tracker is also on GitHub, linking the review thread in the issue or vice versa will create corresponding breadcrumb trails in the link target.)

Reviewer instructions & questions

@matroxel & @cmlamman, your review will be checklist based. Each of you will have a separate checklist that you should update when carrying out your review.
First of all you need to run this command in a separate comment to create the checklist:

@editorialbot generate my checklist

The reviewer guidelines are available here: https://joss.readthedocs.io/en/latest/reviewer_guidelines.html. Any questions/concerns please let @ivastar know.

Please start on your review when you are able, and be sure to complete your review in the next six weeks, at the very latest

Checklists

📝 Checklist for @cmlamman

📝 Checklist for @matroxel

@editorialbot editorialbot added Cython Python review TeX Track: 1 (AASS) Astronomy, Astrophysics, and Space Sciences labels Nov 4, 2024
@editorialbot
Copy link
Collaborator Author

Hello humans, I'm @editorialbot, a robot that can help you with some common editorial tasks.

For a list of things I can do to help you, just type:

@editorialbot commands

For example, to regenerate the paper pdf after making changes in the paper's md or bib files, type:

@editorialbot generate pdf

@editorialbot
Copy link
Collaborator Author

Reference check summary (note 'MISSING' DOIs are suggestions that need verification):

✅ OK DOIs

- 10.33232/001c.118783 is OK
- 10.1088/0004-637X/762/2/109 is OK
- 10.1093/mnras/stv2036 is OK
- 10.3847/1538-4365/ab1658 is OK
- 10.1088/0004-637X/763/1/18 is OK
- 10.1086/305262 is OK
- 10.1093/mnras/stw439 is OK
- 10.1093/mnras/stw248 is OK
- 10.1093/mnras/stt1403 is OK
- 10.1111/j.1365-2966.2011.18858.x is OK
- 10.1086/313015 is OK
- 10.1111/j.1365-2966.2005.09655.x is OK
- 10.1086/521074 is OK
- 10.1086/670067 is OK
- 10.3847/1538-3881/aa859f is OK
- 10.1093/mnras/staa3802 is OK
- 10.3847/1538-4357/ab042c is OK
- 10.2307/2333824 is OK
- 10.1093/mnras/stt1618 is OK
- 10.1088/1475-7516/2011/05/010 is OK
- 10.1103/PhysRevD.100.103506 is OK
- 10.1088/1367-2630/9/12/444 is OK
- 10.1103/PhysRevD.70.063526 is OK
- 10.1111/j.1365-2966.2009.15956.x is OK
- 10.1111/j.1365-2966.2005.09946.x is OK
- 10.1093/mnras/stac2083 is OK
- 10.1051/0004-6361:20066170 is OK
- 10.1051/0004-6361/202141938 is OK
- 10.3847/1538-4357/ab042c is OK
- 10.1086/341065 is OK
- 10.1088/1475-7516/2012/05/030 is OK
- 10.1093/mnras/stad2013 is OK
- 10.1103/PhysRevD.106.123510 is OK
- 10.1093/mnras/stab3222 is OK
- 10.1016/j.jmva.2012.08.010 is OK
- 10.1093/mnras/staa3388 is OK
- 10.1093/mnras/stx2956 is OK
- 10.48550/arXiv.2210.10068 is OK
- 10.1093/mnras/stx3349 is OK
- 10.1093/mnras/sty495 is OK
- 10.1093/mnras/stab1170 is OK
- 10.1093/mnras/stad473 is OK
- 10.1093/mnras/stac042 is OK
- 10.1093/mnras/stab3355 is OK
- 10.1093/mnras/stab1623 is OK
- 10.1093/mnras/stz2458 is OK
- 10.1093/mnras/sts006 is OK
- 10.1093/mnras/stw840 is OK
- 10.1093/mnras/staa623 is OK
- 10.1093/mnras/stz3442 is OK
- 10.1093/mnras/sty1089 is OK
- 10.1086/304888 is OK
- 10.1046/j.1365-8711.2003.06254.x is OK
- 10.1086/376517 is OK
- 10.1093/mnras/stw1705 is OK
- 10.1093/mnras/stx1828 is OK
- 10.1086/172900 is OK
- 10.3847/1538-4357/aafe11 is OK
- 10.1093/mnras/stx3040 is OK
- 10.1093/mnras/stx3112 is OK
- 10.1093/mnras/sty618 is OK
- 10.1093/mnras/stx3304 is OK
- 10.1093/mnras/sty2206 is OK
- 10.1093/mnras/stac1858 is OK
- 10.1093/mnras/stab748 is OK
- 10.1111/j.1365-2966.2006.10705.x is OK
- 10.1051/0004-6361/201322068 is OK
- 10.3847/1538-3881/aabc4f is OK
- 10.3847/1538-4357/ac7c74 is OK
- 10.1088/1475-7516/2015/08/015 is OK
- 10.1093/mnras/stv2615 is OK
- 10.1088/0004-637X/740/2/102 is OK
- 10.1093/mnras/stz3114 is OK
- 10.2172/1420403 is OK
- 10.1103/PhysRevD.105.023515 is OK
- 10.1088/1475-7516/2013/12/029 is OK
- 10.1103/PhysRevD.108.123518 is OK
- 10.1103/PhysRevD.105.023520 is OK
- 10.1051/0004-6361/202039063 is OK

🟡 SKIP DOIs

- No DOI given, and none found for title: The Wide Field Infrared Survey Telescope: 100 Hubb...
- No DOI given, and none found for title: Towards Physical Understanding of Galaxy-Halo Alig...
- No DOI given, and none found for title: halotools: A New Release Adding Intrinsic Alignmen...

❌ MISSING DOIs

- None

❌ INVALID DOIs

- None

@editorialbot
Copy link
Collaborator Author

Software report:

github.com/AlDanial/cloc v 1.90  T=0.64 s (1024.5 files/s, 189108.9 lines/s)
-------------------------------------------------------------------------------
Language                     files          blank        comment           code
-------------------------------------------------------------------------------
Python                         442          17632          25320          44591
reStructuredText               116           3796           2220           6163
Cython                          54           1948           2157           5598
TeX                              1            112              0           1258
Jupyter Notebook                29              0           8786            966
YAML                             6             28             22            179
DOS Batch                        1             21              1            148
Markdown                         5             79              0            114
make                             1             22              5            107
TOML                             1             10              8             74
INI                              1             12              0             72
CSS                              1              1              0              4
-------------------------------------------------------------------------------
SUM:                           658          23661          38519          59274
-------------------------------------------------------------------------------

Commit count by author:

  3904	Andrew Hearin
   444	Duncan Campbell
    72	Erik Tollerud
    47	Brigitta Sipocz
    47	Christopher Bradshaw
    46	Nick Van Alfen
    42	Thomas Robitaille
    14	Michael Droettboom
    13	Andrew Zentner
    10	Erik M. Bray
     9	Johannes Lange
     7	Yu Feng
     6	EiffL
     6	P. L. Lim
     6	Sean McLaughlin
     6	johannesulf
     5	Benedikt Diemer
     5	Yao-Yuan Mao
     5	sean
     4	Kyle Barbary
     4	Larry Bradley
     4	Matthew Craig
     4	Surhud More
     3	Christoph Deil
     3	Haojie Xu
     3	Manodeep Sinha
     2	Alan Pearl
     2	Clément Robert
     2	Johannes U. Lange
     2	Kevin Tan
     2	Matt Craig
     2	Nick Hand
     2	Wolfgang Kerzendorf
     1	Benjamin Alan Weaver
     1	Matthew R Becker
     1	Nels Beckman
     1	Pey Lian Lim
     1	Pey Lian Lim (Github)
     1	Shulei Cao
     1	Syrtis Major
     1	Tom McClintock
     1	alexieleauthaud
     1	dependabot[bot]
     1	hamogu
     1	kilianbreathnach
     1	larrybradley
     1	mclaughlin6464

@editorialbot
Copy link
Collaborator Author

Paper file info:

📄 Wordcount for paper.md is 1211

✅ The paper includes a Statement of need section

@editorialbot
Copy link
Collaborator Author

License info:

🔴 Failed to discover a valid open source license

@editorialbot
Copy link
Collaborator Author

👉📄 Download article proof 📄 View article proof on GitHub 📄 👈

@ivastar
Copy link

ivastar commented Nov 4, 2024

@matroxel, @cmlamman welcome to the review issue! We are looking for a review in 3-4 weeks. It would be great if we can aim for the end of November. For instructions on generating the review checklist, see the top of this issue.

This review is for contributions to halotools made by @nvanalfen. We are not reviewing the full library because that is already published, but just these specific contributions. I'm pasting here Nick's note from the pre-review issue:

"The short version is that all commits made by me @.***) are part of
the review. It's hard to pin down a single piece, as Andrew was making
changes and bug fixes to the official version while I was working on this
and we had to iterate a little in the end to merge things. Here's
nvanalfen/halotools@18e9b59
the link to the latest commit I made on the material for this paper/work
(commit 18e9b59). And this
nvanalfen/halotools@17422b8
is the commit right before my first contribution (commit 17422b8). If that
comparison is sufficient (the version before I committed anything vs the
version upon my last commit), here
https://github.com/nvanalfen/halotools/compare/17422b8..18e9b59 is the
link to that git diff."

If you have any questions, don't hesitate to tag me here or send me an email.

@ivastar
Copy link

ivastar commented Nov 4, 2024

@editorialbot add @fjcastander as reviewer

@editorialbot
Copy link
Collaborator Author

@fjcastander added to the reviewers list!

@ivastar
Copy link

ivastar commented Nov 4, 2024

License info:

🔴 Failed to discover a valid open source license

@@nvanalfen, I see that the license is basically a BSD 3-clause, but done in a non-standard way. Do you think it would be possible to refactor it to a standard BSD 3-clause? Also tagging @aphearin.

@aphearin
Copy link

aphearin commented Nov 4, 2024

Happy to refactor @ivastar - any templates I should look at?

@ivastar
Copy link

ivastar commented Nov 5, 2024

Happy to refactor @ivastar - any templates I should look at?

astropy/halotools#1105 should do it. And then @nvanalfen can pull to his fork to bring the changes over.

@nvanalfen
Copy link

@ivastar I have synced my fork to include these changes. Thank you both of you!

@cmlamman
Copy link

cmlamman commented Nov 20, 2024

Review checklist for @cmlamman

Conflict of interest

  • I confirm that I have read the JOSS conflict of interest (COI) policy and that: I have no COIs with reviewing this work or that any perceived COIs have been waived by JOSS for the purpose of this review.

Code of Conduct

General checks

  • Repository: Is the source code for this software available at the https://github.com/nvanalfen/halotools?
  • License: Does the repository contain a plain-text LICENSE or COPYING file with the contents of an OSI approved software license?
  • Contribution and authorship: Has the submitting author (@nvanalfen) made major contributions to the software? Does the full list of paper authors seem appropriate and complete?
  • Substantial scholarly effort: Does this submission meet the scope eligibility described in the JOSS guidelines
  • Data sharing: If the paper contains original data, data are accessible to the reviewers. If the paper contains no original data, please check this item.
  • Reproducibility: If the paper contains original results, results are entirely reproducible by reviewers. If the paper contains no original results, please check this item.
  • Human and animal research: If the paper contains original data research on humans subjects or animals, does it comply with JOSS's human participants research policy and/or animal research policy? If the paper contains no such data, please check this item.

Functionality

  • Installation: Does installation proceed as outlined in the documentation?
  • Functionality: Have the functional claims of the software been confirmed?
  • Performance: If there are any performance claims of the software, have they been confirmed? (If there are no claims, please check off this item.)

Documentation

  • A statement of need: Do the authors clearly state what problems the software is designed to solve and who the target audience is?
  • Installation instructions: Is there a clearly-stated list of dependencies? Ideally these should be handled with an automated package management solution.
  • Example usage: Do the authors include examples of how to use the software (ideally to solve real-world analysis problems).
  • Functionality documentation: Is the core functionality of the software documented to a satisfactory level (e.g., API method documentation)?
  • Automated tests: Are there automated tests or manual steps described so that the functionality of the software can be verified?
  • Community guidelines: Are there clear guidelines for third parties wishing to 1. Contribute to the software 2. Report issues or problems with the software 3. Seek support

Software paper

  • Summary: Has a clear description of the high-level functionality and purpose of the software for a diverse, non-specialist audience been provided?
  • A statement of need: Does the paper have a section titled 'Statement of need' that clearly states what problems the software is designed to solve, who the target audience is, and its relation to other work?
  • State of the field: Do the authors describe how this software compares to other commonly-used packages?
  • Quality of writing: Is the paper well written (i.e., it does not require editing for structure, language, or writing quality)?
  • References: Is the list of references complete, and is everything cited appropriately that should be cited (e.g., papers, datasets, software)? Do references in the text use the proper citation syntax?

@cmlamman
Copy link

@nvanalfen I'm having a problem with reproducing the IA tutorials: nvanalfen/halotools#9 (comment)

@cmlamman
Copy link

cmlamman commented Dec 2, 2024

Thanks for your patience @nvanalfen on the above issue - I will reinstall everything in a fresh environment as soon as I get a chance.
What timeline is acceptable to finish the JOSS review? ( @ivastar )
I will be traveling the next two weeks so I will have very limited time until December 16.

@ivastar
Copy link

ivastar commented Dec 5, 2024

Thanks for your patience @nvanalfen on the above issue - I will reinstall everything in a fresh environment as soon as I get a chance. What timeline is acceptable to finish the JOSS review? ( @ivastar ) I will be traveling the next two weeks so I will have very limited time until December 16.

Yes, that's fine. As long as we are making progress.

@ivastar
Copy link

ivastar commented Dec 5, 2024

@matroxel, pinging you about this review. Please let me know if you are encountering issues.

@fjcastander, I added you as an optional reviewer. You are welcome to generate the review list as instructed at the top and only review parts that align with your expertise.

@matroxel
Copy link

matroxel commented Dec 18, 2024

Review checklist for @matroxel

Conflict of interest

  • I confirm that I have read the JOSS conflict of interest (COI) policy and that: I have no COIs with reviewing this work or that any perceived COIs have been waived by JOSS for the purpose of this review.

Code of Conduct

General checks

  • Repository: Is the source code for this software available at the https://github.com/nvanalfen/halotools?
  • License: Does the repository contain a plain-text LICENSE or COPYING file with the contents of an OSI approved software license?
  • Contribution and authorship: Has the submitting author (@nvanalfen) made major contributions to the software? Does the full list of paper authors seem appropriate and complete?
  • Substantial scholarly effort: Does this submission meet the scope eligibility described in the JOSS guidelines
  • Data sharing: If the paper contains original data, data are accessible to the reviewers. If the paper contains no original data, please check this item.
  • Reproducibility: If the paper contains original results, results are entirely reproducible by reviewers. If the paper contains no original results, please check this item.
  • Human and animal research: If the paper contains original data research on humans subjects or animals, does it comply with JOSS's human participants research policy and/or animal research policy? If the paper contains no such data, please check this item.

Functionality

  • Installation: Does installation proceed as outlined in the documentation?
  • Functionality: Have the functional claims of the software been confirmed?
  • Performance: If there are any performance claims of the software, have they been confirmed? (If there are no claims, please check off this item.)

Documentation

  • A statement of need: Do the authors clearly state what problems the software is designed to solve and who the target audience is?
  • Installation instructions: Is there a clearly-stated list of dependencies? Ideally these should be handled with an automated package management solution.
  • Example usage: Do the authors include examples of how to use the software (ideally to solve real-world analysis problems).
  • Functionality documentation: Is the core functionality of the software documented to a satisfactory level (e.g., API method documentation)?
  • Automated tests: Are there automated tests or manual steps described so that the functionality of the software can be verified?
  • Community guidelines: Are there clear guidelines for third parties wishing to 1. Contribute to the software 2. Report issues or problems with the software 3. Seek support

Software paper

  • Summary: Has a clear description of the high-level functionality and purpose of the software for a diverse, non-specialist audience been provided?
  • A statement of need: Does the paper have a section titled 'Statement of need' that clearly states what problems the software is designed to solve, who the target audience is, and its relation to other work?
  • State of the field: Do the authors describe how this software compares to other commonly-used packages?
  • Quality of writing: Is the paper well written (i.e., it does not require editing for structure, language, or writing quality)?
  • References: Is the list of references complete, and is everything cited appropriately that should be cited (e.g., papers, datasets, software)? Do references in the text use the proper citation syntax?

@matroxel
Copy link

I'm happy to approve - I suggested a very minor documentation fix in the open issue related to required python version for the environment, which should be addressed. I did not run into the issues @cmlamman did with running the suggested examples.

@ivastar
Copy link

ivastar commented Dec 19, 2024

Thank you for the review @matroxel!

@cmlamman
Copy link

@ivastar I've completed my review!
The minor instillation issues (nvanalfen/halotools#9) are more relevant to the full halotools library and did not prevent me from testing @nvanalfen 's additions.

@ivastar
Copy link

ivastar commented Dec 22, 2024

@cmlamman thank you! Can you please formally accept for publication?

@ivastar
Copy link

ivastar commented Jan 20, 2025

@editorialbot generate pdf

@ivastar
Copy link

ivastar commented Jan 20, 2025

@editorialbot check references

@ivastar
Copy link

ivastar commented Jan 20, 2025

@editorialbot check repository

@editorialbot
Copy link
Collaborator Author

Reference check summary (note 'MISSING' DOIs are suggestions that need verification):

✅ OK DOIs

- 10.33232/001c.118783 is OK
- 10.1088/0004-637X/762/2/109 is OK
- 10.1093/mnras/stv2036 is OK
- 10.3847/1538-4365/ab1658 is OK
- 10.1088/0004-637X/763/1/18 is OK
- 10.1086/305262 is OK
- 10.1093/mnras/stw439 is OK
- 10.1093/mnras/stw248 is OK
- 10.1093/mnras/stt1403 is OK
- 10.1111/j.1365-2966.2011.18858.x is OK
- 10.1086/313015 is OK
- 10.1111/j.1365-2966.2005.09655.x is OK
- 10.1086/521074 is OK
- 10.1086/670067 is OK
- 10.3847/1538-3881/aa859f is OK
- 10.1093/mnras/staa3802 is OK
- 10.3847/1538-4357/ab042c is OK
- 10.2307/2333824 is OK
- 10.1093/mnras/stt1618 is OK
- 10.1088/1475-7516/2011/05/010 is OK
- 10.1103/PhysRevD.100.103506 is OK
- 10.1088/1367-2630/9/12/444 is OK
- 10.1103/PhysRevD.70.063526 is OK
- 10.1111/j.1365-2966.2009.15956.x is OK
- 10.1111/j.1365-2966.2005.09946.x is OK
- 10.1093/mnras/stac2083 is OK
- 10.1051/0004-6361:20066170 is OK
- 10.1051/0004-6361/202141938 is OK
- 10.3847/1538-4357/ab042c is OK
- 10.1086/341065 is OK
- 10.1088/1475-7516/2012/05/030 is OK
- 10.1093/mnras/stad2013 is OK
- 10.1103/PhysRevD.106.123510 is OK
- 10.1093/mnras/stab3222 is OK
- 10.1016/j.jmva.2012.08.010 is OK
- 10.1093/mnras/staa3388 is OK
- 10.1093/mnras/stx2956 is OK
- 10.48550/arXiv.2210.10068 is OK
- 10.1093/mnras/stx3349 is OK
- 10.1093/mnras/sty495 is OK
- 10.1093/mnras/stab1170 is OK
- 10.1093/mnras/stad473 is OK
- 10.1093/mnras/stac042 is OK
- 10.1093/mnras/stab3355 is OK
- 10.1093/mnras/stab1623 is OK
- 10.1093/mnras/stz2458 is OK
- 10.1093/mnras/sts006 is OK
- 10.1093/mnras/stw840 is OK
- 10.1093/mnras/staa623 is OK
- 10.1093/mnras/stz3442 is OK
- 10.1093/mnras/sty1089 is OK
- 10.1086/304888 is OK
- 10.1046/j.1365-8711.2003.06254.x is OK
- 10.1086/376517 is OK
- 10.1093/mnras/stw1705 is OK
- 10.1093/mnras/stx1828 is OK
- 10.1086/172900 is OK
- 10.3847/1538-4357/aafe11 is OK
- 10.1093/mnras/stx3040 is OK
- 10.1093/mnras/stx3112 is OK
- 10.1093/mnras/sty618 is OK
- 10.1093/mnras/stx3304 is OK
- 10.1093/mnras/sty2206 is OK
- 10.1093/mnras/stac1858 is OK
- 10.1093/mnras/stab748 is OK
- 10.1111/j.1365-2966.2006.10705.x is OK
- 10.1051/0004-6361/201322068 is OK
- 10.3847/1538-3881/aabc4f is OK
- 10.3847/1538-4357/ac7c74 is OK
- 10.1088/1475-7516/2015/08/015 is OK
- 10.1093/mnras/stv2615 is OK
- 10.1088/0004-637X/740/2/102 is OK
- 10.1093/mnras/stz3114 is OK
- 10.2172/1420403 is OK
- 10.1103/PhysRevD.105.023515 is OK
- 10.1088/1475-7516/2013/12/029 is OK
- 10.1103/PhysRevD.108.123518 is OK
- 10.1103/PhysRevD.105.023520 is OK
- 10.1051/0004-6361/202039063 is OK

🟡 SKIP DOIs

- No DOI given, and none found for title: The Wide Field Infrared Survey Telescope: 100 Hubb...
- No DOI given, and none found for title: Towards Physical Understanding of Galaxy-Halo Alig...
- No DOI given, and none found for title: halotools: A New Release Adding Intrinsic Alignmen...

❌ MISSING DOIs

- None

❌ INVALID DOIs

- None

@editorialbot
Copy link
Collaborator Author

Software report:

github.com/AlDanial/cloc v 1.98  T=0.69 s (949.9 files/s, 175592.6 lines/s)
-------------------------------------------------------------------------------
Language                     files          blank        comment           code
-------------------------------------------------------------------------------
Python                         442          17632          25320          44591
reStructuredText               114           3790           2220           6147
Cython                          54           1948           2157           5598
TeX                              1            112              0           1258
Jupyter Notebook                29              0           8786            966
YAML                             6             28             22            179
DOS Batch                        1             21              1            148
Markdown                         5             79              0            114
make                             1             22              5            107
TOML                             1             10              8             78
INI                              1             12              0             72
Text                             1              0              0              7
CSS                              1              1              0              4
-------------------------------------------------------------------------------
SUM:                           657          23655          38519          59269
-------------------------------------------------------------------------------

Commit count by author:

  3904	Andrew Hearin
   444	Duncan Campbell
    72	Erik Tollerud
    47	Brigitta Sipocz
    47	Christopher Bradshaw
    46	Nick Van Alfen
    42	Thomas Robitaille
    14	Michael Droettboom
    13	Andrew Zentner
    10	Erik M. Bray
     9	Johannes Lange
     7	P. L. Lim
     7	Yu Feng
     6	EiffL
     6	Sean McLaughlin
     6	johannesulf
     5	Benedikt Diemer
     5	Yao-Yuan Mao
     5	sean
     4	Kyle Barbary
     4	Larry Bradley
     4	Matthew Craig
     4	Surhud More
     3	Christoph Deil
     3	Haojie Xu
     3	Iva Momcheva
     3	Manodeep Sinha
     3	dependabot[bot]
     2	Alan Pearl
     2	Clément Robert
     2	Johannes U. Lange
     2	Kevin Tan
     2	Matt Craig
     2	Nick Hand
     2	Wolfgang Kerzendorf
     1	Benjamin Alan Weaver
     1	Matthew R Becker
     1	Nels Beckman
     1	Pey Lian Lim
     1	Pey Lian Lim (Github)
     1	Shulei Cao
     1	Syrtis Major
     1	Tom McClintock
     1	alexieleauthaud
     1	hamogu
     1	kilianbreathnach
     1	larrybradley
     1	mclaughlin6464

@editorialbot
Copy link
Collaborator Author

Paper file info:

⚠️ Wordcount for paper.md is 1211

✅ The paper includes a Statement of need section

@editorialbot
Copy link
Collaborator Author

License info:

✅ License found: BSD 3-Clause "New" or "Revised" License (Valid open source OSI approved license)

@editorialbot
Copy link
Collaborator Author

👉📄 Download article proof 📄 View article proof on GitHub 📄 👈

@ivastar
Copy link

ivastar commented Jan 20, 2025

@nvanalfen Below is a round of editorial notes, please implement if possible.

Also, please trim your BIB file to only the references used in the paper, our checker checks all references, not just the ones used, which results also in the flagging of the references without DOIs (which are actually not used).

In the remaining references, please replace shortcuts such as \apj and \aj with the full name of the journal. If there are any arXiv references, please check if you can replace them with proper journal references.

Let me know if you have any questions.

Let me know when that's complete and I'll move to the post-review tasks.

Line 10: initially release --> originally published
Line 13: that --> which
Line 15: was --> is
Line 18: As such --> as a result
Line 22: Following --> According to
Line 23: may --> can ; with --> to
Line 24: tidal field), an effect known as --> tidal field). This effect is known as
Line 25: alignments --> alignment
Line 28: effect to --> effect on
Line 32: universe --> Universe (if it's meant to refer to our existing Universe that is)
Line 33: As such --> Therefore ; modeling this --> modeling of this
Line 34: surveys like --> surveys such as
Line 40: and a probe --> and is a probe
Line 43: allows for the possibility of using halotools --> allows halotools to be used
Line 54: "generating a catalog that can be used for modeling" remove or edit so it is connected to the prior sentence
Line 54-55: "This release provides a simple way to include component models to describe galaxy alignment, including IA similarly to how other features more typical of HOD models are defined." --> This release provides methods to describe galaxy alignment, including IA similarity, analogous to how other features in HOD models are defined.
Line 58: replace "-" with "," or add spaces around the dashes
Line 60: expands --> extends
Line 70: model halotools generates --> models generated by halotols
Line 75: "Currently, to build a mock galaxy catalog using halotools with IA, the user needs to provide one of each of the following (with optional components in parentheses):" --> Currently, the user needs to provide the following in order to build a mock galaxy catalog with IA using halotools (optional components are in parentheses):
Line 80: aligning with --> aligning it with
Line 84: galaxy its own --> galaxy to have its own
Line 85: all galaxies a single alignment strength --> a single alignment strength to all galaxies
Line 90: expand --> extend

@nvanalfen
Copy link

@ivastar Sorry for that and thank you for the clear list. Here's my summary of changes:

  • Trimmed the BIB file to only references used (I tried to be very careful here, but please let me know if I have messed anything up in the rendered file).
  • Replaced shortened journal references with the full journal name.
  • I believe all remaining references are from the full journal, not arXiv, but please let me know if you see anything.
  • I have made all (but one) of the suggested changes

For the one change I haven't (yet) made:

Line 33: As such --> Therefore ; modeling this --> modeling of this

I have made the first change ("as such" -> "therefore"), but for the second (assuming I'm looking at the right spot), the current sentence is:

“...accurately modeling this effect is important…”

The suggested change only altered "modeling this" to "modeling of this". I wasn't sure if you saw "accurately modeling this" as "accurate modeling this", so I have left it as is for now. If you feel that the full change
"...accurately modeling this..." to "...accurate modeling of this..." flows better, I will go right ahead and do that.

Thank you so much for all your time and hard work.

@ivastar
Copy link

ivastar commented Jan 21, 2025

@editorialbot generate pdf

@ivastar
Copy link

ivastar commented Jan 21, 2025

@editorialbot check references

@editorialbot
Copy link
Collaborator Author

Reference check summary (note 'MISSING' DOIs are suggestions that need verification):

✅ OK DOIs

- 10.33232/001c.118783 is OK
- 10.3847/1538-3881/aa859f is OK
- 10.1103/PhysRevD.70.063526 is OK
- 10.1103/PhysRevD.100.103506 is OK
- 10.1103/PhysRevD.108.123518 is OK
- 10.1103/PhysRevD.105.023520 is OK
- 10.1051/0004-6361/202039063 is OK
- 10.1093/mnras/stv2615 is OK
- 10.2172/1420403 is OK
- 10.1103/PhysRevD.105.023515 is OK
- 10.3847/1538-4357/ab042c is OK
- 10.1088/1475-7516/2013/12/029 is OK
- 10.1093/mnras/stx3040 is OK
- 10.1093/mnras/stx3112 is OK
- 10.1093/mnras/sty618 is OK
- 10.1093/mnras/stx3304 is OK
- 10.1093/mnras/sty2206 is OK
- 10.1088/0004-637X/740/2/102 is OK

🟡 SKIP DOIs

- None

❌ MISSING DOIs

- None

❌ INVALID DOIs

- None

@editorialbot
Copy link
Collaborator Author

👉📄 Download article proof 📄 View article proof on GitHub 📄 👈

@ivastar
Copy link

ivastar commented Jan 21, 2025

The suggested change only altered "modeling this" to "modeling of this". I wasn't sure if you saw "accurately modeling this" as "accurate modeling this", so I have left it as is for now. If you feel that the full change
"...accurately modeling this..." to "...accurate modeling of this..." flows better, I will go right ahead and do that.

No strong feelings on that one, maybe I did read it as "accurate modeling", it's fine to leave as is.

@ivastar
Copy link

ivastar commented Jan 21, 2025

Doh, forgot one comment. Can you redo the Figure 1 caption to something like "Correlation functions from IllustrisTNG300.... showcasing the flexibility of the model. Reproduced from Figure 12 in Van Alfen et al. (2024)."

@ivastar
Copy link

ivastar commented Jan 21, 2025

Post-Review Checklist for Editor and Authors

Additional Author Tasks After Review is Complete

  • Double check authors and affiliations (including ORCIDs)
  • Make a release of the software with the latest changes from the review and post the version number here. This is the version that will be used in the JOSS paper.
  • Archive the release on Zenodo/figshare/etc and post the DOI here.
  • Make sure that the title and author list (including ORCIDs) in the archive match those in the JOSS paper.
  • Make sure that the license listed for the archive is the same as the software license.

Editor Tasks Prior to Acceptance

  • Read the text of the paper and offer comments/corrections (as either a list or a pull request)
  • Check that the archive title, author list, version tag, and the license are correct
  • Set archive DOI with @editorialbot set <DOI here> as archive
  • Set version with @editorialbot set <version here> as version
  • Double check rendering of paper with @editorialbot generate pdf
  • Specifically check the references with @editorialbot check references and ask author(s) to update as needed
  • Recommend acceptance with @editorialbot recommend-accept

@ivastar
Copy link

ivastar commented Jan 21, 2025

@nvanalfen we can proceed to the post-review checklist. Please follow the list above. For the release, remind me what were we going to do here? Tag a release of halotools? Or what's the plan?

@nvanalfen
Copy link

nvanalfen commented Jan 21, 2025

@ivastar Andrew has tagged and released the IA version of halotools as v0.9.0 (it looks like minor tweaks since then have advanced to the current version being v0.9.2, but v0.9.0 is where this work was merged in).

Should I formally mark that somewhere here?

I have also fixed and pushed the caption 1 edit. Thank you for catching that.

Also, looking at the generated PDF and I see that my author affiliation list is less of a list and more of a paragraph. It seems I haven't mastered the art of formatting that correctly. I have included them in the markdown as follows. Should I alter that?

authors:
- name: Nicholas Van Alfen
orcid: 0000-0003-0049-2861
corresponding: true
equal-contrib: true
affiliation: 1
- name: Duncan Campbell
orcid: 0000-0002-0650-9903
equal-contrib: true
affiliation: 2
- name: Andrew Hearin
orcid: 0000-0003-2219-6852
equal-contrib: true
affiliation: 3
- name: Jonathan Blazek
orcid: 0000-0002-4687-4657
equil-contrib: true
affiliation: 1

@nvanalfen
Copy link

@aphearin I'm unfamiliar with the release and archive process, so I'm tagging you here in case you know the answers to what I'm about to ask. It looks like the latest version (v0.9.2) is where we included the license change. @ivastar , this seems to be the latest change we made to the code.

Is this sufficient? If so, does the PyPI entry for Halotools v0.9.2 count as the archive? I can't seem to find the DOI on that page. If not, I can (with Andrew's help potentially since I don't want to go archiving a package I'm not the maintainer for) go ahead and archive that on something more appropriate.

Apologies for all the questions and thank you for all your help.

@ivastar
Copy link

ivastar commented Jan 21, 2025

@editorialbot generate pdf

@editorialbot
Copy link
Collaborator Author

👉📄 Download article proof 📄 View article proof on GitHub 📄 👈

@ivastar
Copy link

ivastar commented Jan 21, 2025

Also, looking at the generated PDF and I see that my author affiliation list is less of a list and more of a paragraph. It seems I haven't mastered the art of formatting that correctly. I have included them in the markdown as follows. Should I alter that?

This is the typical formatting. I don't see anything wrong with it. It's ok to leave as is.

@ivastar
Copy link

ivastar commented Jan 21, 2025

does the PyPI entry for Halotools v0.9.2 count as the archive?

The PyPI release does not count as archive. It should be possible to archive this version to Zenodo, seems like there are 2 releases already: https://zenodo.org/records/835895

@ivastar
Copy link

ivastar commented Jan 27, 2025

@nvanalfen @aphearin quoting from the acting editor in chief:

"The principle behind the archive, I believe, is to have a permanent archive of the code that was reviewed for the paper, which to me implies that we should archive the fork, unless the reviewed code is merged into the upstream astropy/halotools repo? In that case, just pointing to the appropriate version in the existing astropy/halotools Zenodo record seems fine to me."

According to the pre-review discussion, the changes here have already been merged upstrea. So, does any of the existing Zenodo archives have these changes? In that case, we can point to that DOI. Or can you make a new Zenodo archive of halotools which includes the changes?

@nvanalfen
Copy link

All of the code changes have been merged into the official astropy/halotools, so the only differences between the repos right now have to do with the paper. It looks like I'll have to make a new Zenodo record for the most recent version of halotools. I'll work with Andrew on that.

@ivastar Two questions:

  • There is a point in that list you sent me that says to make sure the author list on the archive matches the author list in the JOSS paper. The author list in this paper only includes those who worked on the IA functionality, where the author list for the archive of the latest version of halotools should include everyone who had made contributions to the code beyond the IA parts (other bits have been developed and merged in alongside what I have been doing for this IA-specific release). Is this still fine?
  • I am a little confused about the requirement that says the titles must match. The paper of course says "Halotools: a new release..." but the archive would be the simpler "astropy/halotools: v0.9.2" to simply note the version it was released as, correct?

@ivastar
Copy link

ivastar commented Jan 27, 2025

All of the code changes have been merged into the official astropy/halotools, so the only differences between the repos right now have to do with the paper. It looks like I'll have to make a new Zenodo record for the most recent version of halotools. I'll work with Andrew on that.

@ivastar Two questions:

  • There is a point in that list you sent me that says to make sure the author list on the archive matches the author list in the JOSS paper. The author list in this paper only includes those who worked on the IA functionality, where the author list for the archive of the latest version of halotools should include everyone who had made contributions to the code beyond the IA parts (other bits have been developed and merged in alongside what I have been doing for this IA-specific release). Is this still fine?

Yes, that's ok in this case as long as all authors of the paper are included as archive authors.

  • I am a little confused about the requirement that says the titles must match. The paper of course says "Halotools: a new release..." but the archive would be the simpler "astropy/halotools: v0.9.2" to simply note the version it was released as, correct?

Also, ok to have a mismatch in this case.

@nvanalfen
Copy link

@ivastar Sorry for the delay. Just and update: Andrew and I are working on getting access to the existing Zenodo archive for halotools so I can upload a new version. Once I manage that, I will post the DOI and other required information here. Thank you for your patience and help.

@ivastar
Copy link

ivastar commented Feb 10, 2025

@nvanalfen any luck with Zenodo?

@nvanalfen
Copy link

@ivastar not yet. I'll ping the channel again where we're talking about it. Sorry for the delay.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Cython Python review TeX Track: 1 (AASS) Astronomy, Astrophysics, and Space Sciences
Projects
None yet
Development

No branches or pull requests

6 participants