ReviewStaffingScenario
Economics scenarios · Implementation: mlsysim/engine/scenario_definitions/economics.py.
Construct this scenario with keyword inputs. The fields below show the types and defaults declared by this class.
Substantive human review: appeal_rate of decisions_per_day at time_per_case each, staffed in shift-long shifts; optionally against a reported compare_cases handled at compare_time_per_case.
Notes
Equation: Review labor is decisions_per_day*appeal_rate*time_per_case; fractional shift equivalents divide by shift duration.
Assumptions: Review duration is constant and every appealed case requires one review.
Excludes: Integer staffing, breaks, peak demand, supervision overhead, and evidence that the declared time permits substantive review.
References
Derivation: Review labor is decisions_per_day*appeal_rate*time_per_case; fractional shift equivalents divide by shift duration. This is declared scenario accounting rather than a fitted empirical law.
Examples
>>> from mlsysim import Scenarios
>>> scenario = Scenarios.CreditAppealReview
>>> value = scenario.appeals_per_day
>>> round(float(value), 3)
1000.0Attributes
| Name | Description |
|---|---|
| appeal_rate | |
| appeals_per_day | Expected daily appealed decisions from decision count times appeal fraction. |
| cases_per_hour | Cases one reviewer processes in an hour at constant review duration. |
| compare_cases | |
| compare_cases_per_hour | Comparison-cohort cases per reviewer-hour at its supplied duration. |
| compare_hours | Total comparison-cohort labor hours from its count and supplied per-case duration. |
| compare_time_per_case | |
| decisions_per_day | |
| reviewer_hours_per_day | Daily review labor in hours from appealed-case count times review duration. |
| reviewers | Fractional staffed-shift equivalents, without integer rounding or peak-load reserve. |
| shift | |
| time_per_case |
decisions_per_day
Type: float.
Declared default: required.
appeal_rate
Type: float.
Declared default: required.
time_per_case
Type: Quantity.
Declared default: required.
shift
Type: Quantity.
Declared default: required.
compare_cases
Type: Optional[float].
Declared default: None.
compare_time_per_case
Type: Optional[Quantity].
Declared default: None.
appeals_per_day
engine.scenario_types.ReviewStaffingScenario.appeals_per_day
Expected daily appealed decisions from decision count times appeal fraction.
Equation: decisions_per_day * appeal_rate.
reviewer_hours_per_day
engine.scenario_types.ReviewStaffingScenario.reviewer_hours_per_day
Daily review labor in hours from appealed-case count times review duration.
Equation: (appeals_per_day * time_per_case).to('hour').
reviewers
engine.scenario_types.ReviewStaffingScenario.reviewers
Fractional staffed-shift equivalents, without integer rounding or peak-load reserve.
Equation: (reviewer_hours_per_day / shift).to('').magnitude.
cases_per_hour
engine.scenario_types.ReviewStaffingScenario.cases_per_hour
Cases one reviewer processes in an hour at constant review duration.
Equation: (Q_(1, 'hour') / time_per_case).to('').magnitude.
compare_hours
engine.scenario_types.ReviewStaffingScenario.compare_hours
Total comparison-cohort labor hours from its count and supplied per-case duration.
Equation: (compare_cases * compare_time_per_case).to('hour').
compare_cases_per_hour
engine.scenario_types.ReviewStaffingScenario.compare_cases_per_hour
Comparison-cohort cases per reviewer-hour at its supplied duration.
Equation: (Q_(1, 'hour') / compare_time_per_case).to('').magnitude.