本页采用了机器翻译。点击此处可查看英文原文。

gpuDeviceTable

R2026b

GPU 设备属性

全页折叠

    语法

    tbl = gpuDeviceTable
    tbl = gpuDeviceTable(props)

    描述

    tbl = gpuDeviceTable 会返回一个包含本地计算机中检测到的所有 GPU 设备属性的表。该表显示了系统中检测到的每个 GPU 设备的 Index、Name、ComputeCapability、DeviceAvailable 和 DeviceSelected 属性的值。表的每一行包含单个 GPU 设备的属性。

    示例

    tbl = gpuDeviceTable(props) 返回自定义的属性表。props 的每个元素必须是 gpuDevice 返回的属性之一。使用此语法来查询和比较系统中 GPU 设备的特定属性，例如 AvailableMemory。

    示例

    示例

    全部折叠

    使用 gpuDeviceTable 可以一目了然地查询和比较系统中所有 GPU 的属性。

    tbl = gpuDeviceTable
    tbl =

  2×5 table

    Index           Name           ComputeCapability    DeviceAvailable    DeviceSelected
    _____    __________________    _________________    _______________    ______________

      1      "NVIDIA RTX A5000"          "8.6"               true              true      
      2      "NVIDIA RTX A5000"          "8.6"               true              false

    这两种设备均可供本次 MATLAB® 会话使用。所选 GPU 设备（索引为 1）比索引为 2 的设备具有更高的计算能力。

    或者，您可以确定有多少 GPU 设备可用，检查它们的某些属性，然后在“并行”面板 的“GPU 环境”部分选择要使用的设备。

    The Parallel panel, including the GPU Environment section showing a GPU device.

    使用 gpuDeviceTable 查询并比较系统中所有 GPU 的具体属性。

    比较系统中 GPU 设备的计算能力、总内存、多处理器数量和可用性。

    tbl = gpuDeviceTable(["Index","ComputeCapability",...
   "TotalMemory","MultiprocessorCount","DeviceAvailable"])
    tbl =

  2×5 table

    Index    ComputeCapability    TotalMemory    MultiprocessorCount    DeviceAvailable
    _____    _________________    ___________    ___________________    _______________

      1            "8.6"          2.5295e+10             64                  true      
      2            "8.6"          2.5295e+10             64                  true

    输入参数

    全部折叠

    GPU 设备属性，指定为字符串数组或字符向量元胞数组。props 的每个元素必须是 gpuDevice 返回的属性之一。

    输出表的变量是 props 指定的属性，顺序与 props 中提供的顺序相同。

    示例: ["Name","ComputeCapability","AvailableMemory"]

    数据类型: char | string | cell

    输出参量

    全部折叠

    GPU 设备属性表，以表形式返回。

    tbl 的默认变量是 Index、Name、ComputeCapability、DeviceAvailable 和 DeviceSelected。如果指定 props 参量，则输出表仅包含指定的属性。

    提示

    • 要查询远程 GPU 的属性，请使用您的集群启动一个并行池，然后在 spmd 模块内调用 gpuDeviceTable。

      cluster = parcluster("myRemoteGPUCluster");
pool = parpool(cluster);

spmd
  tbl = gpuDeviceTable
end

      有关使用远程 GPU 的更多信息，请参阅 使用远程 GPU。

    扩展功能

    全部展开

    版本历史记录

    在 R2021a 中推出

    另请参阅

    | |

    主题