tim::component::thread_cpu_util Struct Reference

this computes the CPU utilization percentage for ONLY the calling thread (excludes sibling and child threads). 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::thread_cpu_util:

Public Types
using	ratio_t = std::nano
using	value_type = std::pair< int64_t, int64_t >
using	base_type = base< thread_cpu_util, value_type >
using	this_type = thread_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 thread_cpu_clock *cc) noexcept
bool	derive (const wall_clock *wc, const thread_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 thread (excludes sibling and child threads). 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 465 of file components.hpp.

Member Typedef Documentation

base_type

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

Definition at line 469 of file components.hpp.

ratio_t

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

Definition at line 467 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::thread_cpu_util::this_type = thread_cpu_util

Definition at line 470 of file components.hpp.

value_type

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

Definition at line 468 of file components.hpp.

Member Function Documentation

assemble()

bool tim::component::thread_cpu_util::assemble ( const wall_clock *  wc, const thread_cpu_clock *  cc  )

inlinenoexcept

Definition at line 520 of file components.hpp.

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

derive()

bool tim::component::thread_cpu_util::derive ( const wall_clock *  wc, const thread_cpu_clock *  cc  )

inlinenoexcept

Definition at line 527 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::thread_cpu_util::description ( )

inlinestatic

Definition at line 473 of file components.hpp.

    {
        return "Percentage of CPU-clock time divided by wall-clock time for calling "
               "thread";
    }

get()

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

inlinenoexcept

Definition at line 482 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< thread_cpu_util, std::pair< int64_t, int64_t > >::load().

Referenced by get_display().

get_display()

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

inlinenoexcept

Definition at line 490 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::thread_cpu_util::is_derived ( ) const

inlinenoexcept

Definition at line 539 of file components.hpp.

{ return m_derive; }

label()

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

inlinestatic

Definition at line 472 of file components.hpp.

{ return "thread_cpu_util"; }

operator+=()

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

inlinenoexcept

Definition at line 506 of file components.hpp.

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

operator-=()

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

inlinenoexcept

Definition at line 513 of file components.hpp.

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

record()

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

inlinestatic

Definition at line 478 of file components.hpp.

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

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

Referenced by start(), and stop().

serialization()

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

inlinenoexcept

Definition at line 489 of file components.hpp.

{ return get_display(); }

References get_display().

start()

void tim::component::thread_cpu_util::start ( )

inlinenoexcept

Definition at line 491 of file components.hpp.

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

References record().

stop()

void tim::component::thread_cpu_util::stop ( )

inlinenoexcept

Definition at line 496 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