Add config param validation for 'disaggregation' jobs

[Lars Butler]

With the introduction of the disaggregation hazard calculator, we need to properly validate the job config parameters.

The disaggregation calculator introduces several new config parameters:

LATITUDE_BIN_LIMITS = list of latitude values representing bin limits used for disaggregation, values must be in increasing order
LONGITUDE_BIN_LIMITS = list of longitude values representing bin limits for disaggregation, values must be in increasing order
MAGNITUDE_BIN_LIMITS = list of magnitude values representing bin limits for disaggregation, values must be in increasing order
EPSILON_BIN_LIMITS = list of epsilon values representing bin limits for disaggregation, values must be in increasing order
DISTANCE_BIN_LIMITS = list of distance values representing bin limits for disaggregation, values must be in increasing order
POES = list of probabilities of exceedence to disaggregate

The following parameters, which are used in existing calculators, are also relevant to the disaggregation calculator:

OUTPUT_DIR

GMPE_LOGIC_TREE_FILE
GMPE_LT_RANDOM_SEED
SOURCE_MODEL_LOGIC_TREE_FILE
SOURCE_MODEL_LT_RANDOM_SEED

NUMBER_OF_LOGIC_TREE_SAMPLES

MINIMUM_MAGNITUDE
INVESTIGATION_TIME
MAXIMUM_DISTANCE
WIDTH_OF_MFD_BIN

COMPONENT
INTENSITY_MEASURE_TYPE
PERIOD
DAMPING
INTENSITY_MEASURE_LEVELS
GMPE_TRUNCATION_TYPE
TRUNCATION_LEVEL
STANDARD_DEVIATION_TYPE
REFERENCE_VS30_VALUE
REFERENCE_DEPTH_TO_2PT5KM_PER_SEC_PARAM
SADIGH_SITE_TYPE

INCLUDE_AREA_SOURCES
TREAT_AREA_SOURCE_AS
AREA_SOURCE_DISCRETIZATION
AREA_SOURCE_MAGNITUDE_SCALING_RELATIONSHIP

INCLUDE_GRID_SOURCES
TREAT_GRID_SOURCE_AS
GRID_SOURCE_MAGNITUDE_SCALING_RELATIONSHIP

INCLUDE_FAULT_SOURCE
FAULT_RUPTURE_OFFSET
FAULT_SURFACE_DISCRETIZATION
FAULT_MAGNITUDE_SCALING_RELATIONSHIP
FAULT_MAGNITUDE_SCALING_SIGMA
RUPTURE_ASPECT_RATIO
RUPTURE_FLOATING_TYPE

INCLUDE_SUBDUCTION_FAULT_SOURCE
SUBDUCTION_FAULT_RUPTURE_OFFSET
SUBDUCTION_FAULT_SURFACE_DISCRETIZATION
SUBDUCTION_FAULT_MAGNITUDE_SCALING_RELATIONSHIP
SUBDUCTION_FAULT_MAGNITUDE_SCALING_SIGMA
SUBDUCTION_RUPTURE_ASPECT_RATIO
SUBDUCTION_RUPTURE_FLOATING_TYPE

[Damiano Monelli (monelli)]

Regarding the job configuration, we need for sure to check that the parameters specific to the calculator are specified:

LATITUDE_BIN_LIMITS
LONGITUDE_BIN_LIMITS
MAGNITUDE_BIN_LIMITS
EPSILON_BIN_LIMITS
DISTANCE_BIN_LIMITS
POES_TO_DISAGGREGATE

and also the parameters for GMPE and general calculation parameters:

MINIMUM_MAGNITUDE
INVESTIGATION_TIME
MAXIMUM_DISTANCE
WIDTH_OF_MFD_BIN

COMPONENT
INTENSITY_MEASURE_TYPE
PERIOD
DAMPING
INTENSITY_MEASURE_LEVELS
GMPE_TRUNCATION_TYPE
TRUNCATION_LEVEL
STANDARD_DEVIATION_TYPE
REFERENCE_VS30_VALUE
REFERENCE_DEPTH_TO_2PT5KM_PER_SEC_PARAM

the parameter
SADIGH_SITE_TYPE will be probably removed (see bug: https://bugs.launchpad.net/openquake/+bug/856204)

The parameters regarding the seismic sources:
INCLUDE_AREA_SOURCES
TREAT_AREA_SOURCE_AS
AREA_SOURCE_DISCRETIZATION
AREA_SOURCE_MAGNITUDE_SCALING_RELATIONSHIP

INCLUDE_GRID_SOURCES
TREAT_GRID_SOURCE_AS
GRID_SOURCE_MAGNITUDE_SCALING_RELATIONSHIP

INCLUDE_FAULT_SOURCE
FAULT_RUPTURE_OFFSET
FAULT_SURFACE_DISCRETIZATION
FAULT_MAGNITUDE_SCALING_RELATIONSHIP
FAULT_MAGNITUDE_SCALING_SIGMA
RUPTURE_ASPECT_RATIO
RUPTURE_FLOATING_TYPE

INCLUDE_SUBDUCTION_FAULT_SOURCE
SUBDUCTION_FAULT_RUPTURE_OFFSET
SUBDUCTION_FAULT_SURFACE_DISCRETIZATION
SUBDUCTION_FAULT_MAGNITUDE_SCALING_RELATIONSHIP
SUBDUCTION_FAULT_MAGNITUDE_SCALING_SIGMA
SUBDUCTION_RUPTURE_ASPECT_RATIO
SUBDUCTION_RUPTURE_FLOATING_TYPE

may not be all needed. This depends on the source models contained in the logic tree definition. If for instance the source models considered contain only area sources, then only the parameters for area sources should be defined.

For the time being we can require all of them, but in the future we should be more flexible.

[Lars Butler (lars-butler)]

Pull request: https://github.com/gem/openquake/pull/526