BBP Release Steps

Steps For Releasing Broadband Platform

These are the steps needed for making a Broadband Platform release.

Code Freeze

The first step for a BBP release is to collect the latest codes from all science teams. Ideally, each science team will have reviewed their results and signed off on their method before the code freeze. This will avoid surprises and delays later in the release process.

• Announce code freeze date
• Collect code and parameter changes
• Run simulations as needed
  • Single realizations
    • Useful to make sure codes work
  • Cluster testing
    • Useful to explore different realizations, create validation sets
• Share results with science teams
• Obtain approval from each science team

Science Review

These are the steps for a science review of the BBP:

• Make sure cluster has latest versions of everything, use 'diff -r' to make sure source distribution, bbp_gf, and bbp_val are in sync
• rsync needed packages in bbp_gf to /staging
• Run Part-A and Part-B full validations for each method
  • Can use XXXX_a.sh and XXXX_b.sh scripts (where XXXX is each method)
    • Create and submits to cluster all validation events for that method
• Run Multi-segment Part-A events not included in XXXX_a.sh scripts
  • GP and SDSU Landers is an example, each segment needs to be submitted and then merged with bbp_merge_multisegment_validation.py tool
• Plot results
  • plot_XXX_a.sh and plot_XXX_b.sh scripts will generate the combined GoF plots automatically
  • combine_map_gof_gen.py and combine_dist_gof_gen.py to generate map and distance GoF plots
  • Run create_convergence_plots.sh to create convergence plots for the Part-A validation events
  • Create release directory structure in hypocenter, on the BBP server, it will be:
    • /home/hypocenter-01/bbp/BBP_MMMYYYY_Plots
    • Inside, create the following folders:
      • Converge
      • Distance
      • Maps
      • Part-A
      • Part-B
      • Summary
      • Tables
  • Copy Part-A GoFs, Part-B GMPE plots, Map GoFs, Distance GoFs, Convergence Plots to their respective directories