pull

Author: Ricardo-shuo-liu

_typos.toml

@@ -28,14 +28,12 @@ datas = "datas"
 processer = "processer"
 
 # These words need to be fixed
-Creenshot = "Creenshot"
 Learing = "Learing"
 Moible = "Moible"
 Operaton = "Operaton"
 Optimizaing = "Optimizaing"
 Optimzier = "Optimzier"
 Setment = "Setment"
-Similarily = "Similarily"
 Simle = "Simle"
 Sovler = "Sovler"
 feeded = "feeded"
@@ -60,11 +58,9 @@ intput = "intput"
 lable = "lable"
 learing = "learing"
 legth = "legth"
-lengthes = "lengthes"
 lenth = "lenth"
 leran = "leran"
 libary = "libary"
-likey = "likey"
 mantained = "mantained"
 matrics = "matrics"
 mdule = "mdule"
@@ -87,7 +83,6 @@ outpus = "outpus"
 overrided = "overrided"
 overwrited = "overwrited"
 samle = "samle"
-satifies = "satifies"
 schedual = "schedual"
 secenarios = "secenarios"
 sematic = "sematic"

docs/api/paddle/Overview_cn.rst

@@ -636,6 +636,8 @@ device 相关
 
     " :ref:`paddle.get_cuda_rng_state <cn_api_paddle_get_cuda_rng_state>` ", "获取 cuda 随机数生成器的状态信息"
     " :ref:`paddle.set_cuda_rng_state <cn_api_paddle_set_cuda_rng_state>` ", "设置 cuda 随机数生成器的状态信息"
+    " :ref:`paddle.get_default_device <cn_api_paddle_get_default_device>` ", "获取当前默认设备信息"
+    " :ref:`paddle.get_device_module <cn_api_paddle_get_device_module>` ", "获取指定设备对应的模块"
 
 .. _about_hapi:
 

docs/api/paddle/cuda/Overview_cn.rst

@@ -16,8 +16,15 @@ PyTorch 兼容函数
 
     " :ref:`check_error <cn_api_paddle_cuda_check_error>` ", "检测 CUDA 错误码"
     " :ref:`cudart <cn_api_paddle_cuda_cudart>` ", "以模块的形式返回 CUDA Runtime 对象"
+    " :ref:`current_stream <cn_api_paddle_cuda_current_stream>` ", "获取当前 CUDA 流"
+    " :ref:`get_device_properties <cn_api_paddle_cuda_get_device_properties>` ", "获取 CUDA 设备属性"
+    " :ref:`get_rng_state <cn_api_paddle_cuda_get_rng_state>` ", "获取随机数生成器状态"
+    " :ref:`is_available <cn_api_paddle_cuda_is_available>` ", "检查 CUDA 是否可用"
     " :ref:`is_initialized <cn_api_paddle_cuda_is_initialized>` ", "判断 CUDA 是否已经初始化"
+    " :ref:`manual_seed_all <cn_api_paddle_cuda_manual_seed_all>` ", "设置全局随机种子"
     " :ref:`mem_get_info <cn_api_paddle_cuda_mem_get_info>` ", "获取指定设备上的全局空闲显存和显存总量"
+    " :ref:`set_rng_state <cn_api_paddle_cuda_set_rng_state>` ", "设置随机数生成器状态"
+    " :ref:`synchronize <cn_api_paddle_cuda_synchronize>` ", "同步 CUDA 设备"
     " :ref:`current_device <cn_api_paddle_cuda_current_device>` ", "返回当前设备的索引"
     " :ref:`device_count <cn_api_paddle_cuda_device_count>` ", "返回可用的 CUDA 设备数量"
     " :ref:`empty_cache <cn_api_paddle_cuda_empty_cache>` ", "释放当前设备上所有未占用的缓存内存"

docs/api/paddle/cuda/current_stream_cn.rst

@@ -0,0 +1,25 @@
+.. _cn_api_paddle_cuda_current_stream:
+
+current_stream
+-------------------------------
+
+.. py:function:: paddle.cuda.current_stream(device=None)
+
+该功能用于获取指定 CUDA 设备上当前正在使用的计算流（Stream）。
+
+参数
+:::::::::
+    - **device** (int | str | CUDAPlace | CustomPlace | None，可选) – 指定需要查询的设备。
+        - None：获取当前设备上的默认计算流。
+        - int：设备索引，例如 0 表示 cuda:0。
+        - str：设备字符串，例如 'cuda:0' 或 'gpu:1'。
+        - CUDAPlace：Paddle 的 CUDAPlace 对象。
+        - CustomPlace：Paddle 的自定义设备 Place 对象。
+
+返回
+:::::::::
+core.CUDAStream，当前设备对应的 CUDA 计算流对象。
+
+代码示例
+:::::::::
+COPY-FROM: paddle.cuda.current_stream

docs/api/paddle/cuda/get_device_properties_cn.rst

@@ -0,0 +1,25 @@
+.. _cn_api_paddle_cuda_get_device_properties:
+
+get_device_properties
+-------------------------------
+
+.. py:function:: paddle.cuda.get_device_properties(device=None)
+
+获取 CUDA 设备的属性信息。
+
+参数
+:::::::::
+- **device** (int | str | paddle.CUDAPlace | paddle.CustomPlace | None, 可选) - 要查询的目标设备:
+
+  - None: 使用当前设备
+  - int: 设备索引 (例如: 0 -> 'gpu:0')
+  - str: 设备字符串 (例如: "cuda:0", "gpu:1")
+  - CUDAPlace 或 CustomPlace: Paddle 设备对象
+
+返回
+:::::::::
+DeviceProperties: 包含设备属性的对象，如名称、总内存、计算能力和多处理器数量等。
+
+代码示例
+::::::::::::
+COPY-FROM: paddle.cuda.get_device_properties

docs/api/paddle/cuda/get_rng_state_cn.rst

@@ -0,0 +1,23 @@
+.. _cn_api_paddle_cuda_get_rng_state:
+
+get_rng_state
+-------------------------------
+
+.. py:function:: paddle.cuda.get_rng_state(device=None)
+
+返回指定设备的随机数生成器状态，以 GeneratorState 形式表示。
+
+参数
+:::::::::
+- **device** (DeviceLike, 可选) - 要获取 RNG 状态的设备:
+
+  - 如果不指定，则使用当前默认设备(由 paddle.framework._current_expected_place_()返回)
+  - 可以是设备对象、整数设备 ID 或设备字符串
+
+返回
+:::::::::
+core.GeneratorState: 指定设备的当前 RNG 状态，以 GeneratorState 形式表示。
+
+代码示例
+::::::::::::
+COPY-FROM: paddle.cuda.get_rng_state

docs/api/paddle/cuda/is_available_cn.rst

@@ -0,0 +1,22 @@
+.. _cn_api_paddle_cuda_is_available:
+
+is_available
+-------------------------------
+
+.. py:function:: paddle.cuda.is_available()
+
+检查当前环境中是否有任何支持的设备可用。
+
+该函数检查 Paddle 是否编译了至少一种加速器支持（如 CUDA、XPU、CustomDevice 等），
+以及当前系统是否有至少一个该类型的设备可用。
+
+如果有任何支持的设备可用，则返回 True，否则返回 False。
+
+返回
+:::::::::
+bool: 如果有至少一个可用设备（GPU/XPU/CustomDevice）则返回 True，否则返回 False。
+
+
+代码示例
+::::::::::::
+COPY-FROM: paddle.cuda.is_available

docs/api/paddle/cuda/manual_seed_all_cn.rst

@@ -0,0 +1,20 @@
+.. _cn_api_paddle_cuda_manual_seed_all:
+
+manual_seed_all
+-------------------------------
+
+.. py:function:: paddle.cuda.manual_seed_all(seed)
+
+设置全局默认随机数生成器的种子值，用于管理随机数生成。
+
+参数
+:::::::::
+- **seed** (int) - 要设置的随机种子值
+
+返回
+:::::::::
+None
+
+代码示例
+::::::::::::
+COPY-FROM: paddle.cuda.manual_seed_all

docs/api/paddle/cuda/set_rng_state_cn.rst

@@ -0,0 +1,24 @@
+.. _cn_api_paddle_cuda_set_rng_state:
+
+set_rng_state
+-------------------------------
+
+.. py:function:: paddle.cuda.set_rng_state(new_state, device=None)
+
+设置指定设备的随机数生成器状态。
+
+参数
+:::::::::
+- **new_state** (core.GeneratorState) - 要设置的 RNG 状态对象，通常从 ``get_rng_state()`` 获取
+- **device** (DeviceLike, 可选) - 要设置 RNG 状态的设备:
+
+  - 如果不指定，则使用当前默认设备(由 ``paddle.framework._current_expected_place_()`` 返回)
+  - 可以是设备对象、整数设备 ID 或设备字符串
+
+返回
+:::::::::
+None
+
+代码示例
+:::::::::
+COPY-FROM: paddle.cuda.set_rng_state

docs/api/paddle/cuda/synchronize_cn.rst

@@ -0,0 +1,24 @@
+.. _cn_api_paddle_cuda_synchronize:
+
+synchronize
+
+.. py:function:: paddle.cuda.synchronize(device=None)
+
+该功能用于同步指定 CUDA 设备上的计算流，确保所有在该设备上提交的计算任务执行完成。
+
+参数
+:::::::::
+    - **device** (int | str | CUDAPlace | CustomPlace | None, optional) – 指定需要同步的设备。
+        - None：同步当前设备上的计算流。
+        - int：设备索引，例如 0 表示 cuda:0。
+        - str：设备字符串，例如 'cuda:0' 或 'gpu:0'。
+        - CUDAPlace：Paddle 的 CUDAPlace 对象。
+        - CustomPlace：Paddle 的自定义设备 Place 对象。
+
+返回
+:::::::::
+无。
+
+代码示例
+:::::::::
+COPY-FROM: paddle.cuda.synchronize