Enum DemandCurve

pub enum DemandCurve {
    Pwl(PwlCurve),
    Constant(ConstantCurve),
}

A demand curve expressing a bidder’s willingness to pay at different rates.

The solver uses these curves to find optimal allocations that maximize total welfare. All curves must include rate=0 in their domain to allow for zero trade scenarios.

Variants

Pwl(PwlCurve)

Piecewise linear curve defined by a series of points

Constant(ConstantCurve)

Constant price curve over a rate interval

Implementations

impl DemandCurve

pub unsafe fn new_unchecked(value: DemandCurveDto) -> Self

Creates a demand curve without validation

Safety

The caller must ensure the data represents a valid curve. Invalid curves may cause undefined behavior in the solver.

pub fn domain(&self) -> (f64, f64)

Returns the rate interval over which this curve is defined

Returns

A tuple (min_rate, max_rate) defining the valid rate range for this curve.

pub fn points(self) -> Vec<Point>

Converts the curve into a vector of points

For PWL curves, returns all defining points. For constant curves, returns two points representing the endpoints of the constant price segment.

Trait Implementations

impl Clone for DemandCurve

fn clone(&self) -> DemandCurve

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DemandCurve

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

Formats the value using the given formatter.

impl From<ConstantCurve> for DemandCurve

fn from(value: ConstantCurve) -> Self

Converts to this type from the input type.

impl From<PwlCurve> for DemandCurve

fn from(value: PwlCurve) -> Self

Converts to this type from the input type.

impl Into<DemandCurveDto> for DemandCurve

fn into(self) -> DemandCurveDto

Converts this type into the (usually inferred) input type.

impl TryFrom<ConstantCurveDto> for DemandCurve

type Error = ConstantCurveError

The type returned in the event of a conversion error.

fn try_from(value: ConstantCurveDto) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<DemandCurveDto> for DemandCurve

fn try_from(value: DemandCurveDto) -> Result<Self, Self::Error>

Creates a demand curve from a DTO, validating all constraints

type Error = DemandCurveError

The type returned in the event of a conversion error.

impl TryFrom<PwlCurveDto> for DemandCurve

type Error = PwlCurveError

The type returned in the event of a conversion error.

fn try_from(value: PwlCurveDto) -> Result<Self, Self::Error>

Performs the conversion.