OpenQuake for Advanced Users devel. (3.19.0)

PDF version (master): https://docs.openquake.org/oq-engine/master/PDF/OpenQuakeforAdvancedUsers.pdf

Contents:

• 1. General
• 2. Common mistakes: bad configuration parameters
  • 2.1. The quadratic parameters
  • 2.2. Maximum distance
  • 2.3. pointsource_distance
  • 2.4. The linear parameters: width_of_mfd_bin and intensity levels
  • 2.5. concurrent_tasks parameter
• 3. Developing with the engine
  • 3.1. Prerequisites
  • 3.2. The first thing to do
  • 3.3. Understanding the engine
  • 3.4. Running calculations programmatically
  • 3.5. Case study: computing the impact of a source on a site
  • 3.6. Working with GMPEs directly: the ContextMaker
  • 3.7. Working with verification tables
  • 3.8. Running the engine tests
• 4. Architecture of the OpenQuake engine
  • 4.1. Components of the OpenQuake Engine
  • 4.2. Design principles
• 5. How the parallelization works in the engine
  • 5.1. How to use openquake.baselib.parallel
• 6. Extracting data from calculations
  • 6.1. Plotting
  • 6.2. Extracting disaggregation outputs
  • 6.3. Extracting ruptures
• 7. Reading outputs with pandas
  • 7.1. Example: how many events per magnitude?
• 8. Limitations of Floating-point Arithmetic
• 9. Some useful oq commands
  • 9.1. oq zip
  • 9.2. Importing a remote calculation
  • 9.3. plotting commands
  • 9.4. prepare_site_model
  • 9.5. Reducing the source model
  • 9.6. Comparing hazard results
  • 9.7. Showing calculation attributes
  • 9.8. Mosaic-related commands
    • 9.8.1. Running a PSHA analysis
    • 9.8.2. Sampling ruptures
    • 9.8.3. Sampling ground motion fields
• 10. Logic Trees
  • 10.1. extendModel
  • 10.2. The logic tree demo
  • 10.3. The concept of effective realizations
  • 10.4. Reduction of the logic tree
  • 10.5. How to analyze the logic tree of a calculation without running the calculation
• 11. Source Specific Logic Trees
  • 11.1. Extracting the hazard curves
  • 11.2. Sampling of the logic tree
• 12. Logic tree sampling strategies
  • 12.1. GMPE logic trees with weighted IMTs
• 13. Classical PSHA
  • 13.1. Reducing a calculation
  • 13.2. Classical PSHA for Europe (SHARE)
  • 13.3. Collapsing the GMPE logic tree
• 14. Parametric GMPEs
  • 14.1. Signature of a GMPE class
  • 14.2. GMPETable
  • 14.3. File-dependent GMPEs
  • 14.4. MultiGMPE
  • 14.5. GenericGmpeAvgSA
  • 14.6. ModifiableGMPE
• 15. MultiPointSources
• 16. The point source gridding approximation
  • 16.1. Application: making the Canada model 26x faster
  • 16.2. How to determine the “right” value for the ps_grid_spacing parameter
• 17. disagg_by_src
• 18. The post-processing framework and Vector-valued PSHA calculations
  • 18.1. The conditional spectrum post-processor
• 19. Event Based and Scenarios
  • 19.1. Understanding the hazard
  • 19.2. region_grid_spacing
  • 19.3. Collapsing of branches
  • 19.4. Using collect_rlzs=true in the risk calculation
  • 19.5. Splitting the calculation into subregions
  • 19.6. Trimming of the logic-trees or sampling of the branches
  • 19.7. ignore_covs vs ignore_master_seed
• 20. The asset loss table
  • 20.1. The Probable Maximum Loss (PML) and the loss curves
    • 20.1.1. Aggregate loss curves
  • 20.2. Aggregating by multiple tags
• 21. Rupture sampling: how does it work?
  • 21.1. The difference between full enumeration and sampling
• 22. Rupture sampling: how to get it wrong
• 23. Extra tips specific to event based calculations
  • 23.1. Convergency of the GMFs for non-trivial logic trees
• 24. The concept of “mean” ground motion field
  • 24.1. Mean ground motion field by GMPE
  • 24.2. Mean ground motion field by event
  • 24.3. Single-rupture estimated median ground motion field
  • 24.4. Case study: GMFs for California
• 25. Extended consequences
  • 25.1. discrete_damage_distribution
  • 25.2. The EventBasedDamage demo
  • 25.3. The ScenarioDamage demo
  • 25.4. Taxonomy mapping
• 26. Correlation of Ground Motion Fields
• 27. Scenarios from ShakeMaps
  • 27.1. Running the Calculation
  • 27.2. Correlation
  • 27.3. Performance Considerations
• 28. Reinsurance calculations
  • 28.1. Input files
    • 28.1.1. Exposure file
    • 28.1.2. Insurance and reinsurance information (reinsurance.xml)
    • 28.1.3. Policy information (policy.csv)
    • 28.1.4. Configuration file job.ini
  • 28.2. Output files
• 29. How the hazard sites are determined
• 30. Risk profiles
  • 30.1. Single-line commands
  • 30.2. Caveat: GMFs are split-dependent
• 31. Special features of the engine
  • 31.1. Sensitivity analysis
  • 31.2. The custom_site_id
  • 31.3. The minimum_distance parameter
  • 31.4. Equivalent Epicenter Distance Approximation
  • 31.5. Ruptures in CSV format
  • 31.6. max_sites_disagg