Struct net_ensembles::sampling::heatmap::HeatmapUsizeMean

pub struct HeatmapUsizeMean<HistX, HistY> { /* private fields */ }

Heatmap with mean of y-axis

• stores heatmap in row-major order: the rows of the heatmap are contiguous, and the columns are strided
• enables you to quickly create a heatmap
• you can create gnuplot scripts to plot the heatmap
• for each x-axis bin, the y-axis mean is calculated
• …

Difference to HeatmapU

• HeatmapU does not contain the averages for th y-axis, but can be transposed and also used for Y-Histograms which take types which do not implement AsPrimitive

Implementations

impl<HistX, HistY> HeatmapUsizeMean<HistX, HistY>

pub fn heatmap(&self) -> &HeatmapUsize<HistX, HistY>

Internal HeatmapU

impl<HistX, HistY> HeatmapUsizeMean<HistX, HistY>where
    HistX: Histogram,
    HistY: Histogram,

pub fn new(hist_x: HistX, hist_y: HistY) -> HeatmapUsizeMean<HistX, HistY>

Create a heatmap

• creates new instance
• hist_x defines the bins along the x-axis
• hist_y defines the bins along the y-axis

pub fn count_inside_heatmap<X, Y, A, B>(
    &mut self,
    x_val: A,
    y_val: B
) -> Result<(usize, usize), HeatmapError>where
    HistX: HistogramVal<X>,
    HistY: HistogramVal<Y>,
    A: Borrow<X>,
    B: Borrow<Y>,
    Y: AsPrimitive<f64>,

Update Heatmap

• similar to count of HeatmapU

This time, however, any value that is out of bounds will be ignored for the calculation of the mean of the y-axis, meaning also values which correspond to a valid x-bin will be ignored, if their y-value is not inside the Y Histogram

pub fn count<X, Y, A, B>(
    &mut self,
    x_val: A,
    y_val: B
) -> Result<(usize, usize), HeatmapError>where
    HistX: HistogramVal<X>,
    HistY: HistogramVal<Y>,
    A: Borrow<X>,
    B: Borrow<Y>,
    Y: AsPrimitive<f64>,

Update heatmap

• Corresponds to count of HeatmapU

The difference is, that the mean of the y-axis is updated as long as y_val is finite and x_val is in bounds (because the mean is calculated for each bin in the x direction separately)

pub fn mean_slice(&self) -> &[Variance]

Internal slice for mean

• The mean is calculated from this slice
• The mean corresponds to the bins of the x-axis
• you can also access the estimated error of the mean here

pub fn mean_iter(&self) -> impl Iterator<Item = f64>

Iterate over the calculated mean

• iterates over the means
• The mean corresponds to the bins of the x-axis
• if a bin on the x-axis has no entries, the corresponding mean will be f64::NAN

pub fn mean(&self) -> Vec<f64, Global>

Get a mean vector

• The entries are the means corresponds to the bins of the x-axis
• if a bin on the x-axis has no entries, the corresponding mean will be f64::NAN

Note

• If you want to iterate over the mean values, use mean_iter instead
• If you require error information, take a look at mean_slice

pub fn into_heatmap_normalized_columns(self) -> HeatmapF64Mean<HistX, HistY>

returns (column wise) normalized heatmap

• returns normalized heatmap as HeatmapF64Mean

• Heatmap vector self.heatmap_normalized().heatmap() contains only 0.0, if nothing was in the heatmap

• otherwise the sum of each column (fixed x) will be 1.0 (within numerical errors), if it contained at least one hit. If it did not, the column will only consist of 0.0

• otherwise the sum of this Vector is 1.0

For the calculation of the mean, each count will have a weight of 1

pub fn gnuplot_quick<W>(&self, writer: W) -> Result<(), Error>where
    W: Write,

Create a gnuplot script to plot your heatmap

• writer: The gnuplot script will be written to this
• gnuplot_output_name: how shall the file, created by executing gnuplot, be called? Ending of file will be set automatically

Note

• This is the same as calling gnuplot with default GnuplotSettings and default GnuplotPointSettings
• The default axis are the bin indices, which, e.g, means they always begin at 0. You have to set the axis via the GnuplotSettings

pub fn gnuplot<W, P, GS>(
    &self,
    writer: W,
    settings: GS,
    points: P
) -> Result<(), Error>where
    W: Write,
    P: Borrow<GnuplotPointSettings>,
    GS: Borrow<GnuplotSettings>,

Create a gnuplot script to plot your heatmap

This function writes a file, that can be plotted via the terminal via gnuplot

gnuplot gnuplot_file

Parameter:

• writer: writer gnuplot script will be written to
• gnuplot_output_name: how shall the file, created by executing gnuplot, be called? Ending of file will be set automatically
• settings: Here you can set the axis, choose between terminals and more. I recommend that you take a look at GnuplotSettings
• point_color: the mean (in y-direction) will be plotted as points in the heatmap. Here you can choose the point color

Note

• The default axis are the bin indices, which, e.g, means they always begin at 0. You have to set the axis via the GnuplotSettings

Trait Implementations

impl<HistWidth, HistHeight> From<HeatmapUsizeMean<HistWidth, HistHeight>> for HeatmapUsize<HistWidth, HistHeight>

fn from(
    heatmap_mean: HeatmapUsizeMean<HistWidth, HistHeight>
) -> HeatmapUsize<HistWidth, HistHeight>

Converts to this type from the input type.