Skip to main content

nominal_api_conjure/conjure/objects/scout/compute/api/
numeric_union_series.rs

1/// Combines multiple numeric series together and outputs a single series. By default, points from the inputs are
2/// concatenated (SQL {@code UNION ALL}) and duplicate timestamps across inputs are preserved. To aggregate values
3/// that share a timestamp, do a separate aggregation step next.
4#[derive(
5    Debug,
6    Clone,
7    conjure_object::serde::Serialize,
8    conjure_object::serde::Deserialize,
9    conjure_object::private::DeriveWith,
10    conjure_object::log_safety::derive::LogSafe
11)]
12#[serde(crate = "conjure_object::serde")]
13#[derive_with(PartialEq, Eq, PartialOrd, Ord, Hash)]
14#[conjure_object::private::staged_builder::staged_builder]
15#[builder(crate = conjure_object::private::staged_builder, update, inline)]
16pub struct NumericUnionSeries {
17    #[builder(default, list(item(type = super::NumericSeries)))]
18    #[serde(rename = "input", skip_serializing_if = "Vec::is_empty", default)]
19    #[assert_is_safe]
20    input: Vec<super::NumericSeries>,
21    #[builder(default, into)]
22    #[serde(rename = "operation", skip_serializing_if = "Option::is_none", default)]
23    operation: Option<super::NumericUnionOperation>,
24}
25impl NumericUnionSeries {
26    /// Constructs a new instance of the type.
27    #[inline]
28    pub fn new() -> Self {
29        Self::builder().build()
30    }
31    /// Input series to union
32    #[inline]
33    pub fn input(&self) -> &[super::NumericSeries] {
34        &*self.input
35    }
36    /// The strategy to merge points with duplicate timestamps.
37    #[deprecated(
38        note = "Apply aggregations as a separate step over the unioned output.\n"
39    )]
40    #[inline]
41    pub fn operation(&self) -> Option<&super::NumericUnionOperation> {
42        self.operation.as_ref().map(|o| &*o)
43    }
44}