Least Fill

When and Why to Use

Use this to dynamically select a subset of items that have the fewest responses (i.e. are underrepresented) in a given quota. Ideal for:

Ensuring even coverage across a large set of items (e.g., brands, ads, concepts)
Avoiding over-exposure or over-sampling of frequently selected items
Dynamically balancing stimulus presentation

This does not enforce quotas or terminate users. It simply ranks items by current counts and returns the least-filled ones.

How It Works

Takes a list of items
Checks which ones are least filled in the named quota
Returns the top N least-filled items
Often paired with multi_select_question or select_question

Configuration Options

Parameter	Type	Required	Description
`number`	`int`	yes	Number of items to return
`from_list`	`List[Any]`	yes	Full list of items to choose from
`quota`	`str`	yes	Name of the quota this list belongs to

Example Code

from survey import Survey s = Survey(**globals()) brand_list = [ 'Acura', 'Alfa Romeo', 'Aston Martin', 'Audi', 'Bentley', 'BMW', 'Bugatti', 'Buick', 'Cadillac', 'Chevrolet', 'Chrysler', 'Citroen', 'Dodge', 'Ferrari', 'Fiat', 'Ford', 'Geely', 'Genesis', 'GMC', 'Honda', 'Hyundai' # ...and so on ] brands = s.get_least_filled( number=10, from_list=brand_list, quota="Brand familiarity" ) familiar_brands = s.multi_select_question( question="Which of the following car brands have you heard of?", options=brands )

Notes

This is often used for rotating large brand or product lists evenly
Use set_quota() if you want to enforce a fixed distribution with termination
Items must be trackable via the named quota so that response counts can be compared