Main Content

mapreducer

为 mapreduce 或 tall 数组定义执行环境

说明

示例

mapreducer 在不带任何参数时,会将全局执行环境设置为默认值:一个并行池(如果有 Parallel Computing Toolbox™ 可用),或是一个本地 MATLAB® 会话。mapreducer 是一个配置函数,它可以改变 MATLAB 执行 mapreduce 算法和 tall 数组计算的方式。可以通过此函数来设置、更改或存储执行环境,以便使用 Parallel Computing Toolbox、MATLAB Parallel Server™MATLAB Compiler™。如果安装了 Parallel Computing Toolbox,则在使用 tallmapreduce 函数时,MATLAB 会自动启动工作进程的并行池(除非您更改了默认预设项)。

注意

如果没有可用的工具箱,则 mapreduce 算法和 tall 数组计算将使用本地 MATLAB 会话自动运行,无需使用 mapreducer 指定配置设置即可使用这些功能。但是,如果有 Parallel Computing Toolbox、MATLAB Parallel ServerMATLAB Compiler,则可使用 mapreducer 的更多配置选项对并行运行或已部署环境进行配置。

有关详细信息,请参阅 Parallel Computing Toolbox 文档中的 mapreducer (Parallel Computing Toolbox),或 MATLAB Compiler 文档中的 mapreducer (MATLAB Compiler)

mapreducer(0) 将全局执行环境设置为局部 MATLAB 会话。

mapreducer(mr) 使用以前创建的 MapReducer 对象 mr 设置全局执行环境。

mr = mapreducer(___) 支持上述任何语法,且可返回一个 MapReducer 对象。要显式指定执行环境,可使用 mr 作为 mapreduce 的第四个输入参数。

mr = mapreducer(___,'ObjectVisibility','Off') 切换 MapReducer 对象 mr 的可见性。可以使用此语法创建新的 MapReducer 对象,不会影响全局执行环境。

示例

全部折叠

命令

mapreducer

在 Parallel Computing Toolbox 可用的情况下自动启动并行池。否则,执行环境将设置为本地 MATLAB 会话。

您可以使用以下命令强制 MATLAB 使用本地会话

mapreducer(0)

要查询当前全局执行环境,请使用命令

gcmr

输出参数

全部折叠

执行环境,以 MapReducer 对象形式返回。

如果 mrObjectVisibility 属性设置为 'On'(默认值),则 mr 将定义所有 mapreduce 算法和 tall 数组计算的执行环境。您可以选择将 mr 传递给 mapreduce 函数以显式指定执行环境,即使其 ObjectVisibility 属性设置为 'Off'

提示

  • 处理 tall 数组时,可在使用 tall(ds) 创建 tall 数组之前使用 mapreducer 设置执行环境。tall 数组在构造时会限定在当前全局执行环境。如果之后更改了全局执行环境,tall 数组将变得无效,必须重新构造。

扩展功能

版本历史记录

在 R2014b 中推出