modelarts-umn/umn/source/data_management/creating_a_dataset.rst

original_name

modelarts_23_0004.html

Creating a Dataset

To manage data using ModelArts, create a dataset. Then you can perform operations on the dataset, such as labeling data, importing data, and publishing the dataset.

Prerequisites

• Before using the data management function, you need permissions to access OBS. This function cannot be used if you are not authorized to access OBS. Before using the data management function, go to the Settings page and complete access authorization using an agency.
• You have created OBS buckets and folders for storing data.
• You have uploaded data to be used to OBS.

Procedure

1. Log in to the ModelArts management console. In the left navigation pane, choose Data Management > Datasets. The Datasets page is displayed.
2. Click Create Dataset. On the Create Dataset page, create datasets of different types based on the data type and data labeling requirements.

   1. Set the basic information, the name and description of the dataset.

      

      Figure 1 Basic information about a dataset

   2. Select a labeling scene and type as required. For details about the types supported by ModelArts, see Dataset Types <modelarts_23_0003__en-us_topic_0171496996_section51771731153811>.

      

      Figure 2 Selecting a labeling scene and type

   3. Set the parameters based on the dataset type. For details, see the parameters of the following dataset types:

      • Images (Image Classification, Object Detection) <modelarts_23_0004__en-us_topic_0170886809_section8625131415541>
      • Audio (Sound Classification, Speech Labeling, and Speech Paragraph Labeling) <modelarts_23_0004__en-us_topic_0170886809_section17893314546>
      • Text (Text Classification, Named Entity Recognition, and Text Triplet) <modelarts_23_0004__en-us_topic_0170886809_section16230452125420>
      • Other (Free Format) <modelarts_23_0004__en-us_topic_0170886809_section359415145517>

   4. Click Create in the lower right corner of the page.

      After the dataset is created, the dataset management page is displayed. You can perform the following operations on the dataset: label data, publish dataset versions, manage dataset versions, modify the dataset, import data, and delete the dataset. For details about the operations supported by different types of datasets, see .

Images (Image Classification, Object Detection, )

Figure 3 Parameters of datasets for image classification and object detection

Table 1 Dataset parameters

Parameter	Description
Input Dataset Path	Select the OBS path to the input dataset.
Output Dataset Path	Select the OBS path to the output dataset. Note The output dataset path cannot be the same as the input dataset path or cannot be the subdirectory of the input dataset path. Select an empty directory as the Output Dataset Path.
Label Set	Label Name: Enter a label name. The label name can contain only letters, digits, underscores (_), and hyphens (-). The name contains 1 to 32 characters. Add Label: Click Add Label to add more labels. Setting a label color: This function is available only for datasets of the object detection type. Select a color from the color palette on the right of a label, or enter the hexadecimal color code to set the color. Setting label attributes: For an object detection dataset, you can click the plus sign (+) on the right to add label attributes after setting a label color. Label attributes are used to distinguish different attributes of the objects with the same label. For example, yellow kittens and black kittens have the same label cat and their label attribute is color.
Team Labeling	Enable or disable team labeling. Image segmentation does not support team labeling. Therefore, this parameter is unavailable when you use image segmentation. After enabling team labeling, enter the name and type of the team labeling task, and select the labeling team and team members. For details about the parameter settings, see Creating Team Labeling Tasks <modelarts_23_0210__en-us_topic_0209053802_section72262410214>. Before enabling team labeling, ensure that you have added a team and members on the Labeling Teams page. If no labeling team is available, click the link on the page to go to the Labeling Teams page, and add your team and members. For details, see Introduction to Team Labeling <modelarts_23_0181>. After a dataset is created with team labeling enabled, you can view the Team Labeling mark in Labeling Type.

Audio (Sound Classification, Speech Labeling, and Speech Paragraph Labeling)

Figure 4 Parameters of datasets for sound classification, speech labeling, and speech paragraph labeling

Parameter	Description
Input Dataset Path	Select the OBS path to the input dataset.
Output Dataset Path	Select the OBS path to the output dataset. Note The output dataset path cannot be the same as the input dataset path or cannot be the subdirectory of the input dataset path. Select an empty directory as the Output Dataset Path.
Label Set (Sound Classification)	Set labels only for datasets of the sound classification type. Label Name: Enter a label name. The label name can contain only letters, digits, underscores (_), and hyphens (-). The name contains 1 to 32 characters. Add Label: Click Add Label to add more labels.
Label Management (Speech Paragraph Labeling)	Only datasets for speech paragraph labeling support multiple labels. Single Label A single label is used to label a piece of audio that has only one class. Label Name: Enter a label name. The label name can contain contains 1 to 32 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed. Label Color: Set the label color in the Label Color column. You can select a color from the color palette or enter a hexadecimal color code to set the color. Multiple Labels Multiple labels are suitable for multi-dimensional labeling. For example, you can label a piece of audio as both noise and speech. For speech, you can label the audio with different speakers. You can click Add Label Class to add multiple label classes. A label class can contain multiple labels. The label class and name can contain contains 1 to 32 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed. Label Class: Set a label class. Label Name: Enter a label name. Add Label: Click Add Label to add more labels.
Speech Labeling (Speech Paragraph Labeling)	Only datasets for speech paragraph labeling support speech labeling. By default, speech labeling is disabled. If this function is enabled, you can label speech content.

Text (Text Classification, Named Entity Recognition, and Text Triplet)

Figure 5 Parameters of datasets for text classification, named entity recognition, and text triplet

Table 2 Dataset parameters

Parameter	Description
Input Dataset Path	Select the OBS path to the input dataset. Note Labeled text classification data can be identified only when you import data. When creating a dataset, set an empty OBS directory. After the dataset is created, import the labeled data into it. For details about the format of the data to be imported, see Specifications for Importing Data from an OBS Directory <modelarts_23_0008>.
Output Dataset Path	Select the OBS path to the output dataset. Note The output dataset path cannot be the same as the input dataset path or cannot be the subdirectory of the input dataset path. Select an empty directory as the Output Dataset Path.
Label Set (for text classification and named entity recognition)	Label Name: Enter a label name. The label name can contain only letters, digits, underscores (_), and hyphens (-). The name contains 1 to 32 characters. Add Label: Click Add Label to add more labels. Setting a label color: Select a color from the color palette or enter the hexadecimal color code to set the color.
Label Set (for text triplet)	For datasets of the text triplet type, set entity labels and relationship labels. Entity Label: Set the label name and label color. You can click the plus sign (+) on the right of the color area to add multiple labels. Relationship Label: a relationship between two entities. Set the source entity and target entity. Therefore, add at least two entity labels before adding a relationship label.
Team Labeling	Enable or disable team labeling. After enabling team labeling, enter the name and type of the team labeling task, and select the labeling team and team members. For details about the parameter settings, see Creating Team Labeling Tasks <modelarts_23_0210__en-us_topic_0209053802_section72262410214>. Before enabling team labeling, ensure that you have added a team and members on the Labeling Teams page. If no labeling team is available, click the link on the page to go to the Labeling Teams page, and add your team and members. For details, see Introduction to Team Labeling <modelarts_23_0181>. After a dataset is created with team labeling enabled, you can view the Team Labeling mark in Labeling Type.

Other (Free Format)

Figure 6 Parameters of datasets of the free format type

Table 3 Dataset parameters

Parameter	Description
Input Dataset Path	Select the OBS path to the input dataset.
Output Dataset Path	Select the OBS path to the output dataset. Note The output dataset path cannot be the same as the input dataset path or cannot be the subdirectory of the input dataset path. Select an empty directory as the Output Dataset Path.