# データのアップロード

Mindkosh のデータセットにデータを追加する方法はいくつかあります。

### UI を使ったアップロード

ほとんどのデータ型は UI から直接アップロードできます。そのためには、新しいデータセットを作成するか、既存のデータセットを選択します。データセットページで、 **ファイルを追加** 上部のボタンをクリックします。次にファイルをドラッグ＆ドロップするだけでデータをアップロードできます。選択されたデータセットタイプでサポートされているファイル形式のみ表示されることに注意してください。

{% hint style="warning" %}
ポイントクラウドに参照画像を追加すること（たとえばセンサーフュージョンのユースケース）は UI ではサポートされていません。これらは SDK を使用してのみ追加できます。他の画像に対する参照画像（例：RGB 画像に対する深度画像やサーマル画像）についても同様です。
{% endhint %}

**画像のサポート形式**

PNG（シングルチャンネルおよび RGB）、JPG、JPEG、BMP、WEBP

**ポイントクラウドのサポート形式**

ASCII PCD、バイナリ PCD、バイナリ圧縮 PCD

{% hint style="warning" %}
UI では一度に 1000 ファイルまでしかアップロードできません。より多くのファイルがある場合はチャンクに分けてアップロードできますが、大量のファイルをアップロードする場合は SDK の使用を推奨します。  &#x20;
{% endhint %}

###

### SDK を使ったアップロード

以下の [SDK に関するドキュメント](https://docs.mindkosh.com/ja/python-sdk/dtanoappurdo) を参照して、SDK を使ってデータをアップロードする方法を確認してください。SDK を使用するには SDK トークンが必要ですので、トークンが必要な場合はお問い合わせください。

### クラウドストレージからのデータ追加

データを当社のサーバーにアップロードする代わりに、ご自身のクラウドストレージを Mindkosh に接続することもできます。この設定では、データは Mindkosh サーバーに保存されることはなく、ストレージからユーザーのブラウザへ直接ストリームされます。&#x20;

ご自身のクラウドストレージからデータを追加するには、まずクラウド認証情報を Mindkosh に追加する必要があります。これは一度限りの手続きです。認証情報を追加すれば、以降何度でも認証情報を再追加することなくデータを追加できます。&#x20;

現在、AWS S3、Microsoft Azure、Google Cloud Storage をサポートしています。&#x20;

クラウドストレージからデータを追加するには：

1. 新しいデータセットを作成します。
2. を選択します **ユーザークラウド** をストレージ場所として。
3. 適切なクラウドプロバイダーを選択し、以下の手順に従ってください。
   1. AWS S3
   2. MS Azure
   3. Google Cloud Storage

{% hint style="info" %}
データセットを作成すると、入力された場所が関連ファイルのためにスキャンされ、データセットに追加されます。入力した場所のルートにあるファイルのみがスキャンされる点に注意してください。サブディレクトリはスキャンされません。
{% endhint %}

<figure><img src="https://725705539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaFKXVbOeJ2H3b8HBGVBG%2Fuploads%2Fdc08SsFEBlxM9Ckrm2Aq%2Fadding_data_to_mindkosh_from_cloud_storage.png?alt=media&#x26;token=499bbb25-3e2a-4879-aa5a-0922644089aa" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Mindkosh にクラウドストレージを接続する際、クラウドストレージプロバイダーによって発生する送信データ転送料が請求される場合があります。該当するかどうかはクラウドプロバイダーの設定を参照してください。例として、多くの AWS S3 の設定では S3 から転送されるデータに対して 1 GB あたり USD 0.09 の送信データ転送料が発生します。 &#x20;
{% endhint %}

#### AWS S3 からのデータ追加

データセットを作成する前に認証情報を追加していることを確認してください。以下の [AWS S3 の認証情報を追加するガイドはこちら](https://docs.mindkosh.com/ja/guan-li/dtasetto/awssutorjitono)をご覧ください。S3 バケットからデータを追加するには、次の詳細を入力します。&#x20;

**リージョン**\
バケットの AWS リージョン\
\
**バケット名**\
バケット名を入力してください。プレフィックス（例： *https* や *S3、* や末尾のスラッシュ）は含めず、バケット名のみを入力する必要がある点にご注意ください。

**ディレクトリ**\
データセットに追加したい画像やポイントクラウドが含まれるディレクトリを入力してください。ここで入力したルートディレクトリのみをスキャンし、サブディレクトリはスキップします。データがここで指定したディレクトリにあることを確認してください。

例えば、画像が次のように格納されている場合：\
\
`s3://example_bucket_name/sample_dataset/slice_1/image_0001.png`&#x20;

`s3://example_bucket_name/sample_dataset/slice_1/image_0002.png`

次のように入力します、 `example_bucket_name` をバケットとして、そして `sample_dataset/slice_1/` をディレクトリとして入力すると、このディレクトリ内のすべての画像がデータセットに追加されます。

#### MS Azure からのデータ追加

データセットを作成する前に認証情報を追加していることを確認してください。以下の [MS Azure の認証情報を追加するためのガイド](https://docs.mindkosh.com/ja/guan-li/dtasetto/azuresutorjitono)をご覧ください。Azure のコンテナからデータを追加するには、次の詳細を入力します。&#x20;

**リージョン**\
コンテナのリージョン\
\
**ストレージアカウント／コンテナ名**\
ストレージアカウント名とコンテナ名を  `/`で区切って入力してください。例：ストレージアカウント名が `teststorageaccount` でコンテナ名が `testcontainer`の場合、次のように入力します - `teststorageaccount/testcontainer`

**ディレクトリ**\
コンテナ内で、データセットに追加したい画像／ポイントクラウドが含まれるディレクトリを入力してください。コンテナ名自体は含めず、コンテナ内のディレクトリのみを入力してください。ファイルがルートコンテナ（ディレクトリ内にない）にある場合は、ディレクトリ欄に単に `/` と入力してください。

例えば、画像が次のように格納されている場合：\
\
`testcontainer/sample_dataset/slice_1/image_0001.png`&#x20;

`testcontainer/sample_dataset/slice_1/image_0002.png`

次のように入力します `sample_dataset/slice_1/` をディレクトリとして入力すると、このディレクトリ内のすべての画像がデータセットに追加されます。

#### Google Cloud Storage からのデータ追加

データセットを作成する前に認証情報を追加していることを確認してください。以下の [Google ストレージの認証情報を追加するためのガイド](https://docs.mindkosh.com/ja/guan-li/dtasetto/googlekuraudosutorjitono)をご覧ください。Google Cloud のバケットからデータを追加するには、次の詳細を入力します。&#x20;

**リージョン**\
バケットのリージョン\
\
**バケット名**\
バケット名を入力してください。プレフィックス（例： *https* や末尾のスラッシュ）は含めず、バケット名のみを入力する必要がある点にご注意ください。

**ディレクトリ**\
バケット内で、データセットに追加したい画像／ポイントクラウドが含まれるディレクトリを入力してください。コンテナ名（バケット名）自体は含めず、バケット内のディレクトリのみを入力してください。ファイルがルート（ディレクトリ内にない）にある場合は、単に `/` と入力してください。

例えば、画像が次のように格納されている場合：\
\
`testbucket/sample_dataset/slice_1/image_0001.png`&#x20;

`testbucket/sample_dataset/slice_1/image_0002.png`

次のように入力します `sample_dataset/slice_1/` をディレクトリとして入力すると、このディレクトリ内のすべての画像がデータセットに追加されます。
