Skip to main content

Item

Struct Item 

Source
pub struct Item {
    pub id: String,
    pub family: Family,
    pub stratum: Stratum,
    pub group: String,
    pub seed: u64,
    pub state: Entry,
    pub question: QuestionSpec,
    pub truth: usize,
}
Expand description

One score-bearing, verifiable-outcome item.

truth is the index of the correct label in the question’s canonical label order (["false","true"] for noul, option order for choice, level order for score). The truth procedure is mechanical — every item is generated together with its answer, immune to teacher-pretraining contamination by construction.

Fields§

§id: String

Stable item id: vob1-<family>-<stratum>-<kind>-<seed:016x>.

§family: Family

Question family.

§stratum: Stratum

Difficulty/robustness stratum.

§group: String

Permutation group: all cyclic rotations of one choice item share this id (the base item’s id). Base items are their own group.

§seed: u64

The raw seed this item was generated from (reproducibility handle).

§state: Entry

Shared state the question refers to.

§question: QuestionSpec

The jev-1 question spec (question.id == item.id).

§truth: usize

Index of the correct label in canonical label order.

Implementations§

Source§

impl Item

Source

pub fn noul( family: Family, stratum: Stratum, seed: u64, state: Entry, instructions: impl Into<String>, truth: bool, ) -> Self

Build a noul item.

Source

pub fn choice( family: Family, stratum: Stratum, seed: u64, state: Entry, instructions: impl Into<String>, options: Vec<String>, correct: usize, ) -> Self

Build a choice item. correct is the index of the correct option.

Source

pub fn score( family: Family, stratum: Stratum, seed: u64, state: Entry, instructions: impl Into<String>, levels: usize, correct_level: usize, ) -> Self

Build a score item over levels ordered rubric texts.

Source

pub fn truth_label(&self) -> String

The correct label string in canonical label order.

Source

pub fn truth_distribution(&self) -> Vec<f32>

One-hot truth distribution over the canonical labels.

Source

pub fn cyclic_permutation(&self, rotation: usize) -> Option<Item>

The cyclic permutation of a choice item (CircularEval stratum).

Options rotate left by rotation positions; the truth index rotates with them so the same option stays correct. Returns None for non-choice questions (score levels are ordered — permutation would change the question — and noul has no options) and for rotation 0.

Source

pub fn canonical_bytes(&self) -> Vec<u8> ⓘ

Canonical byte form — the exact input the manifest hashes.

FROZEN (vob-item/1): length-prefixed fields, one per line, so the hash is independent of any serializer’s key order or float formatting. Changing anything here invalidates every published item hash.

Source

pub fn hash(&self) -> String

blake3 hex digest of Self::canonical_bytes — the manifest hash.

Trait Implementations§

Source§

impl Clone for Item

Source§

fn clone(&self) -> Item

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for Item

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl PartialEq for Item

Source§

fn eq(&self, other: &Item) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl StructuralPartialEq for Item

Auto Trait Implementations§

§

impl Freeze for Item

§

impl RefUnwindSafe for Item

§

impl Send for Item

§

impl Sync for Item

§

impl Unpin for Item

§

impl UnsafeUnpin for Item

§

impl UnwindSafe for Item

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> Allocation for T
where T: RefUnwindSafe + Send + Sync,