NEML2 2.0.0
All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Friends Modules Pages
StaticHybridScheduler.h
1// Copyright 2024, UChicago Argonne, LLC
2// All Rights Reserved
3// Software Name: NEML2 -- the New Engineering material Model Library, version 2
4// By: Argonne National Laboratory
5// OPEN SOURCE LICENSE (MIT)
6//
7// Permission is hereby granted, free of charge, to any person obtaining a copy
8// of this software and associated documentation files (the "Software"), to deal
9// in the Software without restriction, including without limitation the rights
10// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11// copies of the Software, and to permit persons to whom the Software is
12// furnished to do so, subject to the following conditions:
13//
14// The above copyright notice and this permission notice shall be included in
15// all copies or substantial portions of the Software.
16//
17// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
23// THE SOFTWARE.
24
25#pragma once
26
27#include "neml2/dispatchers/WorkScheduler.h"
28
29namespace neml2
30{
38{
39public:
41 {
42 DeviceStatus(Device device, std::size_t batch_size, std::size_t capacity, double priority)
43 : device(device),
47 {
48 }
49
51 std::size_t batch_size;
52 std::size_t capacity;
53 double priority;
54 std::size_t load = 0;
55 };
56
59
62 StaticHybridScheduler(const OptionSet & options);
63
96 void setup() override;
97
99 void set_availability_calculator(std::function<double(const DeviceStatus &)>);
100
101 const std::vector<DeviceStatus> & status() const { return _devices; }
102
103 std::vector<Device> devices() const override { return _available_devices; }
104
105protected:
117 bool schedule_work_impl(Device &, std::size_t &) const override;
118 void dispatched_work_impl(Device, std::size_t) override;
119 void completed_work_impl(Device, std::size_t) override;
120 bool all_work_completed() const override;
121
122private:
124 std::vector<Device> _available_devices;
125
127 bool _cpu = false;
128
130 bool _cuda = false;
131
133 std::vector<DeviceStatus> _devices;
134
136 std::function<double(const DeviceStatus &)> _custom_availability_calculator;
137};
138} // namespace neml2
A custom map-like data structure. The keys are strings, and the values can be nonhomogeneously typed.
Definition OptionSet.h:52
bool schedule_work_impl(Device &, std::size_t &) const override
Pick the next device to dispatch work to.
Definition StaticHybridScheduler.cxx:146
void completed_work_impl(Device, std::size_t) override
Update the scheduler with the completion of the last batch.
Definition StaticHybridScheduler.cxx:183
StaticHybridScheduler(const OptionSet &options)
Construct from options.
Definition StaticHybridScheduler.cxx:56
const std::vector< DeviceStatus > & status() const
Definition StaticHybridScheduler.h:101
void dispatched_work_impl(Device, std::size_t) override
Update the scheduler with the dispatch of the last batch.
Definition StaticHybridScheduler.cxx:168
std::vector< Device > devices() const override
Device options.
Definition StaticHybridScheduler.h:103
void setup() override
Definition StaticHybridScheduler.cxx:63
static OptionSet expected_options()
Options for the scheduler.
Definition StaticHybridScheduler.cxx:36
bool all_work_completed() const override
Check if all work has been completed.
Definition StaticHybridScheduler.cxx:197
void set_availability_calculator(std::function< double(const DeviceStatus &)>)
Set a custom availability calculator.
Definition StaticHybridScheduler.cxx:140
WorkScheduler(const OptionSet &options)
Construct a new WorkScheduler object.
Definition WorkScheduler.cxx:39
Definition DiagnosticsInterface.cxx:30
c10::Device Device
Definition types.h:66
Definition StaticHybridScheduler.h:41
std::size_t load
Definition StaticHybridScheduler.h:54
DeviceStatus(Device device, std::size_t batch_size, std::size_t capacity, double priority)
Definition StaticHybridScheduler.h:42
std::size_t batch_size
Definition StaticHybridScheduler.h:51
std::size_t capacity
Definition StaticHybridScheduler.h:52
Device device
Definition StaticHybridScheduler.h:50
double priority
Definition StaticHybridScheduler.h:53