TextLoaderSaverCatalog.LoadFromTextFile メソッド

定義

オーバーロード

LoadFromTextFile(DataOperationsCatalog, String, TextLoader+Options)

を使用してTextLoaderテキスト ファイルから a IDataView を読み込みます。 IDataView's は遅延であるため、ここでは実際の読み込みは行われません。スキーマの検証だけです。

LoadFromTextFile(DataOperationsCatalog, String, TextLoader+Column[], Char, Boolean, Boolean, Boolean, Boolean)

を使用してTextLoaderテキスト ファイルから a IDataView を読み込みます。 IDataView's は遅延であるため、ここでは実際の読み込みは行われません。スキーマの検証だけです。

LoadFromTextFile<TInput>(DataOperationsCatalog, String, TextLoader+Options)

を使用してTextLoaderテキスト ファイルから a IDataView を読み込みます。 IDataView's は遅延であるため、ここでは実際の読み込みは行われません。スキーマの検証だけです。

LoadFromTextFile<TInput>(DataOperationsCatalog, String, Char, Boolean, Boolean, Boolean, Boolean)

を使用してTextLoaderテキスト ファイルから a IDataView を読み込みます。 IDataView's は遅延であるため、ここでは実際の読み込みは行われません。スキーマの検証だけです。

LoadFromTextFile(DataOperationsCatalog, String, TextLoader+Options)

を使用してTextLoaderテキスト ファイルから a IDataView を読み込みます。 IDataView's は遅延であるため、ここでは実際の読み込みは行われません。スキーマの検証だけです。

public static Microsoft.ML.IDataView LoadFromTextFile (this Microsoft.ML.DataOperationsCatalog catalog, string path, Microsoft.ML.Data.TextLoader.Options options = default);
static member LoadFromTextFile : Microsoft.ML.DataOperationsCatalog * string * Microsoft.ML.Data.TextLoader.Options -> Microsoft.ML.IDataView
<Extension()>
Public Function LoadFromTextFile (catalog As DataOperationsCatalog, path As String, Optional options As TextLoader.Options = Nothing) As IDataView

パラメーター

path
String

読み込み元のファイルまたはファイルのパスを指定します。

options
TextLoader.Options

読み込み操作の設定を定義します。

戻り値

using System;
using System.Collections.Generic;
using System.IO;
using Microsoft.ML;

namespace Samples.Dynamic
{
    public static class SaveAndLoadFromText
    {
        public static void Example()
        {
            // Create a new context for ML.NET operations. It can be used for
            // exception tracking and logging, as a catalog of available operations
            // and as the source of randomness. Setting the seed to a fixed number
            // in this example to make outputs deterministic.
            var mlContext = new MLContext(seed: 0);

            // Create a list of training data points.
            var dataPoints = new List<DataPoint>()
            {
                new DataPoint(){ Label = 0, Features = 4},
                new DataPoint(){ Label = 0, Features = 5},
                new DataPoint(){ Label = 0, Features = 6},
                new DataPoint(){ Label = 1, Features = 8},
                new DataPoint(){ Label = 1, Features = 9},
            };

            // Convert the list of data points to an IDataView object, which is
            // consumable by ML.NET API.
            IDataView data = mlContext.Data.LoadFromEnumerable(dataPoints);

            // Create a FileStream object and write the IDataView to it as a text
            // file.
            using (FileStream stream = new FileStream("data.tsv", FileMode.Create))
                mlContext.Data.SaveAsText(data, stream);

            // Create an IDataView object by loading the text file.
            IDataView loadedData = mlContext.Data.LoadFromTextFile("data.tsv");

            // Inspect the data that is loaded from the previously saved text file.
            var loadedDataEnumerable = mlContext.Data
                .CreateEnumerable<DataPoint>(loadedData, reuseRowObject: false);

            foreach (DataPoint row in loadedDataEnumerable)
                Console.WriteLine($"{row.Label}, {row.Features}");

            // Preview of the loaded data.
            // 0, 4
            // 0, 5
            // 0, 6
            // 1, 8
            // 1, 9
        }

        // Example with label and feature values. A data set is a collection of such
        // examples.
        private class DataPoint
        {
            public float Label { get; set; }

            public float Features { get; set; }
        }
    }
}

適用対象

LoadFromTextFile(DataOperationsCatalog, String, TextLoader+Column[], Char, Boolean, Boolean, Boolean, Boolean)

を使用してTextLoaderテキスト ファイルから a IDataView を読み込みます。 IDataView's は遅延であるため、ここでは実際の読み込みは行われません。スキーマの検証だけです。

public static Microsoft.ML.IDataView LoadFromTextFile (this Microsoft.ML.DataOperationsCatalog catalog, string path, Microsoft.ML.Data.TextLoader.Column[] columns, char separatorChar = '\t', bool hasHeader = false, bool allowQuoting = false, bool trimWhitespace = false, bool allowSparse = false);
static member LoadFromTextFile : Microsoft.ML.DataOperationsCatalog * string * Microsoft.ML.Data.TextLoader.Column[] * char * bool * bool * bool * bool -> Microsoft.ML.IDataView
<Extension()>
Public Function LoadFromTextFile (catalog As DataOperationsCatalog, path As String, columns As TextLoader.Column(), Optional separatorChar As Char = '\t', Optional hasHeader As Boolean = false, Optional allowQuoting As Boolean = false, Optional trimWhitespace As Boolean = false, Optional allowSparse As Boolean = false) As IDataView

パラメーター

path
String

ファイルへのパス。

columns
TextLoader.Column[]

スキーマの列。

separatorChar
Char

行内のデータ ポイント間の区切り記号として使用される文字。 既定では、タブ文字は区切り記号として使用されます。

hasHeader
Boolean

ファイルにヘッダーがあるかどうか。 この場合 true、ローダーは呼び出されたときに Load(IMultiStreamSource) 最初の行をスキップします。

allowQuoting
Boolean

入力に二重引用符で囲まれた値が含まれるかどうか。 このパラメーターは、入力値の区切り文字を実際の区切り文字と区別するために使用されます。 この場合 true、二重引用符内の区切り記号は入力値の一部として扱われます。 この場合 false、すべての区切り記号 (これらの白い引用符も含む) は、新しい列を区切るものとして扱われます。 また、空の値と欠損値を区別するためにも使用されます。 場合 true、欠損値は連続する区切り記号で示され、空の値は "" で示されます。 空の値は、連続する区切り記号と欠損値で示される場合 falseは、次に記載されている各型の既定の欠損値によって示 DataKindされます。

trimWhitespace
Boolean

行から末尾の空白を削除します。

allowSparse
Boolean

入力にスパース表現を含めるかどうか。 たとえば、"5 2:6 4:3" を含む行は 5 つの列があることを意味し、0 以外の列はそれぞれ 6 と 3 の列 2 と 4 です。 列インデックスは 0 から始まるため、列 2 と 4 は 3 番目と 5 番目の列を表します。 列には、密度の高い値の後に、この方法で表されるスパース値が続く場合もあります。 たとえば、"1 2 5 2:6 4:3" を含む行は、値が 1 と 2 の 2 つの密な列を表し、その後に値が 0、0、6、0、3 の 5 つの疎に表された列を表します。 スパース列のインデックスは 0 から始まりますが、0 は 3 番目の列を表します。

戻り値

データ ビュー。

適用対象

LoadFromTextFile<TInput>(DataOperationsCatalog, String, TextLoader+Options)

を使用してTextLoaderテキスト ファイルから a IDataView を読み込みます。 IDataView's は遅延であるため、ここでは実際の読み込みは行われません。スキーマの検証だけです。

public static Microsoft.ML.IDataView LoadFromTextFile<TInput> (this Microsoft.ML.DataOperationsCatalog catalog, string path, Microsoft.ML.Data.TextLoader.Options options);
static member LoadFromTextFile : Microsoft.ML.DataOperationsCatalog * string * Microsoft.ML.Data.TextLoader.Options -> Microsoft.ML.IDataView
<Extension()>
Public Function LoadFromTextFile(Of TInput) (catalog As DataOperationsCatalog, path As String, options As TextLoader.Options) As IDataView

型パラメーター

TInput

パラメーター

path
String

読み込み元のファイルまたはファイルのパスを指定します。

options
TextLoader.Options

読み込み操作の設定を定義します。 列はこのメソッドによって推論されるため、Columns フィールドを指定する必要はありません。

戻り値

データ ビュー。

適用対象

LoadFromTextFile<TInput>(DataOperationsCatalog, String, Char, Boolean, Boolean, Boolean, Boolean)

を使用してTextLoaderテキスト ファイルから a IDataView を読み込みます。 IDataView's は遅延であるため、ここでは実際の読み込みは行われません。スキーマの検証だけです。

public static Microsoft.ML.IDataView LoadFromTextFile<TInput> (this Microsoft.ML.DataOperationsCatalog catalog, string path, char separatorChar = '\t', bool hasHeader = false, bool allowQuoting = false, bool trimWhitespace = false, bool allowSparse = false);
static member LoadFromTextFile : Microsoft.ML.DataOperationsCatalog * string * char * bool * bool * bool * bool -> Microsoft.ML.IDataView
<Extension()>
Public Function LoadFromTextFile(Of TInput) (catalog As DataOperationsCatalog, path As String, Optional separatorChar As Char = '\t', Optional hasHeader As Boolean = false, Optional allowQuoting As Boolean = false, Optional trimWhitespace As Boolean = false, Optional allowSparse As Boolean = false) As IDataView

型パラメーター

TInput

パラメーター

path
String

ファイルへのパス。

separatorChar
Char

列区切り文字。 既定値は '\t' です

hasHeader
Boolean

ファイルにヘッダーがあるかどうか。 この場合 true、ローダーは呼び出されたときに Load(IMultiStreamSource) 最初の行をスキップします。

allowQuoting
Boolean

入力に二重引用符で囲まれた値が含まれるかどうか。 このパラメーターは、入力値の区切り文字を実際の区切り文字と区別するために使用されます。 この場合 true、二重引用符内の区切り記号は入力値の一部として扱われます。 この場合 false、すべての区切り記号 (これらの白い引用符も含む) は、新しい列を区切るものとして扱われます。 また、空の値と欠損値を区別するためにも使用されます。 場合 true、欠損値は連続する区切り記号で示され、空の値は "" で示されます。 空の値は、連続する区切り記号と欠損値で示される場合 falseは、次に記載されている各型の既定の欠損値によって示 DataKindされます。

trimWhitespace
Boolean

行から末尾の空白を削除します。

allowSparse
Boolean

入力にスパース表現を含めるかどうか。 たとえば、"5 2:6 4:3" を含む行は 5 つの列があることを意味し、0 以外の列はそれぞれ 6 と 3 の列 2 と 4 です。 列インデックスは 0 から始まるため、列 2 と 4 は 3 番目と 5 番目の列を表します。 列には、密度の高い値の後に、この方法で表されるスパース値が続く場合もあります。 たとえば、"1 2 5 2:6 4:3" を含む行は、値が 1 と 2 の 2 つの密な列を表し、その後に値が 0、0、6、0、3 の 5 つの疎に表された列を表します。 スパース列のインデックスは 0 から始まりますが、0 は 3 番目の列を表します。

戻り値

データ ビュー。

適用対象