fhelium.runtime.topology

Observe host CPU and process-visible CUDA topology.

CpuTopology

class View source

CpuTopology(architecture: str, model: str, logical_processor_count: int | None, physical_core_count: int | None, package_count: int | None)

Describe the host CPU model, processor counts, and package count.

Attributes

Name	Type	Default/value
architecture	str
model	str
logical_processor_count	int | None
physical_core_count	int | None
package_count	int | None

probe

method

def probe() -> CpuTopology: ...

Observe CPU topology through psutil and platform facilities.

as_dict

method

def as_dict() -> dict[str, object]: ...

Return a serializable representation of the CPU topology.

CudaDeviceInfo

class View source

CudaDeviceInfo(device: torch.device, name: str, uuid: str, pci_domain_id: int, pci_bus_id: int, pci_device_id: int, compute_capability: tuple[int, int], total_memory_bytes: int, multiprocessor_count: int, warp_size: int, l2_cache_bytes: int, memory_bus_width_bits: int, core_clock_khz: int, memory_clock_khz: int, max_threads_per_block: int, max_threads_per_multiprocessor: int, shared_memory_per_block_bytes: int, shared_memory_per_multiprocessor_bytes: int)

Describe one process-visible CUDA device and its hardware properties.

Attributes

Name	Type	Default/value
device	torch.device
name	str
uuid	str
pci_domain_id	int
pci_bus_id	int
pci_device_id	int
compute_capability	tuple[int, int]
total_memory_bytes	int
multiprocessor_count	int
warp_size	int
l2_cache_bytes	int
memory_bus_width_bits	int
core_clock_khz	int
memory_clock_khz	int
max_threads_per_block	int
max_threads_per_multiprocessor	int
shared_memory_per_block_bytes	int
shared_memory_per_multiprocessor_bytes	int

probe

method

def probe(index: int) -> CudaDeviceInfo: ...

Observe one CUDA device by its process-visible index.

as_dict

method

def as_dict() -> dict[str, object]: ...

Return a serializable representation of the CUDA device.

CudaTopology

class View source

CudaTopology(devices: tuple[CudaDeviceInfo, ...], peer_access: tuple[tuple[bool, ...], ...])

Describe process-visible CUDA devices and directional peer access.

Attributes

Name	Type	Default/value
devices	tuple[CudaDeviceInfo, ...]
peer_access	tuple[tuple[bool, ...], ...]

probe

method

def probe() -> CudaTopology: ...

Observe CUDA inventory and peer access without bandwidth tests.

as_dict

method

def as_dict() -> dict[str, object]: ...

Return a serializable representation of the CUDA topology.