Session

Sat, 12 Jun 2021 00:00:00 -0500

A Session is the main object in a Lluvia application. It holds the references to the underlying device used for computation. To see the available devices, run:

1
2
3
4


import lluvia as ll

for device in ll.getAvailableDevices():
 print(device)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


#include <lluvia/core.h>

#include <iostream>

int main() {

 const auto availableDevices = ll::Session::getAvailableDevices();

 for(auto deviceDesc : availableDevices) {

 std::cout << "ID: " << deviceDesc.id
 << " type: " << ll::deviceTypeToString(std::forward<ll::DeviceType>(deviceDesc.deviceType))
 << " name: " << deviceDesc.name << std::endl;
 }

 return 0;
}

and the output can look like:

Memory

Sat, 12 Jun 2021 00:00:00 -0500

Memory objects represent regions of memory that can be used to allocate objects. Lluvia uses the memory types defined by the Vulkan API. You may also refer to this article by Adam Sawicki on how memory is offered by different GPU vendors.

Memory types

Memory objects are created from a Lluvia Session. The code block below enumerate the available memory options:

1
2
3
4
5
6
7
8


import lluvia as ll

session = ll.createSession(enableDebug=True)

for n, memflags in enumerate(session.getSupportedMemoryPropertyFlags()):
 print('Memory index:', n)
 print(' supported flags:', [p.name for p in memflags])
 print()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


#include <iostream>
#include "lluvia/core.h"

#include <vulkan/vulkan.hpp>

int main() {
 
 ll::SessionDescriptor desc = ll::SessionDescriptor().enableDebug(true);

 std::shared_ptr<ll::Session> session = ll::Session::create(desc);

 std::vector<vk::MemoryPropertyFlags> flagsVector = session->getSupportedMemoryFlags();

 for(int i = 0; i < flagsVector.size(); ++i) {
 const vk::MemoryPropertyFlags &flags = flagsVector[i];
 
 std::cout << "Memory index: " << i << std::endl;
 std::cout << " Supported flags: " << vk::to_string(flags) << std::endl;
 }

 return 0;
}

Memory index: 0
 supported flags: ['DeviceLocal']

Memory index: 1
 supported flags: ['HostCoherent', 'HostVisible']

Memory index: 2
 supported flags: ['HostCached', 'HostCoherent', 'HostVisible']

Memory index: 3
 supported flags: ['DeviceLocal', 'HostCoherent', 'HostVisible']

The possible MemoryPropertyFlags values are:

Reference on Lluvia

Session

Memory

Memory types