mindspore.hal.get_device_properties

mindspore.hal.get_device_properties(device_id, device_target=None)[source]

Get specified device's properties.

Note

If device_target is not specified, get the device properties of the current backend set by context. For Ascend, backend must be initialized before calling this method, or total_memory and free_memory will be 0, and device_id will be ignored since this method only returns current device's properties.

Parameters
  • device_id (int) – The device id of which the properties will be returned.

  • device_target (str, optional) – The device name of backend, should be one of "CPU", "GPU" and "Ascend".

Returns

  • cudaDeviceProp for GPU.

    cudaDeviceProp {
        name(str),
        major(int),
        minor(int),
        is_multi_gpu_board(int),
        is_integrated(int),
        multi_processor_count(int),
        total_memory(int),
        warp_size(int)
    }
    
  • AscendDeviceProperties for Ascend.

    AscendDeviceProperties {
        name(str),
        total_memory(int),
        free_memory(int)
    }
    
  • None for CPU.

Examples

>>> import mindspore as ms
>>> device_target = ms.context.get_context("device_target")
>>> print(ms.hal.get_device_properties(0, device_target))