struct ov::threading::IStreamsExecutor::Config

Overview

Defines IStreamsExecutor configuration. More…

#include <istreams_executor.hpp>

struct Config
{
    // enums

    enum PreferredCoreType;
    enum StreamMode;

    // fields

    std::string _name;
    int _streams = 1;
    int _threadsPerStream = 0;
    ThreadBindingType _threadBindingType = ThreadBindingType::NONE;
    int _threadBindingStep = 1;
    int _threadBindingOffset = 0;
    int _threads = 0;
    int _big_core_streams = 0;
    int _small_core_streams = 0;
    int _threads_per_stream_big = 0;
    int _threads_per_stream_small = 0;
    int _small_core_offset = 0;
    bool _enable_hyper_thread = true;
    int _plugin_task = NOT_USED;
    std::vector<std::vector<int>> _orig_proc_type_table;
    std::vector<std::vector<int>> _proc_type_table;
    std::vector<std::vector<int>> _streams_info_table;
    std::vector<std::vector<int>> _stream_core_ids;
    std::vector<int> _stream_ids;
    bool _cpu_pinning = false;
    bool _streams_changed = false;
    enum ov::threading::IStreamsExecutor::Config::PreferredCoreType _threadPreferredCoreType =             PreferredCoreType::ANY;

    // construction

    Config(
        std::string name = "StreamsExecutor",
        int streams = 1,
        int threadsPerStream = 0,
        ThreadBindingType threadBindingType = ThreadBindingType::NONE,
        int threadBindingStep = 1,
        int threadBindingOffset = 0,
        int threads = 0,
        PreferredCoreType threadPreferredCoreType = PreferredCoreType::ANY
        );

    // methods

    void set_property(const ov::AnyMap& properties);
    void set_property(const std::string& key, const ov::Any& value);
    ov::Any get_property(const std::string& key) const;

    static Config make_default_multi_threaded(
        const Config& initial,
        const bool fp_intesive = true
        );

    static int get_default_num_streams(const bool enable_hyper_thread = true);

    static int get_hybrid_num_streams(
        std::map<std::string, std::string>& config,
        const int stream_mode
        );

    static void update_hybrid_custom_threads(Config& config);
};

// direct descendants

struct Config;

Detailed Documentation

Defines IStreamsExecutor configuration.

Fields

std::string _name

Used by ITT to name executor threads.

int _streams = 1

Number of streams.

int _threadsPerStream = 0

Number of threads per stream that executes ov_parallel calls.

ThreadBindingType _threadBindingType = ThreadBindingType::NONE

Thread binding to hardware resource type. No binding by default

int _threadBindingStep = 1

In case of CORES binding offset type thread binded to cores with defined step

int _threadBindingOffset = 0

In case of CORES binding offset type thread binded to cores starting from offset

int _threads = 0

Number of threads distributed between streams. Reserved. Should not be used.

int _big_core_streams = 0

Number of streams in Performance-core(big core)

int _small_core_streams = 0

Number of streams in Efficient-core(small core)

int _threads_per_stream_big = 0

Threads per stream in big cores.

int _threads_per_stream_small = 0

Threads per stream in small cores.

int _small_core_offset = 0

Calculate small core start offset when binding cpu cores.

bool _enable_hyper_thread = true

enable hyper thread

enum ov::threading::IStreamsExecutor::Config::PreferredCoreType _threadPreferredCoreType =             PreferredCoreType::ANY

In case of HYBRID_AWARE hints the TBB to affinitize.

Construction

Config(
    std::string name = "StreamsExecutor",
    int streams = 1,
    int threadsPerStream = 0,
    ThreadBindingType threadBindingType = ThreadBindingType::NONE,
    int threadBindingStep = 1,
    int threadBindingOffset = 0,
    int threads = 0,
    PreferredCoreType threadPreferredCoreType = PreferredCoreType::ANY
    )

A constructor with arguments.

Parameters:

name	The executor name
streams	Number of streams.
threadsPerStream	Number of threads per stream that executes ov_parallel calls.
threadBindingType
threadBindingStep
threadBindingOffset
threads
threadPreferBigCores

Methods

void set_property(const ov::AnyMap& properties)

Sets configuration.

Parameters:

properties

map of properties

void set_property(const std::string& key, const ov::Any& value)

Sets configuration.

Parameters:

key	property name
value	property value

ov::Any get_property(const std::string& key) const

Return configuration value.

Parameters:

key	configuration key

Returns:

configuration value wrapped into ov::Any

static Config make_default_multi_threaded(
    const Config& initial,
    const bool fp_intesive = true
    )

Create appropriate multithreaded configuration filing unconfigured values from initial configuration using hardware properties.

Parameters:

initial	Inital configuration
fp_intesive	additional hint for the the (Hybrid) core-types selection logic whether the executor should be configured for floating point intensive work (as opposite to int8 intensive)

Returns:

configured values