R モデルの作成

[アーティクル]
05/06/2019

重要

Machine Learning Studio (クラシック) のサポートは、2024 年 8 月 31 日に終了します。その日までに、Azure Machine Learning に切り替えすることをお勧めします。

2021 年 12 月 1 日以降、新しい Machine Learning Studio (クラシック) リソースは作成できません。 2024 年 8 月 31 日まで、既存の Machine Learning Studio (クラシック) リソースを引き続き使用できます。

ML Studio (クラシック) から Azure Machine Learning への機械学習プロジェクトの移動に関する情報を参照してください。
Azure Machine Learning についての詳細を参照してください。

ML Studio (クラシック) のドキュメントは廃止予定であり、今後更新されない可能性があります。

カスタムリソースを使用して R モデルを作成します

カテゴリ: データ変換/操作

注意

適用対象: Machine Learning Studio (クラシック) のみ

類似のドラッグアンドドロップモジュールは Azure Machine Learning デザイナーで使用できます。

モジュールの概要

この記事では、Machine Learning Studio (クラシック) で R モデルの作成モジュールを使用して、R スクリプトからトレーニングされていないモデルを作成する方法について説明します。

モデルは、R パッケージに含まれる任意の学習器を基に、Machine Learningできます。

モデルを作成した後は、[モデルのトレーニング] を使用して、データセットでモデルをトレーニングできます(他の学習ツールと同様にMachine Learning。トレーニング済みのモデルをモデルのスコア付けに渡し、予測を行うために使用できます。その後、トレーニング済みモデルは保存でき、スコアリングワークフローは Web サービスとして発行できます。

警告

現時点では、R モデルのスコア付けされた結果をモデルの評価またはモデルのクロス検証に渡す必要があります。モデルを評価する必要がある場合は、カスタム R スクリプトを記述し、R スクリプトの実行モジュールを使用して実行できます。

R モデルの作成を使用してカスタム R モジュールを保存および再使用する以外に、R を使用してモデリングとデータ管理プロセスの独自の実装を作成し、zip 形式でファイルをワークスペースにアップロードしてから、パッケージをカスタムモジュールとして登録することができます。詳細については、「カスタム R モジュール」を参照してください。

R モデルの作成を構成する方法

このモジュールを使用するには、R に関する中級または専門家の知識が必要です。このモジュールでは、このモジュールに既にインストールされている R パッケージに含まれているすべての学習器の使用Machine Learning。

Azure AI Galleryのこのサンプルでは、一般的なパッケージ + Create R Model を使用して、2 クラスの Naïve Bayes e1070 分類子を実装しています。例をワークスペースにコピーし、それに従って実行することをお勧めします。

次のモジュールを実験に追加します: R モデルの作成、モデルのトレーニング、モデルのスコア付け。
[R モデルの作成 ] の [プロパティ] ウィンドウで、次のスクリプトを指定します。
- トレーナー R スクリプト: ここで指定する R スクリプトは、モデルのトレーニングに使用されます。実験を実行すると、モデルのトレーニングモジュールにデプロイされます。
- スコアラー R スクリプト: この入力で指定する R スクリプトは、スコアリング専用です。実験を実行すると、モデルのスコア付けモジュールにデプロイされます。
サンプル実験には、モデル評価用のグラフをプロットするために使用される Python スクリプトの実行モジュールも含まれます。このモジュールは、Web サービスに発行する場合は省略可能ですが、実験を開発する場合に便利です。
- Python スクリプトからグラフを表示するには、Python モジュールを右クリックし、[ Python デバイス] を選択して、[視覚化] を選択 します。
- モデルメトリックを表示するには、Python モジュールを右クリックし、[ Python データセット] を選択して、[視覚化] を選択 します。
オプションの Python モジュールのコードについては、モデル評価のための Python モジュールに関するページを参照してください。

トレーニングスクリプト

次の例は、Trainer R スクリプトで使用できるコードの 種類を示しています。

このスクリプトは、R パッケージを読み込み、パッケージから学習器を使用してモデルを作成し、 R モデルの作成に関するページで提供されている定義済みの定数と関数を使用して特徴列とラベル列を構成します。

library(e1071)
features <- get.feature.columns(dataset)
labels   <- as.factor(get.label.column(dataset))
train.data <- data.frame(features, labels)
feature.names <- get.feature.column.names(dataset)
names(train.data) <- c(feature.names, "Class")
model <- naiveBayes(Class ~ ., train.data)

最初の行では、使用する単純ベイズ分類子アルゴリズムを含む R パッケージ e1071 が読み込まれます。これは、Machine Learning 環境にプレインストールされているパッケージの 1 つで、パッケージをダウンロードまたはインストールする必要は一度も必要とされません。

次の行では、データセットから特徴列とラベル列を取得し、それらをという名前の新しい R データフレームに結合します train.data。

features <- get.feature.columns(dataset)   
labels <- as.factor(get.label.column(dataset))   
train.data <- data.frame(features, labels)
feature.names <- get.feature.column.names(dataset)

次の定義済み関数の使用に注意してください。
- get.label.columns() は、モデルのトレーニングモジュールでクラスラベルとして選択されている列を返します。
- get.feature.columns()は、データセット内の特徴として指定された列を選択します。
  
  既定では、ラベル列を除くすべての列は、Studio (クラシック) の機能と見なされます。そのため、特定の列を特徴としてマークするには、メタデータの編集を使用するか、R スクリプト内の列のセットを選択します。
- get.feature.column.names(dataset) データセットから特徴列名を取得します。
結合されたデータセットの名前は、 train.dataの列の名前として指定され、ラベル列の一 Class 時名が作成されます。
```
names(train.data) <- c(feature.names, "Class")
```
コードの最後の行では、Naïve Bayes 分類子アルゴリズムを、データフレーム内の変数 (特徴) と結果 (ラベル) train.data の関数として定義します。
```
model <- naiveBayes(Class ~ ., train.data)
```
モデルの作成、トレーニング、スコア付けスクリプト全体で、変数名を使用する必要があります model。

スコアリングスクリプト

次のコードは、Scorer R スクリプトで指定する R コード の種類を示しています。

library(e1071)
probabilities <- predict(model, dataset, type="raw")[,2]
classes <- as.factor(as.numeric(probabilities >= 0.5))
scores <- data.frame(classes, probabilities)

最初の行では、パッケージが読み込まれます。
2 行目は、必要な変数名で指定されたトレーニングスクリプトのトレーニング済みモデルを使用して、スコア付けデータセットの予測確率を計算します model。
3 行目では、予測されたクラスラベルを割り当てるときに、確率に 0.5 のしきい値を適用します。
最後の行は、出力データフレーム scores にクラスラベルと確率を結合します。
モデルのスコア付けモジュールに渡されるデータフレームの名前はである必要があります scores。

省略可能な Python 評価スクリプト

次のサンプル実験にはAzure AI Gallery Python スクリプトが含まれています。このスクリプトは、モデル評価のメトリックとグラフを生成するために使用されます。

def azureml_main(dataframe):
    import matplotlib
    matplotlib.use("agg")
    
    from sklearn.metrics import accuracy_score, precision_score, recall_score, roc_auc_score, roc_curve
    import pandas as pd
    import numpy as np
    import matplotlib.pyplot as plt
    
    scores = dataframe.ix[:, ("Class", "classes", "probabilities")]
    ytrue = scores["Class"]
    ypred = np.array([float(val) for val in scores["classes"]])    
    probabilities = scores["probabilities"]
    
    accuracy, precision, recall, auc = \
    accuracy_score(ytrue, ypred),\
    precision_score(ytrue, ypred),\
    recall_score(ytrue, ypred),\
    roc_auc_score(ytrue, probabilities)
    
    metrics = pd.DataFrame();
    metrics["Metric"] = ["Accuracy", "Precision", "Recall", "AUC"];
    metrics["Value"] = [accuracy, precision, recall, auc]

# Plot ROC Curve
    fpr, tpr, thresholds = roc_curve(ytrue, probabilities)
    fig = plt.figure()
    axis = fig.gca()
    axis.plot(fpr, tpr, linewidth=8)
    axis.grid("on")
    axis.set_xlabel("False positive rate")
    axis.set_ylabel("True positive rate")
    axis.set_title("ROC Curve")
    fig.savefig("roc.png")

    return metrics,

カスタム R モデルワークフローを Web サービスとして発行する

実験を実行したら、完全な実験を Web サービスとして発行できます。

Studio (クラシック) の実験から Web サービスを作成する方法の更新された手順については、「チュートリアル手順 5: Web サービスをMachine Learningする」を参照してください。

既定では、Web サービスには、ラベル列を含む、指定するトレーニングデータのすべての入力列が必要です。入力データソースとモデルのスコア付けモジュールの間に Select Columns in Dataset のインスタンスを追加して、予測しようとしているラベルを除外できます。

テクニカルノート

R モデルの作成モジュールでは 、CRAN R の使用のみをサポートしています。別のバージョンの R を選択したり、Microsoft R Open を使用したりすることはできません。
モジュールの最初の実行後にモデルはキャッシュされ、入力スクリプト内のすべての変更が完了するまで、後続の実行でそのモジュールは呼び出されません。 R スクリプトで次のいずれかを使用する場合、この動作を考慮に入れてください。
- 乱数を生成する関数
- 乱数を生成する関数
- その他の不明確な関数
このモジュールで作成されたカスタム R モデルは、次のモジュールでは使用できません。
R モデルはカテゴリ別のデータの特徴の正規化や不足値の処理を自動的には実行しません。このような変数の処理は、トレーニングおよびスコア付け R スクリプト内で行う必要があります。

定義済み関数の表

使用法	説明
`get.feature.columns(dataset)`	すべての特徴列を取得します。
`get.label.column(dataset, label.type=TrueLabelType)`	型を指定して、ラベル列を取得します。利用可能な型の一覧については、「定数」セクションを参照してください。
`get.label.column.names(dataset)`	すべてのラベル列の名前を取得します。
`get.label.column.name(dataset, label.type=TrueLabelType)`	型を指定して、ラベル列の名前を取得します。利用可能な型の一覧については、「定数」セクションを参照してください。
`get.label.column.types(dataset)`	すべてのラベル列の型を取得します。
`get.feature.column.names(dataset)`	すべての特徴列の名前を取得します。
`dataset < - set.score.column(dataset, score.type, column.name)`	型を指定して、スコア列を設定します。利用可能な型の一覧については、「定数」セクションを参照してください。
`dataset < - set.feature.channel(dataset, channel.name, column.names)`	名前を指定して、特徴チャネルを設定します。利用可能な名前の一覧については、「定数」セクションを参照してください。

定義済みの定数の表

定数	説明
TrueLabelType	True のラベル列の型
ScoredLabelType	スコア付けされたラベル列の型
RawScoreType	生のスコア列の型
CalibratedScoreType	調整されたスコア列の型
ScoredProbabilitiesMulticlassColumnTypePattern	多クラス分類器に対して、スコア付けされた確率列の型を準備するパターン
BayesianLinearRegressionScoresFeatureChannel	ベイジアン線形回帰のスコアを持つ特徴チャネルの名前
BinaryClassificationScoresFeatureChannel	バイナリ分類のスコアを持つ特徴チャネルの名前
MulticlassClassificationScoresFeatureChannel	多クラス分類のスコアを持つ特徴チャネルの名前
OrdinalRegressionScoresFeatureChannel	順序回帰のスコアを持つ、特徴チャネルの名前
RegressionScoresFeatureChannel	回帰のスコアを持つ、特徴チャネルの名前

例

機械学習の実験でこのモジュールを使用する方法のその他の例については、次のAzure AI Gallery。

想定される入力

名前	型	説明
トレーナー R スクリプト	スクリプト	データセットを入力として受け取り、未トレーニングモデルを出力する R スクリプト。
スコア R スクリプト	スクリプト	モデルおよびデータセットを入力として受け取り、スクリプトで指定したスコアを出力する R スクリプト。

出力

名前	型	説明
モデル	ILearner インターフェイス	未トレーニングモデル

こちらもご覧ください

R スクリプトの実行
 R 言語モジュール

次の方法で共有

R モデルの作成

モジュールの概要

R モデルの作成を構成する方法

トレーニングスクリプト

スコアリングスクリプト

省略可能な Python 評価スクリプト

カスタム R モデルワークフローを Web サービスとして発行する

テクニカルノート

定義済み関数の表

定義済みの定数の表

例

想定される入力

出力

こちらもご覧ください

その他のリソース

次の方法で共有

R モデルの作成

モジュールの概要

R モデルの作成を構成する方法

トレーニング スクリプト

スコアリング スクリプト

省略可能な Python 評価スクリプト

カスタム R モデル ワークフローを Web サービスとして発行する

テクニカル ノート

定義済み関数の表

定義済みの定数の表

例

想定される入力

出力

こちらもご覧ください

その他のリソース

トレーニングスクリプト

スコアリングスクリプト

カスタム R モデルワークフローを Web サービスとして発行する

テクニカルノート