oq-engine
oq-engine copied to clipboard
Things to document in the manual
(current pdf)
Hazard
- [x] Fix duplicate listings: listing 3 (simple fault, pg 28) and listing 4 (directivity, pg 29)
- [x] Document the csv outputs for:
- [x] Hazard curves
- [x] Hazard maps
- [x] UHS
- [x] Disaggregation
- [x] Sigma-Epsilon output for
scenario
andevent_based
- [x] Events output for
scenario
andevent_based
- [x] Earthquake ruptures output for
event_based
- [x] Document the multi-rupture scenario hazard feature (#5603, #5942)
- [x] Document new parameters
- [x]
individual_rlzs
- [x]
individual_curves
- [x]
pointsource_distance
- [x]
ses_seed
- [x]
filter_distance
- [x]
shift_hypo
- [x] ~
point_rupture_bins
~ - [x]
collapse_level
- [x]
discard_trts
- [x]
- [x] Document the secondary perils module
- [x] Add a scenario hazard example in "Chapter 5. Demonstrative Examples"
- [x] New magnitude-scaling relationships: AllenHayes, Leonard, GermanyMSR
- [x] Document the
griddedRupture
typology - [x] Document
MultiPointSources
- [ ] Document site amplification implementation
- [x] Describe the various site model parameters for:
- [x] those describing uniform site conditions in the job file (eg.
reference_depth_to_2pt5km_per_sec
) - [x] those listed in a site model file (eg.
backarc
,custom_site_id
,z1pt0
,z1pt4
,z2pt5
,xvf
,backarc_distance
,eshm20_region
) - [ ] those related to site amplification (eg.
ampcode
,ec8
,ec8_p18
,h800
,geology
,amplfactor
)
- [x] those describing uniform site conditions in the job file (eg.
- [ ] Mention the units for the different IMTs available
- [x] Period dependent weights in the logic tree
- [x] MetaGSIM, AvgGMPE, NRCan15SiteTerm (maybe too specific for user manual?)
Risk
- [ ] Document
classical_damage
andclassical_risk
calculations starting from hazard curve csv files - [x] Clarify input parameters for fragility and vulnerability
- [x] Document the
event_based_damage
calculator - [x] Document the change in algorithm for
scenario_damage
- [x] Document new/modified parameters
- [x]
ignore_covs
- [x]
individual_curves
- [x] ~~
asset_loss_table
~~ (discontinued in #5186) - [x] ~~
approx_ddd
~~ (extremely limited use) - [x] ~~
modal_damage_state
~~ (extremely limited use) - [x] ~~
collapse_threshold
~~ (currently unused by the engine)
- [x]
- [x] Rewrite §7.1 Exposure to use primarily csv exposure examples
- [x] Mention that zipped exposures can be provided
- [x] Document the new scenario damage / risk outputs
dmg_by_event
andlosses_by_event
General
- [x] Glossary was last seen in v3.1 (01 Jun 2018), absconding in all later versions
Document in a manual for advanced users
- [ ] Document new parameters:
- [ ]
discard_assets
- [x]
aggregate_by
- [ ]
ignore_missing_costs
- [x]
minimum_asset_loss
- [ ]
- [x] Describe the (correct?) expected behavior of the stochastic event set
generator for different values of the three parameters:
ses_per_logic_tree_path
,investigation_time
,number_of_logic_tree_samples
, for both sampling and full enumeration - [x] The
ses_seed
is not mentioned, but it is important since it is the one used for generating the ruptures in event based — short explanation of the behaviors governed byses_seed
,random_seed
andmaster_seed
would be useful - [x] Document the new ebrisk calculator
Is there any documentation available explaining the use of the sourceGroup
, and on the multiPointSource
and the griddedRupture
typologies? The only examples I can find are in the QA tests data, but no explanation is given regarding the logic of the calculators. If not in manual this should be added in the next version.
@g-weatherill MultiPoint sources are documented here https://github.com/gem/oq-engine/blob/master/doc/adv-manual/multipoint.rst while there is nothing at all on GriddedRuptures.
Dear @micheles I am writing this to express my interest in participating in the Google Season of Docs program, 2023. I am a final year student at IIT Mandi, pursuing Bachelors of Technology in Computer Science. I am doing minors in Data Science and have done a significant number of courses as well as projects in this domain.
Could you please guide me on how to proceed. I would appreciate any advice or recommendations you may have regarding the project. Regards Pritish Chugh
Hello @micheles
I am Vinayak I would love to contribute to this project through documentation, I would love to know the ways in which I can contribute to it. If you have something for me can you please guide me ? I would appreciate your help.
Thank you :)
Please send an email to [email protected] if you want to partecipate to the documentation project.
I think we may also need to document the taxonomy_mapping_csv
parameter. It has come up twice in support requests I've received recently, and I'm not aware of any place where it is documented.
It is now documented in user-guide/inputs/taxonomy-mapping.rst