// Copyright 2015-2018 Hans Dembinski
|
//
|
// Distributed under the Boost Software License, Version 1.0.
|
// (See accompanying file LICENSE_1_0.txt
|
// or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
#ifndef BOOST_HISTOGRAM_MAKE_HISTOGRAM_HPP
|
#define BOOST_HISTOGRAM_MAKE_HISTOGRAM_HPP
|
|
/**
|
\file boost/histogram/make_histogram.hpp
|
Collection of factory functions to conveniently create histograms.
|
*/
|
|
#include <boost/histogram/accumulators/weighted_sum.hpp>
|
#include <boost/histogram/detail/detect.hpp>
|
#include <boost/histogram/histogram.hpp>
|
#include <boost/histogram/storage_adaptor.hpp>
|
#include <boost/histogram/unlimited_storage.hpp> // = default_storage
|
#include <boost/mp11/utility.hpp>
|
#include <tuple>
|
#include <vector>
|
|
namespace boost {
|
namespace histogram {
|
|
/**
|
Make histogram from compile-time axis configuration and custom storage.
|
@param storage Storage or container with standard interface (any vector, array, or map).
|
@param axis First axis instance.
|
@param axes Other axis instances.
|
*/
|
template <class Storage, class Axis, class... Axes,
|
class = detail::requires_storage_or_adaptible<Storage>,
|
class = detail::requires_axis<Axis>>
|
auto make_histogram_with(Storage&& storage, Axis&& axis, Axes&&... axes) {
|
auto a = std::make_tuple(std::forward<Axis>(axis), std::forward<Axes>(axes)...);
|
using U = std::decay_t<Storage>;
|
using S = mp11::mp_if<detail::is_storage<U>, U, storage_adaptor<U>>;
|
return histogram<decltype(a), S>(std::move(a), S(std::forward<Storage>(storage)));
|
}
|
|
/**
|
Make histogram from compile-time axis configuration and default storage.
|
@param axis First axis instance.
|
@param axes Other axis instances.
|
*/
|
template <class Axis, class... Axes, class = detail::requires_axis<Axis>>
|
auto make_histogram(Axis&& axis, Axes&&... axes) {
|
return make_histogram_with(default_storage(), std::forward<Axis>(axis),
|
std::forward<Axes>(axes)...);
|
}
|
|
/**
|
Make histogram from compile-time axis configuration and weight-counting storage.
|
@param axis First axis instance.
|
@param axes Other axis instances.
|
*/
|
template <class Axis, class... Axes, class = detail::requires_axis<Axis>>
|
auto make_weighted_histogram(Axis&& axis, Axes&&... axes) {
|
return make_histogram_with(weight_storage(), std::forward<Axis>(axis),
|
std::forward<Axes>(axes)...);
|
}
|
|
/**
|
Make histogram from iterable range and custom storage.
|
@param storage Storage or container with standard interface (any vector, array, or map).
|
@param iterable Iterable range of axis objects.
|
*/
|
template <class Storage, class Iterable,
|
class = detail::requires_storage_or_adaptible<Storage>,
|
class = detail::requires_sequence_of_any_axis<Iterable>>
|
auto make_histogram_with(Storage&& storage, Iterable&& iterable) {
|
using U = std::decay_t<Storage>;
|
using S = mp11::mp_if<detail::is_storage<U>, U, storage_adaptor<U>>;
|
using It = std::decay_t<Iterable>;
|
using A = mp11::mp_if<detail::is_indexable_container<It>, It,
|
std::vector<mp11::mp_first<It>>>;
|
return histogram<A, S>(std::forward<Iterable>(iterable),
|
S(std::forward<Storage>(storage)));
|
}
|
|
/**
|
Make histogram from iterable range and default storage.
|
@param iterable Iterable range of axis objects.
|
*/
|
template <class Iterable, class = detail::requires_sequence_of_any_axis<Iterable>>
|
auto make_histogram(Iterable&& iterable) {
|
return make_histogram_with(default_storage(), std::forward<Iterable>(iterable));
|
}
|
|
/**
|
Make histogram from iterable range and weight-counting storage.
|
@param iterable Iterable range of axis objects.
|
*/
|
template <class Iterable, class = detail::requires_sequence_of_any_axis<Iterable>>
|
auto make_weighted_histogram(Iterable&& iterable) {
|
return make_histogram_with(weight_storage(), std::forward<Iterable>(iterable));
|
}
|
|
/**
|
Make histogram from iterator interval and custom storage.
|
@param storage Storage or container with standard interface (any vector, array, or map).
|
@param begin Iterator to range of axis objects.
|
@param end Iterator to range of axis objects.
|
*/
|
template <class Storage, class Iterator,
|
class = detail::requires_storage_or_adaptible<Storage>,
|
class = detail::requires_iterator<Iterator>>
|
auto make_histogram_with(Storage&& storage, Iterator begin, Iterator end) {
|
using T = std::decay_t<decltype(*begin)>;
|
return make_histogram_with(std::forward<Storage>(storage), std::vector<T>(begin, end));
|
}
|
|
/**
|
Make histogram from iterator interval and default storage.
|
@param begin Iterator to range of axis objects.
|
@param end Iterator to range of axis objects.
|
*/
|
template <class Iterator, class = detail::requires_iterator<Iterator>>
|
auto make_histogram(Iterator begin, Iterator end) {
|
return make_histogram_with(default_storage(), begin, end);
|
}
|
|
/**
|
Make histogram from iterator interval and weight-counting storage.
|
@param begin Iterator to range of axis objects.
|
@param end Iterator to range of axis objects.
|
*/
|
template <class Iterator, class = detail::requires_iterator<Iterator>>
|
auto make_weighted_histogram(Iterator begin, Iterator end) {
|
return make_histogram_with(weight_storage(), begin, end);
|
}
|
|
} // namespace histogram
|
} // namespace boost
|
|
#endif
|
