Class: BestOfN

Sample N candidates and select the highest-rewarded (dspy.BestOfN).

 classDiagram
    class BestOfN
    click BestOfN href "../BestOfN/"
      Module <|-- BestOfN
        click Module href "../Module/"

      BestOfN : callbacks

      BestOfN : compiled

      BestOfN : description

      BestOfN : history





        BestOfN --> "*" LMHistoryEntry : history
        click LMHistoryEntry href "../LMHistoryEntry/"



      BestOfN : id

      BestOfN : metric_threshold

      BestOfN : module_under_test





        BestOfN --> "0..1" Module : module_under_test
        click Module href "../Module/"



      BestOfN : n

      BestOfN : name

      BestOfN : predictors





        BestOfN --> "*" Predictor : predictors
        click Predictor href "../Predictor/"



      BestOfN : reward_fn

      BestOfN : sub_modules





        BestOfN --> "*" Module : sub_modules
        click Module href "../Module/"

Inheritance

NamedThing
- Module
  - BestOfN

Slots

Name	Cardinality and Range	Description	Inheritance
n	0..1 Integer	Number of candidate generations (BestOfN, MultiChainComparison	direct
reward_fn	0..1 String	Dotted import path of a reward function (Refine, BestOfN)	direct
metric_threshold	0..1 Float		direct
module_under_test	0..1 Module	Wrapped module	direct
compiled	0..1 Boolean	Whether the module has been compiled by a teleprompter	Module
callbacks	* String	Dotted import paths of callbacks registered on the module	Module
history	* LMHistoryEntry	Per-module call history of LM requests / responses	Module
predictors	* Predictor	Predictor children of a composite Module (named_predictors())	Module
sub_modules	* Module	Nested Module children of a composite Module	Module
id	1 Identifier	Stable opaque identifier for an instance	NamedThing
name	0..1 String	Short human-readable name	NamedThing
description	0..1 String	Free-form description	NamedThing

In Subsets

Modules

Identifier and Mapping Information

Annotations

property	value
dspy_source_paths	['dspy/predict/best_of_n.py']
dspy_source_urls	['https://github.com/stanfordnlp/dspy/blob/main/dspy/predict/best_of_n.py']

Schema Source

from schema: https://w3id.org/lmodel/dspy

Mappings

Mapping Type	Mapped Value
self	dspy:BestOfN
native	dspy:BestOfN
close	mellea:SamplingStrategySpec

LinkML Source

Direct

name: BestOfN
annotations:
  dspy_source_paths:
    tag: dspy_source_paths
    value:
    - dspy/predict/best_of_n.py
  dspy_source_urls:
    tag: dspy_source_urls
    value:
    - https://github.com/stanfordnlp/dspy/blob/main/dspy/predict/best_of_n.py
description: Sample N candidates and select the highest-rewarded (``dspy.BestOfN``).
in_subset:
- modules
from_schema: https://w3id.org/lmodel/dspy
close_mappings:
- mellea:SamplingStrategySpec
is_a: Module
slots:
- n
- reward_fn
- metric_threshold
attributes:
  module_under_test:
    name: module_under_test
    description: Wrapped module.
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    domain_of:
    - BestOfN
    - Refine
    range: Module
    inlined: true

Induced

name: BestOfN
annotations:
  dspy_source_paths:
    tag: dspy_source_paths
    value:
    - dspy/predict/best_of_n.py
  dspy_source_urls:
    tag: dspy_source_urls
    value:
    - https://github.com/stanfordnlp/dspy/blob/main/dspy/predict/best_of_n.py
description: Sample N candidates and select the highest-rewarded (``dspy.BestOfN``).
in_subset:
- modules
from_schema: https://w3id.org/lmodel/dspy
close_mappings:
- mellea:SamplingStrategySpec
is_a: Module
attributes:
  module_under_test:
    name: module_under_test
    description: Wrapped module.
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    owner: BestOfN
    domain_of:
    - BestOfN
    - Refine
    range: Module
    inlined: true
  n:
    name: n
    description: Number of candidate generations (BestOfN, MultiChainComparison...).
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    owner: BestOfN
    domain_of:
    - MultiChainComparison
    - BestOfN
    - Refine
    range: integer
    minimum_value: 1
  reward_fn:
    name: reward_fn
    description: Dotted import path of a reward function (Refine, BestOfN).
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    owner: BestOfN
    domain_of:
    - BestOfN
    - Refine
    range: string
  metric_threshold:
    name: metric_threshold
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    owner: BestOfN
    domain_of:
    - BestOfN
    - Refine
    - BootstrapFewShot
    - COPRO
    - MIPROv2
    range: float
  compiled:
    name: compiled
    description: Whether the module has been compiled by a teleprompter.
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    ifabsent: boolean(False)
    owner: BestOfN
    domain_of:
    - Module
    range: boolean
  callbacks:
    name: callbacks
    description: Dotted import paths of callbacks registered on the module.
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    owner: BestOfN
    domain_of:
    - BaseLM
    - Adapter
    - Module
    - Settings
    range: string
    multivalued: true
  history:
    name: history
    description: Per-module call history of LM requests / responses.
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    owner: BestOfN
    domain_of:
    - BaseLM
    - Module
    range: LMHistoryEntry
    multivalued: true
    inlined: true
    inlined_as_list: true
  predictors:
    name: predictors
    description: Predictor children of a composite Module (named_predictors()).
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    owner: BestOfN
    domain_of:
    - Module
    range: Predictor
    multivalued: true
    inlined: true
    inlined_as_list: true
  sub_modules:
    name: sub_modules
    description: Nested Module children of a composite Module.
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    owner: BestOfN
    domain_of:
    - Module
    range: Module
    multivalued: true
    inlined: true
    inlined_as_list: true
  id:
    name: id
    description: Stable opaque identifier for an instance.
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    slot_uri: schema:identifier
    identifier: true
    owner: BestOfN
    domain_of:
    - NamedThing
    range: Identifier
    required: true
  name:
    name: name
    description: Short human-readable name.
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    slot_uri: rdfs:label
    owner: BestOfN
    domain_of:
    - NamedThing
    - LMToolCallPart
    - LMMessage
    - LMToolSpec
    range: string
  description:
    name: description
    description: Free-form description.
    from_schema: https://w3id.org/lmodel/dspy
    rank: 1000
    slot_uri: dct:description
    owner: BestOfN
    domain_of:
    - NamedThing
    - LMToolSpec
    range: string