Timeline/gov.nasa.ammos.aerie.procedural.timeline.ops.numeric/SerialNumericOps

SerialNumericOps

interface SerialNumericOps<V : Any, THIS : SerialNumericOps<V, THIS>> : SerialSegmentOps<V, THIS> , NumericOps<V, THIS>

Operations for profiles that represent numbers.

Inheritors

Numbers

Real

Functions

abs

abstract fun abs(): THIS

(DOC) Calculates the absolute value of this profile.

assignGaps

open infix fun assignGaps(v: V): THIS

(DOC) Fills in gaps in this profile with a constant value.

open infix fun assignGaps(other: SerialSegmentOps<V, *>): THIS

(DOC) Fills in gaps in this profile with another profile.

cache

open fun cache(): THIS

(DOC) Caches the timeline for all available time.

abstract fun cache(opts: CollectOptions): THIS

Caches the result of collecting this timeline, to be reused for future collect requests if possible.

open fun cache(bounds: Interval): THIS

(DOC) A simplified version of cache.

changes

abstract fun changes(): Booleans

(DOC) Returns a Booleans that is true whenever this profile changes, and false or gap everywhere else.

collect

open fun collect(): List<Segment<V>>

(DOC) Collects the timeline for all available time.

abstract fun collect(opts: CollectOptions): List<Segment<V>>

(DOC) Evaluates the stack of operations and produces a list of timeline payload objects.

open fun collect(bounds: Interval): List<Segment<V>>

(DOC) A simplified version of collect.

convert

open fun <RESULT : GeneralOps<Segment<V>, RESULT>> convert(ctor: (Timeline<Segment<V>, RESULT>) -> RESULT): RESULT

(DOC) Safely converts to another timeline type that accepts the same payload type.

decreases

abstract fun decreases(): Booleans

(DOC) Returns a Booleans that is true whenever this profile decreases, and false or gap everywhere else.

detectEdges

open fun detectEdges(edgePredicate: NullBinaryOperation<V, V, Boolean?>): Booleans

(DOC) Uses a NullBinaryOperation as a predicate to highlight edges between segments.

filter

open fun filter(preserveMargin: Boolean = false, f: (Segment<V>) -> Boolean): THIS

(DOC) Removes or retains objects based on a predicate.

filterByDuration

open fun filterByDuration(validInterval: Interval): THIS

(DOC) Removes objects whose duration is outside a given valid interval.

filterByWindows

open fun filterByWindows(windows: SerialOps<Interval, *>, truncateMarginal: Boolean = true): THIS

(DOC) Filters out payload objects whose intervals are not contained in the given Windows timeline.

filterLongerThan

open fun filterLongerThan(dur: Duration): THIS

(DOC) Removes objects whose duration is shorter than a given duration.

filterShorterThan

open fun filterShorterThan(dur: Duration): THIS

(DOC) Removes objects whose duration is longer than a given duration.

flatMap2OptionalValues

open fun <W : Any> flatMap2OptionalValues(other: SerialSegmentOps<W, *>, op: NullBinaryOperation<V, W, SerialSegmentOps<V, *>?>): THIS

(DOC) Performs a local binary operation that produces profiles, and flattens it into a profile of the same type as this.

open fun <W : Any, R : Any, RESULT : GeneralOps<Segment<R>, RESULT>> flatMap2OptionalValues(ctor: (Timeline<Segment<R>, RESULT>) -> RESULT, other: SerialSegmentOps<W, *>, op: NullBinaryOperation<V, W, SerialSegmentOps<R, *>?>): RESULT

(DOC) Performs a local binary operation that produces profiles, and flattens it, with special treatment of gaps.

flatMap2Values

open fun flatMap2Values(other: SegmentOps<V, *>, op: (V, V, Interval) -> SegmentOps<V, *>?): THIS

(DOC) A simpler version of flatMap2Values for operations that don't change the timeline type.

open fun <W : Any, R : Any, RESULT : SegmentOps<R, RESULT>> flatMap2Values(ctor: (Timeline<Segment<R>, RESULT>) -> RESULT, other: SegmentOps<W, *>, op: (V, W, Interval) -> SegmentOps<R, *>?): RESULT

(DOC) Performs a local binary operation that produces profiles, and flattens it.

flatMapValues

open fun flatMapValues(f: (Segment<V>) -> SegmentOps<V, *>): THIS

(DOC) A simpler version of flatMapValues for operations that don't change the timeline type.

open fun <R : Any, RESULT : SegmentOps<R, RESULT>> flatMapValues(ctor: (Timeline<Segment<R>, RESULT>) -> RESULT, f: (Segment<V>) -> SegmentOps<R, *>): RESULT

(DOC) Maps segments into a collection of nested timelines and flattens them into their original intervals.

forEach

open fun forEach(p0: Consumer<in Segment<V>>)

highlight

open fun highlight(f: (Segment<V>) -> Boolean): Windows

(DOC) Similar to filter, but produces a coalesced Windows object that highlights everything that satisfies the predicate.

increases

abstract fun increases(): Booleans

(DOC) Returns a Booleans that is true whenever this profile increases, and false or gap everywhere else.

inspect

open fun inspect(f: Consumer<List<Segment<V>>>): THIS

(DOC) Inserts a no-op function into the operation stack to allow side effects, such as printing.

integrate

open fun integrate(unit: Duration = Duration.SECOND): Real

(DOC) Calculates the integral of this profile, starting from zero.

isolate

open fun isolate(f: (Segment<V>) -> Boolean): Universal<Segment<V>>

(DOC) Similar to filter, but returns an Universal timeline.

iterator

abstract operator fun iterator(): Iterator<Segment<V>>

map2OptionalValues

open fun <W : Any> map2OptionalValues(other: SerialSegmentOps<W, *>, op: NullBinaryOperation<V, W, V?>): THIS

(DOC) Performs a local binary operation between two profiles where the result is the same type as this profile.

open fun <W : Any, R : Any, RESULT : GeneralOps<Segment<R>, RESULT>> map2OptionalValues(ctor: (Timeline<Segment<R>, RESULT>) -> RESULT, other: SerialSegmentOps<W, *>, op: NullBinaryOperation<V, W, R?>): RESULT

(DOC) Performs a local binary operation between two profiles, with special treatment of gaps.

map2Values

open fun map2Values(other: SegmentOps<V, *>, op: (V, V, Interval) -> V?): THIS

(DOC) A simplified version of map2Values for operations that don't change the timeline type.

open fun <W : Any, R : Any, RESULT : SegmentOps<R, RESULT>> map2Values(ctor: (Timeline<Segment<R>, RESULT>) -> RESULT, other: SegmentOps<W, *>, op: (V, W, Interval) -> R?): RESULT

(DOC) Performs a local binary operation between two segment-valued timelines.

mapValues

open fun mapValues(f: (Segment<V>) -> V): THIS

(DOC) Locally transforms the values of a profile without changing the intervals or profile type.

open fun <R : Any, RESULT : SegmentOps<R, RESULT>> mapValues(ctor: (Timeline<Segment<R>, RESULT>) -> RESULT, f: (Segment<V>) -> R): RESULT

(DOC) Locally transforms the values of a profile without changing the intervals.

negate

abstract fun negate(): THIS

(DOC) Negates this profile.

select

open fun select(interval: Interval): THIS

(DOC) Restricts the timeline to only be evaluated in the given interval.

set

open infix fun set(other: SerialSegmentOps<V, *>): THIS

(DOC) Overwrites this profile with another. Gaps in the argument profile will be filled in with this profile.

shift

open fun shift(dur: Duration): THIS

(DOC) Uniformly shifts the entire timeline in time (positive shifts toward the future).

shiftedDifference

abstract fun shiftedDifference(range: Duration): THIS

(DOC) Calculates the difference between this profile's value at range time in the future, and this profile at the present.

split

open fun split(f: (Segment<V>) -> Int): THIS

(DOC) Splits payload objects into a variable number of equally sized pieces.

spliterator

open fun spliterator(): Spliterator<Segment<V>>

toNumbers

abstract fun toNumbers(message: String? = null): Numbers<*>

(DOC) Converts the profile to a constant numbers profile, a.k.a. Numbers (no-op if it already was Numbers).

toReal

abstract fun toReal(): Real

(DOC) Converts the profile to a linear profile, a.k.a. Real (no-op if it already was linear).

unaryMinus

open operator fun unaryMinus(): THIS

unsafeCast

abstract fun <RESULT : Timeline<Segment<V>, RESULT>> unsafeCast(ctor: (Timeline<Segment<V>, RESULT>) -> RESULT): RESULT

(DOC) UNSAFE! Casts this timeline type to another type without changing its contents.

unsafeFlatMap

open fun <R : IntervalLike<R>, RESULT : GeneralOps<R, RESULT>> unsafeFlatMap(ctor: (Timeline<R, RESULT>) -> RESULT, boundsTransformer: BoundsTransformer, truncate: Boolean, f: (Segment<V>) -> Segment<GeneralOps<R, *>>): RESULT

(DOC) UNSAFE! Maps each object to a nested timeline and flattens all the timelines into one.

unsafeMap

open fun unsafeMap(boundsTransformer: BoundsTransformer, truncate: Boolean, f: (Segment<V>) -> Segment<V>): THIS

(DOC) UNSAFE! A simpler version of unsafeMap for operations that don't change the timeline type.

open fun <R : IntervalLike<R>, RESULT : GeneralOps<R, RESULT>> unsafeMap(ctor: (Timeline<R, RESULT>) -> RESULT, boundsTransformer: BoundsTransformer, truncate: Boolean, f: (Segment<V>) -> R): RESULT

(DOC) UNSAFE! Maps each timeline object to another object, of potentially a different type, at potentially a different time.

unsafeMap2

open fun <W : IntervalLike<W>, R : IntervalLike<R>, RESULT : GeneralOps<R, RESULT>> unsafeMap2(ctor: (Timeline<R, RESULT>) -> RESULT, other: GeneralOps<W, *>, op: (Segment<V>, W, Interval) -> R?): RESULT

Performs a generalized binary operation between this and another timeline.

unsafeMapIntervals

open fun unsafeMapIntervals(boundsTransformer: BoundsTransformer, truncate: Boolean, f: (Segment<V>) -> Interval): THIS

(DOC) UNSAFE! Maps the interval of each object, leaving the rest of the object unchanged.

unsafeOperate

open fun unsafeOperate(f: Timeline<Segment<V>, THIS>.(opts: CollectOptions) -> List<Segment<V>>): THIS

(DOC) UNSAFE! A simpler version of unsafeOperate for operations that don't change the timeline type.

open fun <R : IntervalLike<R>, RESULT : GeneralOps<R, RESULT>> unsafeOperate(ctor: (Timeline<R, RESULT>) -> RESULT, f: Timeline<Segment<V>, THIS>.(opts: CollectOptions) -> List<R>): RESULT

(DOC) UNSAFE! The basic, most general operation method. All operations eventually delegate here.

unset

open fun unset(reject: Interval): THIS

(DOC) Unsets everything in a given interval. Timeline objects whose intervals fully contain the rejected interval may be split into two objects.

zip

open infix fun zip(other: SerialSegmentOps<V, *>): THIS

Overlays two profiles on each other, asserting that they both cannot be defined at the same time.