【RustyML入门】1.5. Prelude与模块导入

1.5. Prelude与模块导入

1.5.1. 把名字引入作用域的三种方式

从prelude导入全部内容

userustyml::prelude::*;

这会把所有的内容导入到当前作用域中，适合于快速上手写代码，不需要去找内容的具体位置。

从prelude选择特定模块的内容引入

prelude拆成四个子模块，可以按需导入：

userustyml::prelude::machine_learning::*;// 经典机器学习估计器、trait和共享枚举userustyml::prelude::neural_network::*;// Sequential、History、Tensor、层、损失函数、优化器userustyml::prelude::metrics::*;// 评估指标函数和类型userustyml::prelude::utils::*;// standardize、normalize、缩放器、编码器、划分

当你写的文件明显只属于一个领域时，就用这种写法。

通过精确路径来导入

use rustyml::machine_learning::LinearRegression; use rustyml::traits::{Fit, Predict}; use rustyml::metrics::r2_score;

长期维护的库代码应该优先用这种。

1.5.2. prelude重新导出了什么

prelude是一份手工挑选的清单，它只重导出常用的内容，下面的表格展示了prelude下不同模块重导出的具体内容。

机器学习

神经网络

注意RMSprop的大小写（小写的p）。激活函数有两种写法：一种是调用独立层ReLU/Softmax/Linear/Sigmoid/Tanh。另一种是在支持输入Activation枚举的层里选择一个变体（Activation::ReLU、Activation::Softmax、Activation::Linear、Activation::Sigmoid、Activation::Tanh）或者用一个独立激活层作为输入（它们impl Layer并可Into<Activation>）。

举个例子：Dense::new的一个参数是activation: impl Into<Activation>，你既可以传进去一个Activation枚举的变体，也可以传进去一个独立激活层：Dense::new(3, 8, Activation::ReLU)与Dense::new(3, 8, ReLU::new())等价。

评估指标

和其余模块的错误传播设计不同，指标函数在遇到错误时会直接panic，这是为了保持轻量所设置的，详见5. 模型评估。参数顺序是(y_true, y_pred)，与scikit-learn一致。

工具函数

1.5.3. Feature 开关决定 prelude 的内容

rustyml::prelude模块总会被编译，但每个子模块必须得在对应模块的feature开启之后才会出现。所以use rustyml::prelude::*不等于RustyML的所有内容，它等于的是你开启的feature的所有功能，每个feature的内容详见1.2 安装与 Feature 配置。

1.5.4. 使用全限路径

建议通过docs.rs/rustyml查看内容的具体位置，下面是主要类型的查找表：