DataSeries.hpp

浏览该文件的文档.

 
 
#pragma once
 
#include "AstGlobal.h"
#include "AstReport/AstReportGlobal.hpp"
#include "AstUtil/VariantVector.hpp"
 
#include <string>
#include <vector>
 
AST_NAMESPACE_BEGIN
 
// ---- 前置声明 ----
 
class TimePoint;
 
 
class AST_REPORT_API DataSeries
{
public:
    // ---- 构造/析构 ----
 
    DataSeries() = default;
    DataSeries(const std::string& name, EDataType type, size_t size);
 
    template<typename T>
    DataSeries(const std::string& name, const std::vector<T>& data);
 
    ~DataSeries() = default;
 
    // ---- 拷贝 ----
 
    DataSeries(const DataSeries& other) = default;
    DataSeries& operator=(const DataSeries& other) = default;
 
    // ---- 移动 ----
 
    DataSeries(DataSeries&& other) noexcept = default;
    DataSeries& operator=(DataSeries&& other) noexcept = default;
 
    // ---- 基本信息 ----
 
    const std::string& name() const { return name_; }
    void               setName(const std::string& name) { name_ = name; }
 
    size_t                size()  const { return data_.size(); }
    const std::type_info& elementType()  const { return data_.elementType(); }
    bool                  empty() const { return data_.empty(); }
 
    // ---- 统计方法（返回 double，仅数值类型有效）----
 
    double mean()   const;
    double min()    const;
    double max()    const;
    double sum()    const;
    double stddev() const;
 
    // ---- 类型安全访问 ----
 
    template<typename T>
    T* as() { return data_.as<T>(); }
 
    template<typename T>
    const T* as() const { return data_.as<T>(); }
 
    template<typename T>
    Span<T> asSpan() { return data_.asSpan<T>(); }
 
    template<typename T>
    Span<const T> asSpan() const { return data_.asSpan<T>(); }
 
    // ---- 修改 ----
 
    void resize(size_t n);
    void sort(bool ascending = true);
 
    // ---- 数据访问 ----
 
    const VariantVector& data() const { return data_; }
    VariantVector& data() { return data_; }
protected:
    friend class DataFrame;
 
    std::string name_;          
    VariantVector data_;        
};
 
 
// =========================================
// DataSeries 模板构造函数（内联）
// =========================================
 
template<typename T>
inline DataSeries::DataSeries(const std::string& name, const std::vector<T>& data)
    : name_(name)
    , data_(VariantVector::fromVector(data))
{
}
 
AST_NAMESPACE_END