Skip to main content

ExplorationExposureScenario

Statistics scenarios · Implementation: mlsysim/engine/scenario_definitions/statistics.py.

Construct this scenario with keyword inputs. The fields below show the types and defaults declared by this class.

A ranking service showing slots_per_user items a day to daily_users from a catalog of catalog_items, with explore_share of slots served by randomized exploration.

Notes

Equation: Daily impressions are users*slots_per_user, and expected exploration slots multiply by explore_share.

Assumptions: Exposure accounting treats slots as opportunities, with a fixed exploration share.

Excludes: Unique item coverage, repeat exposures, exploration quality, and individualized exposure distributions.

References

Derivation: Daily impressions are users*slots_per_user, and expected exploration slots multiply by explore_share. This is declared scenario accounting rather than a fitted empirical law.

Examples

>>> from mlsysim import Scenarios
>>> scenario = Scenarios.RecommenderExplorationExposure
>>> value = scenario.impressions
>>> round(float(value), 3)
200000000.0

Attributes

Name Description
catalog_coverage One user’s daily slot count divided by catalog size; no deduplication of repeated items.
catalog_items
daily_users
explore_impressions Expected daily slots assigned to exploration under the declared fraction.
explore_share
impressions Total daily recommendation slots, users times slots per user.
slots_per_user

daily_users

Type: int.

Declared default: required.

slots_per_user

Type: int.

Declared default: required.

catalog_items

Type: int.

Declared default: required.

explore_share

Type: float.

Declared default: required.

impressions

engine.scenario_types.ExplorationExposureScenario.impressions

Total daily recommendation slots, users times slots per user.

Equation: daily_users * slots_per_user.

catalog_coverage

engine.scenario_types.ExplorationExposureScenario.catalog_coverage

One user’s daily slot count divided by catalog size; no deduplication of repeated items.

Equation: slots_per_user / catalog_items.

explore_impressions

engine.scenario_types.ExplorationExposureScenario.explore_impressions

Expected daily slots assigned to exploration under the declared fraction.

Equation: impressions * explore_share.

Back to top