Versions Compared

Old Version 26

changes.mady.by.user Kanako Higashi

Saved on

compared with

New Version 27

changes.mady.by.user Martin Trgiňa

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Removed translated content for 'zh'
Sv translation
languageen

To be able to see the results and work with them, the results from a project needs to be stored. There are different ways of storing data in BellaDati ML Studio - permanently and temporarily. For storing the data permanently, they need to be stored in data set. Temporary storage is available only for current session. Tables and various charts can be used as temporary storage (temporary output). These tables and charts are deleted after end of each session. 

Storing data Permanently in Data Set

To be able to store data in data set, the data set with correct structure (attribute and indicators) needs to be already created. See Creating Data Set for more information.

Function storeDataset is used for storing the data. The function is defined like this:

Code Block
storeDataset(Integer datasetId, InputStream is, Map<Object, Object> params)

Parameters

All parameters are mandatory.

  • datasetID - defines the id of the data set. It can be set by the Code builder or it can be found in the URL of the data set.
  • is - defines the source of data which should be stored. It needs to be in a form of an input stream - see Reading as a stream for more information.
  • params - a Map of parameters which defines mapping and method of storing. 
    • mapping - list of String where each String is a code of a column from target data set. This means, that first column from the source input stream is mapped to first column in the list, second columns from the source input stream is mapped to second column in the list etc.
    • method - defines method of import which will be used for storing. If not defined, the data will be appended to the data already stored in the target data set. If defined as delete_all, all existing data in the target data set will be deleted and data from the input stream will be stored in the data set.
    • fill - optional parameter which can be used for putting the same values to all rows of one column.

Sample usage

Code Block
languagejava
table('temptable', [ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column 1','Column 2')
storeDataset(16, streamTable('temptable'), ["mapping": "M_COLUMN_1,M_COLUMN_2","method" : "delete_all"])

This code will first create a temporary table 'temptable' and then store in data set with ID 16. First column of the table is mapped to indicator with code M_COLUMN_1, second column is mapped to indicator with code M_COLUMN_2. Method delete_all is used and therefore all existing data in the target data set will be deleted before storing data from the table.

Code Block
languagejava
table('temptable2', [ 1,2,3,4], 'Column 1');
storeDataset(17, streamTable('temptable'), ["mapping": "M_COLUMN_1","method" : "delete_all",  fill : "M_COLUMN_2=10"])

This code will first create a temporary table 'temptable2' with one column and then store in data set with ID 17. The column of the table is mapped to indicator with code M_COLUMN_1. Second column with code M_COLUMN_2 will be filled with number 10 (all rows). Method delete_all is used and therefore all existing data in the target data set will be deleted before storing data from the table. 

Storing Data Temporarily

Data can temporarily stored (displayed) as:

  • Table 
  • Bar Chart
  • Box Plot Chart.

Storing data in table

Temporary table can be used for displaying results in a form of rows and columns. List of tables is displayed in control sidebar on left side of the screen in section Tables. The table itself is displayed in the right sidebar. It is also available to download it as a CSV file.

Function table is used for storing the data in table. The function is defined like this:

Code Block
languagejs
table(String id, Object data, String... columns)

Parameters

Parameter data is mandatory, parameters id and columns are optional.

  • id - defines the id (name) of the table
  • data - defines the content of the table
  • columns - defines the names of columns. It is possible to define names for some columns only.

Sample usage

Code Block
languagejs
table('first', [ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column 1','Column 2')
table([ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column A',)

This code will create two tables with the same content. The first table has defined its name and names of both columns. Second table does not have its name defined and therefore it will be named as table_2. It also has defined name only for the first column. The second will be named automatically as 1.

Displaying data in bar chart

It is possible to display results in a form of a bar chart. List of charts is displayed in control sidebar on left side of the screen in section Charts. The chart itself is displayed in the right sidebar.

Function barChart is used for displaying the data as a bar chart. The function is defined like this:

Code Block
languagejs
barChart(String id, Object data, Map<Object, Object> params, String... columns)

Parameters

Parameter data is mandatory, parameters id, params and columns are optional.

  • id - defines the id (name) of the chart
  • data - defines the content of the chart
  • params - defines additional parameters of the chart, such as color.
  • columns - defines the legend on X axis.

Sample usage

Code Block
languagejs
barChart('bar chart',[1, 2, 3, 2, 1],["color":"#09DDCC"],'Results')

This code will create a bar chart with the name "bar chart", with five columns, cyan color and label "Results" on X axis.

Displaying data in box plot chart

Another option is to display results in a form of a box plot chart. List of charts is displayed in control sidebar on left side of the screen in section Charts. The chart itself is displayed in the right sidebar.

Function boxPlotChart is used for displaying the data as a box plot chart. The function is defined like this:

Code Block
languagejs
boxPlotChart(String id, Object data, Map<Object, Object> params, String... columns)

Parameters

Parameter data is mandatory, parameters id, params and columns are optional.

  • id - defines the id (name) of the chart
  • data - defines the content of the chart. Six values need to be defined, in this order:

    • min

    • max

    • avg

    • median

    • first quartile

    • third quartile.

  • params - defines additional parameters of the chart, such as color, start etc.
    • start - defines which number (column) should be used as first value (starting from 0). Example: there are 7 values defined, the user does not want to use the first value -> "start":1.
    • color - defines color of the chart.
    • labels - defines which column contains labels
    • scale - defines scaling of the chart
      • possible values: "relative"
  • columns - defines the legend on X axis.

Sample usage

Code Block
languagejs
 boxPlotChart([[ 1,3, 10, 5, 6, 3.2, 7]] , ["start":1, "color": "lightblue"] )

Code Block
languagejs
data = [ [ 'First', 1, 10, 5, 6, 3.2, 7 ], [ 'Second', 4, 14, 9, 10, 6.2, 10 ], [ 'Third', 4, 14, 9, 10, 6.2, 10 ] ]
boxPlotChart(data, [ "start": 1, "labels": 0, "color": "purple", "scale": "relative"] )

 


table('temptable', [ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column 1','Column 2')storeDataset(16, streamTable('temptable'), ["mapping": "M_COLUMN_1,M_COLUMN_2","method" : "delete_all"])

Sv translation
languageja

結果を確認して操作できるようにするには、プロジェクトの結果を保存する必要があります。 BellaDati ML Studioにデータを保存する方法は様々で、恒久的および一時的に保存可能です。データを永続的に保存するには、データセットに保存する必要があります。一時ストレージは現在のセッションでのみ使用できます。テーブルと各種チャートは、一時ストレージ（一時出力）として使用できます。これらのテーブルとチャートは、各セッションの終了後に削除されます。

データセットへの永続データの保存

データセットにデータを保存できるようにするには、正しい構造（属性とインジケータ）のデータセットが既に作成されている必要があります。詳細については、 Creating Data Setを参照してください。

storeDataset関数は、データの保存に使用されます。関数は次のように定義されます:

Code Block
storeDataset(Integer datasetId, InputStream is, Map<Object, Object> params)

パラメーター

全てのパラメーターは必須です。

  • datasetID - データセットのIDを定義します。コードビルダーで設定するか、データセットのURLで見つけることができます。
  • is - 保存するデータのソースを定義します。入力ストリームの形式である必要があります-詳細については、ストリームとしての読み込みを参照してください。
    params - マッピングと保存方法を定義するパラメーターのマップ。
    • mapping - 各文字列がターゲットデータセットの列のコードである文字列のリスト。つまり、ソース入力ストリームの最初の列はリストの最初の列にマッピングされ、ソース入力ストリームの2番目の列はリストの2番目の列にマッピングされます。
    • method - 保存に使用されるインポート方法を定義します。定義されていない場合、データはターゲットデータセットに既に保存されているデータに追加されます。 delete_allとして定義されている場合、ターゲットデータセット内の既存のデータはすべて削除され、入力ストリームのデータはデータセットに保存されます。
    • fill - 1つの列のすべての行に同じ値を設定するために使用できるオプションのパラメーター。

使用例

Code Block
languagejava
table('temptable', [ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column 1','Column 2')
storeDataset(16, streamTable('temptable'), ["mapping": "M_COLUMN_1,M_COLUMN_2","method" : "delete_all"])

このコードは、まず一時テーブル「temptable」を作成し、ID 16のデータセットに格納します。テーブルの最初の列はコードM_COLUMN_1でインジケータにマップされ、2番目の列はコードM_COLUMN_2でインジケータにマップされます。メソッドdelete_allが使用されるため、テーブルからデータを保存する前に、ターゲットデータセット内のすべての既存データが削除されます。

Code Block
languagejava
table('temptable2', [ 1,2,3,4], 'Column 1');
storeDataset(17, streamTable('temptable'), ["mapping": "M_COLUMN_1","method" : "delete_all",  fill : "M_COLUMN_2=10"])

このコードは最初に1つの列を持つ一時テーブル「temptable2」を作成し、ID 17のデータセットに格納します。テーブルの列はコードM_COLUMN_1でインジケータにマップされます。コードM_COLUMN_2の2番目の列には、番号10（すべての行）が入力されます。メソッドdelete_allが使用されるため、テーブルからデータを保存する前に、ターゲットデータセット内のすべての既存データが削除されます。

データの一時保存

データは次のように一時的に保存（表示）できます:

  • テーブル 
  • バーチャート(棒グラフ)
  • 箱ひげ図

テーブルへのデータの保存

一時テーブルは、結果を行と列の形式で表示するために使用できます。テーブルのリストは、セクションテーブルの画面左側のコントロールサイドバーに表示されます。テーブル自体は右側のサイドバーに表示されます。 CSVファイルとしてダウンロードすることもできます。

table関数は、テーブルにデータを保存するために使用されます。関数は次のように定義されます:

Code Block
languagejs
table(String id, Object data, String... columns)

パラメーター

パラメーター「data」は必須で、パラメーター「id」「columns」は任意です。

  • id - テーブルのid（名前）を定義します。
  • data - テーブルの内容を定義します。
  • columns - 列の名前を定義します。一部の列にのみ名前を定義することができます。

使用例

Code Block
languagejs
table('first', [ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column 1','Column 2')
table([ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column A',)

このコードは、同じ内容の2つのテーブルを作成します。最初のテーブルは、その名前と両方の列の名前を定義しています。 2番目のテーブルには名前が定義されていないため、table_2という名前が付けられます。また、最初の列に対してのみ名前が定義されています。 2番目の列は自動的に1という名前が付けられます。

棒グラフでのデータ表示

結果を棒グラフの形式で表示することができます。チャートのリストは、チャートセクションの画面左側のコントロールサイドバーに表示されます。チャート自体は右側のサイドバーに表示されます。

barChart関数は、データを棒グラフとして表示するために使用されます。関数は次のように定義されます:

Code Block
languagejs
barChart(String id, Object data, Map<Object, Object> params, String... columns)

パラメーター

パラメーター「data」は必須で、パラメーター「id」「params」「columns」は任意です。

  • id - チャートのID（名前）を定義します。
  • data - チャートのコンテンツを定義します。
  • params - 色など、チャートの追加パラメーターを定義します。
  • columns - X軸の凡例を定義します。

使用例

Code Block
languagejs
barChart('bar chart',[1, 2, 3, 2, 1],["color":"#09DDCC"],'Results')

このコードは、「棒グラフ」という名前の棒グラフを作成し、X軸に5つの列、シアン色、「結果」というラベルを付けます。

箱ひげ図でのデータ表示

別のオプションは、結果を箱ひげ図(ボックスプロットチャート)の形式で表示することです。チャートのリストは、チャートセクションの画面左側のコントロールサイドバーに表示されます。チャート自体は右側のサイドバーに表示されます。

boxPlotChart関数は、データを箱ひげ図として表示するために使用されます。関数は次のように定義されます:

Code Block
languagejs
boxPlotChart(String id, Object data, Map<Object, Object> params, String... columns)

パラメーター

パラメーター「data」は必須で、パラメーター「id」「params」「columns」は任意です。

  • id - チャートのID（名前）を定義します。
  • data - チャートのコンテンツを定義します。この順序で6つの値を定義する必要があります:

    • 最小値

    • 最大値

    • 平均値

    • 中央値

    • 第1四分位

    • 第3四分位

  • params - 色、開始など、チャートの追加パラメーターを定義します。
    • start - 最初の値（0から始まる）として使用する番号（列）を定義します。例: 7つの値が定義されていますが、ユーザーは最初の値を使用したくない -> "start":1。
    • color - チャートの色を定義します。
    • labels - どの列にラベルが含まれるかを定義します。
    • scale - チャートのスケーリングを定義します
      • 可能な値："相対"
  • columns - X軸の凡例を定義します。

使用例

Code Block
languagejs
 boxPlotChart([[ 1,3, 10, 5, 6, 3.2, 7]] , ["start":1, "color": "lightblue"] )

Code Block
languagejs
data = [ [ 'First', 1, 10, 5, 6, 3.2, 7 ], [ 'Second', 4, 14, 9, 10, 6.2, 10 ], [ 'Third', 4, 14, 9, 10, 6.2, 10 ] ]
boxPlotChart(data, [ "start": 1, "labels": 0, "color": "purple", "scale": "relative"] )

 


table('temptable', [ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column 1','Column 2')storeDataset(16, streamTable('temptable'), ["mapping": "M_COLUMN_1,M_COLUMN_2","method" : "delete_all"])

Sv translation
languagede

Um die Ergebnisse sehen und damit arbeiten zu können, müssen die Ergebnisse eines Projekts gespeichert werden. Es gibt verschiedene Möglichkeiten, Daten im BellaDati ML Studio zu speichern - dauerhaft und temporär. Um die Daten dauerhaft zu speichern, müssen sie im Dataset gespeichert werden. Der temporäre Speicher ist nur für die aktuelle Sitzung verfügbar. Als Zwischenspeicher (temporäre Ausgabe) können Tabellen und verschiedene Charts verwendet werden. Diese Tabellen und Diagramme werden nach Ende jeder Sitzung gelöscht.

Daten dauerhaft im Dataset speichern

Um Daten im Dataset speichern zu können, muss der Dataset mit der richtigen Struktur (Attribut und Kennzeichen) bereits angelegt sein. Weitere Informationen finden Sie unter Dataset erstellen.

Die Funktion storeDataset dient zur Speicherung der Daten. Die Funktion ist wie folgt definiert:

Code Block
storeDataset(Integer datasetId, InputStream is, Map<Object, Object> params)

Parameter

Alle Parameter sind Pflichtfelder.

  • DatasetID - definiert die ID des Datasets. Er kann vom Code-Builder gesetzt werden oder ist in der URL des Datasets zu finden.
  • is - definiert die Quelle der Daten, die gespeichert werden sollen. Es muss in Form eines Eingangsstroms vorliegen - siehe Lesen als Stream für weitere Informationen.

  • params - eine Karte der Parameter, die das Mapping und die Art der Speicherung definiert.

    • mapping - Liste der Zeichenkette, wobei jede Zeichenkette ein Code einer Spalte aus dem Zieldataset ist. Das bedeutet, dass die erste Spalte aus dem Quell-Eingabestrom auf die erste Spalte in der Liste abgebildet wird, die zweiten Spalten aus dem Quell-Eingabestrom auf die zweite Spalte in der Liste usw. usw.
    • Methode - definiert die Importmethode, die zum Speichern verwendet wird. Wenn nicht definiert, werden die Daten an die bereits im Zieldataset gespeicherten Daten angehängt. Wenn als delete_all definiert, werden alle vorhandenen Daten im Zieldataset gelöscht und Daten aus dem Eingangsstrom im Dataset gespeichert.
    • fill - optionaler Parameter, mit dem man alle Zeilen einer Spalte mit den gleichen Werten belegen kann.

Beispielhafte Nutzung

Code Block
languagejava
table('temptable', [ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column 1','Column 2')
storeDataset(16, streamTable('temptable'), ["mapping": "M_COLUMN_1,M_COLUMN_2","method" : "delete_all"])

Dieser Code erstellt zunächst eine temporäre Tabelle'temptable' und speichert sie dann im Dataset mit der ID 16. Die erste Spalte der Tabelle wird auf das Kennzeichen mit dem Code M_COLUMN_1 abgebildet, die zweite Spalte auf das Kennzeichen mit dem Code M_COLUMN_2. Die Methode delete_all wird verwendet und daher werden alle vorhandenen Daten im Zieldataset gelöscht, bevor Daten aus der Tabelle gespeichert werden.

Code Block
languagejava
table('temptable2', [ 1,2,3,4], 'Column 1');
storeDataset(17, streamTable('temptable'), ["mapping": "M_COLUMN_1","method" : "delete_all",  fill : "M_COLUMN_2=10"])

Dieser Code erstellt zunächst eine temporäre Tabelle'temptable2' mit einer Spalte und speichert sie dann im Dataset mit der ID 17. Die Spalte der Tabelle wird auf das Kennzeichen mit dem Code M_COLUMN_1 abgebildet. Die zweite Spalte mit dem Code M_COLUMN_2 wird mit der Nummer 10 (alle Zeilen) gefüllt.  Die Methode delete_all wird verwendet und daher werden alle vorhandenen Daten im Zieldataset gelöscht, bevor Daten aus der Tabelle gespeichert werden.

Daten vorübergehend speichern

Daten können zwischengespeichert (angezeigt) werden als:

  •   Tabelle

  • Balkendiagramm
  • Box Plot Chart.

Speichern von Daten in der Tabelle

Die temporäre Tabelle kann zur Darstellung der Ergebnisse in Form von Zeilen und Spalten verwendet werden. Die Liste der Tabellen wird in der Steuerleiste auf der linken Seite des Bildschirms im Abschnitt Tabellen angezeigt. Die Tabelle selbst wird in der rechten Sidebar angezeigt. Es ist auch verfügbar, um es als CSV-Datei herunterzuladen.

Die Funktionstabelle dient zur Speicherung der Daten in der Tabelle. Die Funktion ist wie folgt definiert:

Code Block
languagejs
table(String id, Object data, String... columns)

Parameter

Parameterdaten sind obligatorisch, Parameter-ID und Spalten sind optional.

  • id - definiert die id (Name) der Tabelle
  • data - definiert den Inhalt der Tabelle
  • columns - definiert die Namen der Spalten. Es ist möglich, Namen nur für einige Spalten zu definieren.

Beispielhafte Nutzung

Code Block
languagejs
table('first', [ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column 1','Column 2')
table([ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column A',)

Dieser Code erstellt zwei Tabellen mit dem gleichen Inhalt. Die erste Tabelle hat ihren Namen und die Namen der beiden Spalten definiert. Die zweite Tabelle hat ihren Namen nicht definiert und wird daher als Tabelle_2 bezeichnet. Es hat auch einen Namen nur für die erste Spalte definiert. Die zweite wird automatisch als 1 bezeichnet.

Anzeige der Daten im Balkendiagramm

Es ist möglich, die Ergebnisse in Form eines Balkendiagramms darzustellen. Die Liste der Diagramme wird in der Steuerleiste auf der linken Seite des Bildschirms im Abschnitt Diagramme angezeigt. Das Diagramm selbst wird in der rechten Sidebar angezeigt.

Die Funktion barChart dient zur Darstellung der Daten als Balkendiagramm. Die Funktion ist wie folgt definiert:

Code Block
languagejs
barChart(String id, Object data, Map<Object, Object> params, String... columns)

Parameter

Parameterdaten sind obligatorisch, Parameter-ID, Parameter und Spalten sind optional.

  • id - definiert die ID (Name) des Diagramms
  • data - definiert den Inhalt des Diagramms
  • params - definiert zusätzliche Parameter des Diagramms, wie z.B. Farbe.
  • Spalten - definiert die Legende auf der X-Achse.

Beispielhafte Nutzung

Code Block
languagejs
barChart('bar chart',[1, 2, 3, 2, 1],["color":"#09DDCC"],'Results')

Dieser Code erstellt ein Balkendiagramm mit dem Namen "Balkendiagramm", mit fünf Spalten, cyanfarbener Farbe und Label "Results" auf der X-Achse.

Anzeige der Daten im Box-Plot-Diagramm

Eine weitere Möglichkeit besteht darin, die Ergebnisse in Form eines Kastendiagramms darzustellen. Die Liste der Diagramme wird in der Steuerleiste auf der linken Seite des Bildschirms im Abschnitt Diagramme angezeigt. Das Diagramm selbst wird in der rechten Sidebar angezeigt.

Die Funktion boxPlotChart dient zur Darstellung der Daten als Box-Plot-Chart. Die Funktion ist wie folgt definiert:

 

Code Block
languagejs
boxPlotChart(String id, Object data, Map<Object, Object> params, String... columns)

Parameter

Parameterdaten sind obligatorisch, Parameter-ID, Parameter und Spalten sind optional.

  • id - definiert die ID (Name) des Diagramms
  • Daten - definiert den Inhalt des Diagramms. In dieser Reihenfolge müssen sechs Werte definiert werden

    • min

    • max

    • avg

    • Median

    • erstes Quartil

    • drittes Quartil.

  • params - definiert zusätzliche Parameter des Diagramms, wie Farbe, Start usw.
    • start - definiert, welche Zahl (Spalte) als erster Wert verwendet werden soll (ab 0). Beispiel: Es sind 7 Werte definiert, der Benutzer will den ersten Wert nicht verwenden -> "start":1.
    • color - definiert die Farbe des Diagramms.
    • labels - definiert, welche Spalte Beschriftungen enthält.
    • scale - definiert die Skalierung des Diagramms.
      •     mögliche Werte: "Relativ"
  • Spalten - definiert die Legende auf der X-Achse.

Beispielhafte Nutzung

Code Block
languagejs
 boxPlotChart([[ 1,3, 10, 5, 6, 3.2, 7]] , ["start":1, "color": "lightblue"] )

Code Block
languagejs
data = [ [ 'First', 1, 10, 5, 6, 3.2, 7 ], [ 'Second', 4, 14, 9, 10, 6.2, 10 ], [ 'Third', 4, 14, 9, 10, 6.2, 10 ] ]
boxPlotChart(data, [ "start": 1, "labels": 0, "color": "purple", "scale": "relative"] )

 


table('temptable', [ [ 1, 2 ], [ 2, 3], [ 3, 4] , [ 4, 5] ], 'Column 1','Column 2')storeDataset(16, streamTable('temptable'), ["mapping": "M_COLUMN_1,M_COLUMN_2","method" : "delete_all"])