Sitelet https://github.com/bandframework/bandframework/pull/188
Skip to content

V05release - #188

Merged
wildsm merged 287 commits into
mainfrom
v05release
Dec 22, 2025
Merged

wildsm merged 287 commits into
mainfrom
v05release

Conversation

@wildsm

@wildsm wildsm commented Dec 16, 2025

Copy link
Copy Markdown
Member

mosesyhc and others added 30 commits September 16, 2025 14:35
Fixies:
- the link to BFRESCOX
- the version number
- the link to software (so that it tracks the correct branch)
- nuclear physics
Fixed some links and version.
Adding three READMEs to the list of places that now contain a version number!
Fixed version number and some links.
Moved jitr to software consistently
Bringing in latest develop
Approving pull request of merge of reorganization of Examples directory into develop.
It looks like v1.1.0 was still here
Fixing URL typo that the CI action caught
Addressing some new stoplist words
@ozgesurer

Copy link
Copy Markdown
Collaborator
  • Because the ptemcee sampler is not compatible with the current numpy, I created a new notebook, BANDCamp_nbs/Bfrescox_GPR_v05.ipynb, and illustrated the workflow using emcee. A note has been added to BANDCamp21.rst. See commit 6c5e25e

  • As mentioned previously, the BAND Camp 2021 illustrations should reflect the state of 2021, not 2025. Since we didn’t have a tagged BAND Framework version in 2021 (the closest is v0.2), in the three notebooks that use Fresco I now git clone --branch v0.2.0 https://github.com/bandframework/bandframework.git instead of the develop branch. This resolved the issues. You can now feel free to restructure or update for newer framework versions as needed. See commit f1bdde6

@DanielRPhillips DanielRPhillips left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the fixes @asemposki and @ozgesurer. @asemposki, can you please check that the revised Bfrescox notebooks now run in Google colab?

I have:

  • updated the README file in the directory where the notebooks sit to clarify the distinction between Bfrescox_GPR.ipynb and Bfrescox_GPR_v05.ipynb.
  • added a known issue to CHANGELOG.rst that states our BRICK MacOS & Windows compatibility issues.

@DanielRPhillips DanielRPhillips left a comment •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@wildsm I have verified several, but not all, of the following items on your list:

  • Release notes for this version are complete and represent changes through the CHANGELOG.rst </CHANGELOG.rst>_ file.

  • Ensure that links and references have been updated (e.g., no occurrences of privateband). Consider checking that the url checking action is reviewing a sufficiently rich set of files where spelling should be checked.

I checked and found no occurences of privateband. I checked several links and, after our efforts of the past few days, found no failures. I also checked that all links in CONTRIBUTING.rst and CHANGELOG.rst.

  • Version number is update-to-date wherever it appears and +dev suffix is removed
    (currently: 4 in README.md </README.md>, 1 in AUTHORS , 1 in bandsdk.md </resources/sdkpolicies/bandsdk.md>, 1 in examples </examples/README.md>, 1 in software </software/README.md>, 1 in BANDsoftware_uses </BANDsoftware_uses/README.md>, and possibly in CHANGELOG.rst </CHANGELOG.rst>_).

Note for future reference that I found one more occurrence of version number in README.md

  • Check README.md </README.md>_ Citing bandframework for correctness (e.g., ensure that author list matches AUTHORS _, year and version are correct).

  • Check bandsdk.md </resources/sdkpolicies/bandsdk.md>_ Citing bandframework for correctness (authors, year, version). Ensure that SDK version listed is the same as in the provided template </resources/sdkpolicies/template.md>_.

  • Check sdkpolicies README </resources/sdkpolicies/README.md>_ for correctness (e.g., ensure that each software in the release has a working link for its SDK compliance, also note any differences in the version of the SDK that each package lists versus the version at bandsdk.md </resources/sdkpolicies/bandsdk.md>_).

All links work and all packages are working with v0.2 (the current version) of the SDK

  • Please state whether you have verified successful execution of the notebooks linked in BRICK </examples/BRICK/tutorial>_ and Bfrescox use </BANDsoftware_uses/BFRESCOX>_ . Successful completion of this PR should include verification across the union of reviewers.

I have not executed BRICK notebooks, but have added issues with doing so as a "Known issue" in CHANGELOG.rst

  • Tests are run with source to be released (this may iterate):

    Online CI (GitHub Actions) tests must pass.

    Documentation must build and display correctly wherever hosted.

Adding/removing some commas to the README
Update BFRESCOX --> Bfrescox in the README
Update PUQ readme for bfrescox path

@beykyle beykyle left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I checked the links and didn't find any issues.

One question: The notebooks linked in https://github.com/bandframework/bandframework/blob/v05release/BANDsoftware_uses/Bfrescox/Tutorial_I/BANDCamp21.rst now open directly to the git blob for the ipynb files, rather than opening in google collab, is that intentional? @ozgesurer

This should maintain the link valid even after `develop` is eventually updated.  The BRICK notebook link is already set to the release branch.

@DanielRPhillips DanielRPhillips left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have completed my review. The only outstanding issue pertains to the notebooks.

@jared321

jared321 commented Dec 22, 2025 •

Copy link
Copy Markdown
Contributor

Review performed at (clean) commit 2c4a4bd5f4

  • Release notes for this version are complete and represent changes through the CHANGELOG.rst file.
  • Ensure that links and references have been updated (e.g., no occurrences of privateband). Consider checking that the url checking action is reviewing a sufficiently rich set of files where spelling should be checked.
  • Version number is update-to-date wherever it appears and +dev suffix is removed
    (currently: 3 in README.md </README.md>, 1 in AUTHORS </AUTHORS>, 1 in bandsdk.md </resources/sdkpolicies/bandsdk.md>, 1 in examples </examples/README.md>, 1 in software </software/README.md>, 1 in BANDsoftware_uses </BANDsoftware_uses/README.md>, and possibly in CHANGELOG.rst </CHANGELOG.rst>_).
  • Check README.md Citing bandframework for correctness (e.g., ensure that author list matches AUTHORS, year and version are correct).
  • Check bandsdk.md Citing bandframework for correctness (authors, year, version). Ensure that SDK version listed is the same as in the provided template.
  • Check sdkpolicies README for correctness (e.g., ensure that each software in the release has a working link for its SDK compliance, also note any differences in the version of the SDK that each package lists versus the version at bandsdk.md).
  • Please state whether you have verified successful execution of the notebooks linked in
    • BRICK - I don't have AZURE2 on a Linux station
    • Bfrescox + surmise - Built Frescox locally, setup dedicated venv with manual installation of external dependencies , and ran Bfrescox_GPR_v05.ipynb. Plots are similar to those in repo. Also manually updated Bfrescox_surmise.ipynb to use my local installations (including Frescox binary) and confirm that it ran through with graphics similar to those in that notebook.
  • Tests are run with source to be released (this may iterate):
    • Online CI (GitHub Actions) tests must pass.
    • Documentation must build and display correctly wherever hosted.

Additionally

  • Confirmed that all versions provided in README for this release are identical to versions listed in
    • software/README.md
    • examples/README.md
    • BANDsoftware_uses/README.md (N/A)

@wildsm
wildsm requested a review from asemposki December 22, 2025 21:04
The tutorial notebooks can no longer hosted on the original Colab-compatible site.  Make this clear in the notes and provide some hints for how to update the notebooks for local execution.
@jared321

Copy link
Copy Markdown
Contributor

I updated the Bfrescox+surmise tutorial README to address potential notebook issues/questions raised by both Daniel and Kyle.

3b330e4

@ozgesurer

Copy link
Copy Markdown
Collaborator

I checked the links and didn't find any issues.

One question: The notebooks linked in https://github.com/bandframework/bandframework/blob/v05release/BANDsoftware_uses/Bfrescox/Tutorial_I/BANDCamp21.rst now open directly to the git blob for the ipynb files, rather than opening in google collab, is that intentional? @ozgesurer

We decided to keep the files themselves so that we do not lose access to the links in case of any reason. Please also see the commit 3b330e4 for the updated explanation.

@jared321 jared321 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please see my review checklist in the PR notes.

@wildsm

wildsm commented Dec 22, 2025

Copy link
Copy Markdown
Member Author

Many thanks to all of the reviewers!

We have come to consensus that @asemposki 's notes were addressed and are proceeding with next steps since she is likely logged off for the year.

I will continue following the flow at #178

@wildsm
wildsm merged commit ac0cb02 into main Dec 22, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

v0.5.0 Release

9 participants