tim::component::process_cpu_util Struct Reference

this computes the CPU utilization percentage for ONLY the calling process (excludes child processes). Only relevant as a time when a different is computed Do not use a single CPU time as an amount of time; it doesn't work that way. More...

#include "timemory/components/timing/components.hpp"

Collaboration diagram for tim::component::process_cpu_util:

Public Types
using	ratio_t = std::nano
using	value_type = std::pair< int64_t, int64_t >
using	base_type = base< process_cpu_util, value_type >
using	this_type = process_cpu_util
using	storage_type = empty_storage

Public Member Functions
double	get () const noexcept
double	serialization () const noexcept
double	get_display () const noexcept
void	start () noexcept
void	stop () noexcept
this_type &	operator+= (const this_type &rhs) noexcept
this_type &	operator-= (const this_type &rhs) noexcept
bool	assemble (const wall_clock *wc, const process_cpu_clock *cc) noexcept
bool	derive (const wall_clock *wc, const process_cpu_clock *cc) noexcept
bool	is_derived () const noexcept

Static Public Member Functions
static std::string	label ()
static std::string	description ()
static value_type	record ()
template<typename... Args>
static opaque	get_opaque (Args &&...)

Detailed Description

this computes the CPU utilization percentage for ONLY the calling process (excludes child processes). Only relevant as a time when a different is computed Do not use a single CPU time as an amount of time; it doesn't work that way.

Definition at line 379 of file components.hpp.

Member Typedef Documentation

base_type

using tim::component::process_cpu_util::base_type = base<process_cpu_util, value_type>

Definition at line 383 of file components.hpp.

ratio_t

using tim::component::process_cpu_util::ratio_t = std::nano

Definition at line 381 of file components.hpp.

storage_type

using tim::component::empty_base::storage_type = empty_storage

inherited

Definition at line 66 of file declaration.hpp.

this_type

using tim::component::process_cpu_util::this_type = process_cpu_util

Definition at line 384 of file components.hpp.

value_type

using tim::component::process_cpu_util::value_type = std::pair<int64_t, int64_t>

Definition at line 382 of file components.hpp.

Member Function Documentation

assemble()

bool tim::component::process_cpu_util::assemble ( const wall_clock *  wc, const process_cpu_clock *  cc  )

inlinenoexcept

Definition at line 434 of file components.hpp.

    {
        if(wc && cc)
            m_derive = true;
        return m_derive;
    }

derive()

bool tim::component::process_cpu_util::derive ( const wall_clock *  wc, const process_cpu_clock *  cc  )

inlinenoexcept

Definition at line 441 of file components.hpp.

    {
        if(m_derive && wc && cc)
        {
            value.first  = cc->get_value();
            value.second = wc->get_value();
            accum += value;
            return true;
        }
        return false;
    }

description()

static std::string tim::component::process_cpu_util::description ( )

inlinestatic

Definition at line 387 of file components.hpp.

    {
        return "Percentage of CPU-clock time divided by wall-clock time for calling "
               "process (all threads)";
    }

get()

double tim::component::process_cpu_util::get ( ) const

inlinenoexcept

Definition at line 396 of file components.hpp.

    {
        const auto& _data = load();
        double      denom = (_data.second > 0) ? _data.second : 1;
        double      numer = (_data.second > 0) ? _data.first : 0;
        return 100.0 * static_cast<double>(numer) / static_cast<double>(denom);
    }

References tim::component::base< process_cpu_util, std::pair< int64_t, int64_t > >::load().

Referenced by get_display().

get_display()

double tim::component::process_cpu_util::get_display ( ) const

inlinenoexcept

Definition at line 404 of file components.hpp.

{ return get(); }

References get().

Referenced by serialization().

get_opaque()

template<typename... Args>

static opaque tim::component::empty_base::get_opaque ( Args &&  ... )

inlinestaticinherited

Definition at line 72 of file declaration.hpp.

    {
        return opaque{};
    }

is_derived()

bool tim::component::process_cpu_util::is_derived ( ) const

inlinenoexcept

Definition at line 453 of file components.hpp.

{ return m_derive; }

label()

static std::string tim::component::process_cpu_util::label ( )

inlinestatic

Definition at line 386 of file components.hpp.

{ return "proc_cpu_util"; }

operator+=()

this_type & tim::component::process_cpu_util::operator+= ( const this_type &  rhs )

inlinenoexcept

Definition at line 420 of file components.hpp.

    {
        accum += rhs.accum;
        value += rhs.value;
        return *this;
    }

operator-=()

this_type & tim::component::process_cpu_util::operator-= ( const this_type &  rhs )

inlinenoexcept

Definition at line 427 of file components.hpp.

    {
        accum -= rhs.accum;
        value -= rhs.value;
        return *this;
    }

record()

static value_type tim::component::process_cpu_util::record ( )

inlinestatic

Definition at line 392 of file components.hpp.

    {
        return value_type(process_cpu_clock::record(), wall_clock::record());
    }

References tim::component::process_cpu_clock::record(), and tim::component::wall_clock::record().

Referenced by start(), and stop().

serialization()

double tim::component::process_cpu_util::serialization ( ) const

inlinenoexcept

Definition at line 403 of file components.hpp.

{ return get_display(); }

References get_display().

start()

void tim::component::process_cpu_util::start ( )

inlinenoexcept

Definition at line 405 of file components.hpp.

    {
        if(!m_derive)
            value = record();
    }

References record().

stop()

void tim::component::process_cpu_util::stop ( )

inlinenoexcept

Definition at line 410 of file components.hpp.

    {
        using namespace tim::component::operators;
        if(!m_derive)
        {
            value = (record() - value);
            accum += value;
        }
    }

References record().

---

The documentation for this struct was generated from the following file:

• timemory/components/timing/components.hpp