# AnnoStation Knowledge Base ## Getting Started [**Start exploring AnnoStation**](/getting-started/intro)\ ## Browse Topics | | | | | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | |


Organization

|



Project Setup

|


Projects

| |


Workflow

|


Annotation

|


Review

| |

Collaboration

|

​​

​Export

| | ## Resources {% content-ref url="/pages/-MF--o3BVqrC3IGsmGYk" %} [JSON format](/resources/json) {% endcontent-ref %} {% content-ref url="/pages/-MF-06SWo1Qe4S745Eb2" %} [Keyboard shortcuts](/resources/shortcut) {% endcontent-ref %} {% content-ref url="/pages/-MG7Fsz1km\_N\_6EW9rtK" %} [FAQ](/resources/faq) {% endcontent-ref %} # Introduction to AnnoStation AnnoStation is a Collaborative Image Annotation Software for Leading AI Development Teams where teams can deliver high-quality training data efficiently. It is packed with all the features teams need to annotate images, organize data and collaborate with partners. With AnnoStation, your project is put on the path to guaranteed success. ## With AnnoStation, you can: * **Improve the productivity of annotators with feature-rich annotation tools without the complexity** Whether it's semantic segmentation or object identification, AnnoStation provides a rich selection of tools to achieve high-quality and accurate annotation. ![](https://776641706-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MFDmcv8zDmigY7C541N%2F-MFDpr8BgprLnDEMsod-%2Fsolution_6_AnnotateAccurate.png?alt=media\&token=94f17a6e-358d-449e-83c5-2395ae6f2a66) * **Collaborate asynchronously for the rapid feedback loop** Annotate and receive feedback instantly under one roof through real-time collaboration. It reduces unnecessary iterations and guarantees consistent annotation. ![](https://776641706-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MG2slF7K-g9LLw5foah%2F-MG2vkOIG21XVUAJxSjX%2F2020-08-31_185149.png?alt=media\&token=d609bc03-75c2-46e4-9cd5-c4563b9f2fa0) * **Stay always on top of the project making informed decisions** ![](https://776641706-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MG2slF7K-g9LLw5foah%2F-MG2x0SoyZYnZM75HKZt%2F2020-08-31_185759.png?alt=media\&token=818d424b-b2e1-4649-9b20-67840e04d8e0) You get a clear picture of everything and make better decisions to avoid project delays or bottlenecks. # Quick start ## **Create an account and start exploring AnnoStation** 1. Visit our website. [**Sign up**](https://annostation.com/users/sign_up) to create a new account and try it out for free with a 30-day trial. * Once you're ready, you will be sent a verification email. 2. Verify your email address. 3. [**Log In**](https://annostation.com/users/sign_in) to AnnoStation. {% hint style="info" %} All trial accounts get thirty days free, no credit card required. {% endhint %} ### **Invite members to your Organization** The best way to get the most out of AnnoStation is by inviting members to your Organization. Define their roles and put someone in charge of administrating your Organization and Projects. **Get more information on Organization and how to invite:** {% content-ref url="/pages/-MF3U9Nx9D4Z-Rh\_kz2l" %} [Organization](/mastering-annostation/organization) {% endcontent-ref %} #### **You've been invited to join an Organization?** If you received an email to join someone's organization, you can start collaborating with the team you've just been invited to. Make sure you are signed in with the right account before joining the organization. ## **Annotate an image** ### Create a new Project You can start testing AnnoStation by creating a new Project. For each Project, you can import images and set up different annotation labels. **Get more information on how to set up a Project:** {% content-ref url="/pages/-MF--dai9QMvAvT6D3nX" %} [Setting up a Project](/mastering-annostation/projectsetup) {% endcontent-ref %} {% hint style="info" %} Don't see a button to create a new Project? You need to be an owner of an Organization to create a new Project. {% endhint %} **Learn about the permission of members:** {% content-ref url="/pages/-MFjcnxbvRF4C4ToyQXO" %} [Project member roles](/mastering-annostation/projectsetup/project-members/project-member-roles) {% endcontent-ref %} ### Import images You can import images to your Project from your local directory or connect to images stored in the external data source such as amazon S3 or Google Drive. **You can read more about importing images and connecting to external data here:** {% content-ref url="/pages/-MF-1ZbVlJGfEJRsQHm9" %} [Adding datasets](/mastering-annostation/projectsetup/data-set) {% endcontent-ref %} {% content-ref url="/pages/-MF-LMumQctyTf4ZBbxU" %} [Connecting to external data](/mastering-annostation/projectsetup/data-set/connecting-to-external-data) {% endcontent-ref %} ### **Start annotation** Open an image to start annotating target objects. Select the desired label from a list of labels defined for the Project. Depending on if the label is vector or segmentation, you can use a different set of tools to annotate an object. **If you want to get more details on annotation features you can have a look here:** {% content-ref url="/pages/-MF-0cxQAUmQekgdpze-" %} [Annotating an image](/mastering-annostation/annotating) {% endcontent-ref %} You can use keyboard shortcut keys to quickly switch between tools. **You can see all the supported keyboard shortcut keys here:** {% content-ref url="/pages/-MF-06SWo1Qe4S745Eb2" %} [Keyboard shortcuts](/resources/shortcut) {% endcontent-ref %} ### **Submit for Review** Once you are done with annotating all objects in the image, you can submit it for review. This will change the status of the image so that reviewers can easily know which images require review. **You can learn more about workflow here:** {% content-ref url="/pages/-MF3VMiAoV5z5u-LHqTP" %} [Workflow and status management](/mastering-annostation/workflow-and-status-management) {% endcontent-ref %} ## **Collaboration** AnnoStation is designed to support collaboration for optimal productivity. ### **Comments and review** Leave comments at the precise location with detailed instructions so that annotators know exactly what needs to be fixed. **If you want to get more details on review features you can have a look here:** {% content-ref url="/pages/-MF-1g\_w97WEnZYbWLfl" %} [Reviewing annotation](/mastering-annostation/review) {% endcontent-ref %} ### **Assign annotators to specific images** Annotators can jump onto any image that is not yet started or you can assign specific images to each annotator for better traceability. It is possible to automatically distribute images among multiple annotators or cherrypick specific images for a member. **You can read more about assignment features in here:** {% content-ref url="/pages/-MF3SU3bgK9YuCD\_bDS5" %} [Assigning annotators](/mastering-annostation/projectsetup/assigning-annotators) {% endcontent-ref %} ### **Collaborating with external Organizations** You may need to work with external partners for some Projects. You can invite external Organizations to your Project so that members from the external Organization can start accessing your Project. {% hint style="info" %} You can always invite your external partners directly to your Organization as well. This is easier if you know exactly whom you need to invite, otherwise collaboration allows you to skip managing members of the external Organization. {% endhint %} Learn more about collaborating with external Organizations here: {% content-ref url="/pages/-MFkIYQ-fqBw\_Bw14cSe" %} [Sharing Projects with external Organization](/mastering-annostation/collaboration/collaborating-with-external-organization) {% endcontent-ref %} # Organization ## What is an Organization? An organization is a home for different projects. You can invite your colleagues, clients or partners to your Organization to start collaborating in AnnoStation. {% hint style="info" %} You can belong to multiple Organizations. If you belong to more than one Organizations, you can choose an Organization to work on after login. {% endhint %} ## Invite members to your Organization 1. Select the `Organization Members` tab. 2. Click on **Invite members** and enter the email address of members you want to invite. 3. Selecting **Send invitation** will send an invitation email to the provided email address if the member is new to AnnoStation. You can now see the members are added to your Organization. If you want to give administrative permissions, you need to change the type of the member to `owner`. {% hint style="info" %} You need to be an owner of your Organization in order to invite members. {% endhint %} **Read more about the member types here:** {% content-ref url="/pages/-MFi94gCvAvKxtn1g1W3" %} [Member types](/mastering-annostation/organization/member-types) {% endcontent-ref %} ### Member status **Pending** When members are invited to an Organization but have not yet accepted the invitation email, the status remains **Pending**. Pending members cannot log in to AnnoStation. Once they accept the invitation, the status changes to **Active**. **Active** **Active** members can log in to AnnoStation and collaborate on Projects. ## Remove members If you are an owner, you can remove a member by clicking the trash bin icon next to the member you want to remove. # Member types Your members can be either an owner or a member within your Organization. ## Owner Owners have administrative permissions for your Organization. **They can**: * Access the `Organization Members` tab * Invite and add other members * Change the type of members * Remove members * Create a new Project * View all Projects {% hint style="info" %} Owners can view all Projects that exist in your Organization. To access the contents of Projects, owners still need to be added to Project Members. {% endhint %} **To learn more about Project Members, read here:** {% content-ref url="/pages/-MFjcnxbvRF4C4ToyQXO" %} [Project member roles](/mastering-annostation/projectsetup/project-members/project-member-roles) {% endcontent-ref %} ## Member Members are active collaborators, but unlike owners, they do not have administrative permissions for your Organization. **They can**: * Access Projects where they are a part of Project Members **They cannot**: * Access the `Organization Members` tab * Invite and add other members * Change the type of members * Remove members * Create a new Project * View Projects that they are not member of # Setting up a Project Project is a base unit to manage, organize and collaborate on the training data in AnnoStation. You can add datasets, define labels and add members to a Project. ## Create a new Project Owners can create a new project. Click **New Project** while you are in the `Projects` tab, and provide a name of the Project. {% hint style="info" %} The name of the Project must be unique within the Organization. {% endhint %} Once a new Project is created, you can start to [add data set](/mastering-annostation/projectsetup/data-set). ## Rename a Project To rename a Project: 1. Open the Project you want to rename. 2. Go to the `Setting` tab. 3. Provide a new name and click **Update**. {% hint style="info" %} You need to have the appropriate [**role** ](/mastering-annostation/projectsetup/project-members/project-member-roles)within the Project to rename or delete**.** {% endhint %} **Read more about the roles here:** {% content-ref url="/pages/-MFjcnxbvRF4C4ToyQXO" %} [Project member roles](/mastering-annostation/projectsetup/project-members/project-member-roles) {% endcontent-ref %} ## Delete a Project You can delete a Project, however make sure you are certain about the action as it will delete the complete data set within the Project and it cannot be reversed. 1. Open the Project you want to rename. 2. Go to the `Setting` tab. 3. Expand the danger zone and click **Delete**. 4. Confirm the action. # Adding datasets ## Overview You can add datasets to AnnoStation using two methods: 1. Import images from your local directory and upload them to AnnoStation. 2. Connect to images stored in the external data source such as amazon S3 or Google Drive or in your secure network. {% hint style="info" %} When you connect to the external data source, such images are not uploaded to AnnoStation. {% endhint %} ## Supported formats The following formats are supported: * JPEG * PNG * GIF # Importing images ## Import images to AnnoStation 1. Select **New** and choose `Import file`. 2. Click **Choose Files.** 3. Browse and select the images you want to import. 4. Click **Upload**. # Connecting to external data ## Overview If you are storing images in the external data source such as amazon aws or Google Drive, you can connect to these images from AnnoStation. These images will remain in the external data source and will not be uploaded to AnnoStation. To connect to the external data source, you need to follow these steps: * Prepare a CSV file * Import the CSV file to AnnoStation * Configure the CORS settings ## Prepare CSV file Include the following fields in your CSV file. | Field | Description | | ---------- | --------------------------------------------------------------------------------------- | | `filename` | A user generated image name. This string is used as a name of the image in AnnoStation. | | `imageURL` | HTTPS path to the external **image** URL | Example: ``` filename,url 42515384_external.jpg,http://127.0.0.1:8080/static/42515384_copy.jpg 73037153_external.jpg,http://127.0.0.1:8080/static/73037153.jpg 73037866_external.jpg,http://127.0.0.1:8080/static/73037866.jpg 10280687_external.jpg,http://127.0.0.1:8080/static/10280687.jpg m_768_42515384_external.jpg,http://127.0.0.1:8080/static/m_768_42515384.jpg ``` ## Import CSV file To import the CSV file to AnnoStation: 1. Select **New** and choose `Import file`. 2. Click the `Use External Data` tab. 3. Select **Choose File** and then select the CSV file you prepared. 4. Click **Import**. {% hint style="info" %} When the CSV file contains images with the same name as the existing images in AnnoStation, you can either **skip** such images or **overwrite** the existing ones. {% endhint %} {% hint style="info" %} An icon next to an image indicates if the image is uploaded to AnnoStation or stored in the external data source. {% endhint %} ### Check the URL of the image file You can check the URL manually for images that are stored in the external data source, and then change the value if needed. 1. Go to an image you want to check the URL path, select the `...` button on the right and then choose `File settings`. 2. This opens the External dataset editing dialog. You can change the file name and URL, and click on **Save**. ## Setup **Cross-origin resource sharing** (**CORS**) option Cross-origin resource sharing (CORS) is a mechanism that allows resources, in this case images, to be requested from AnnoStation which belongs to another domain outside the domain from which the first resource was served such as amazon aws or Google Drive. In order for AnnoStation to successfully display an image, you need to configure the external data source to allow cross-origin requests. If cross-origin requests are not allowed, AnnoStation will not be able to display images. In that case, you can force all the images to be rendered from the AnnoStation server. To turn it on: 1. Go to the `Setting` page of the Project. 2. Open `Advanced settings`, and then select `Force all the images render from server to prevent CORS issue`. 3. Click on **Update Project**. {% hint style="warning" %} If the image cannot be displayed due to the CORS issue, AnnoStation will display the error message. If you see the error, try enabling the CORS option. {% endhint %} # Organizing datasets You can create a hierarchy within your Project to better organize your datasets by creating folders. ## Create a folder 1. Select **New** and choose `Create folder`. 2. Provide a desired name. {% hint style="info" %} We support unlimited levels of the hierarchy so you can create as many folders as needed. {% endhint %} ## Move images between folders You can move an existing image or images to a different folder using the `Move to` menu. ## Delete images or folders You can delete existing images or folders using the `Delete` menu, however make sure you are certain about the action as it cannot be reversed. {% hint style="warning" %} Deleting a folder deletes all images included in the folder including sub-folders. {% endhint %} # Defining labels ## Overview Creating high-quality training data requires clean and well-thought labels. AnnoStation supports the following two types of labels: | Type | Description | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Segmentation | Segmentation is typically used to train the model to recognize the precise shape of an object. It is used to label *each pixel* of an image with a corresponding ***class*** of what is being represented. | | Vector |

Vector is often used to detect a certain object within an image. It is used to label the outline of shapes of an object with a corresponding class of what is being represented.

AnnoStation supports the following types of vector objects:

| For vector labels, you can also define [custom attributes](/mastering-annostation/projectsetup/labels#custom-attributes) for additional classification. ## Create a new label 1. Go to the `Annotation Labels` tab. 2. Click on **Add label**. 3. Provide a name and choose a color. 4. Select if the label is **Segmentation** or **Vector**. * For vector labels, you can define custom attributes. 5. Select **Create Label**. ### Custom attributes When you want to classify an annotated object, using custom attributes is a powerful way. AnnoStation supports the following types of custom attributes: | Type | Description | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Single Text | | | Radio button | | | Checkbox | | | Dropdown |

| **To add custom attributes:** 1. Against vector labels, select **Add attribute.** 2. Provide a name of the attribute, and select the type. 3. Add response options (if applicable for your attribute type). 4. Include "Other" as an option if desired by selecting **Write-in Choice.** 5. To add more attribute, click **Add attribute**. ## Modify Labels You can modify labels, however make sure you are certain about the action as it will impact all existing annotation associated with the label. To modify a label, go to the label you want to modify, and select the pencil icon on the left. {% hint style="info" %} * Changing the name or color will update the existing annotations. * Deleting attributes or options will remove existing attributes or values. * Changing the type of an attribute may result in removing existing values if it is not possible to preserve. {% endhint %} ## Delete Labels You can delete labels, however make sure you are certain about the action as it will delete all existing annotations associated with the label and it cannot be reversed. To delete a label, go to the label you want to delete, and select the trash bin icon on the left. # Adding Project members Once the Project is set up and ready for annotation, it is time to add members to your Project. ## Add Members to Project 1. Go to the `Members` tab. 2. Click on **Add member**. 3. Go to a member you want to add and select a checkbox. 4. Define the [role](/mastering-annostation/projectsetup/project-members/project-member-roles) of the member. 5. Select **Add**. {% hint style="info" %} You can only add members who belong to your Organization. If you do not see members in the list, you first need to [invite them to your Organization](/mastering-annostation/organization). {% endhint %} ## Remove Members from Project You can remove a member by clicking the trash bin icon next to the member you want to remove. # Project member roles Project members can be either a Manager, Developer, or Annotator. ## Manager Managers act as a Project Manager for the Project and have full administrative permissions for the Project. **They can**: * **Project administration** * Rename/delete Project * Change the setting * Assign/unassign annotators * Add/remove members * Add/delete labels
* **Working with datasets** * Add/delete datasets * Create folders * Download image files * Download annotation data
* **Annotation** * Annotate images * **Collaboration** * Review images * Leave comments ## Developer Developers are active contributors to the Project, but unlike Managers, they have partial administrative permissions. **They can**: * **Project administration** * Add/remove members * Add/delete labels
* **Working with datasets** * Add/delete datasets * Create folders * Download image files * Download annotation data
* **Annotation** * Annotate images * **Collaboration** * Review images * Leave comments ## Annotator Annotators are active contributors to the Project, but have no administrative permissions. **They can**: * **Annotation** * Annotate images * **Collaboration** * Leave comments ## Recap Here is a visual summary of the different permission levels for each role: | | Manager | Developer | Annotator | | -------------------------- | :------------------: | :------------------: | :------------------: | | **Project administration** | | | | | Rename/delete Project | :white\_check\_mark: | :x: | :x: | | Change Project settings | :white\_check\_mark: | :x: | :x: | | Assign/unassign annotators | :white\_check\_mark: | :x: | :x: | | Add/remove members | :white\_check\_mark: | :white\_check\_mark: | :x: | | Add/delete labels | :white\_check\_mark: | :white\_check\_mark: | :x: | | **Working with datasets** | | | | | Add/delete datasets | :white\_check\_mark: | :white\_check\_mark: | :x: | | Download image files | :white\_check\_mark: | :white\_check\_mark: | :x: | | Download annotation data | :white\_check\_mark: | :white\_check\_mark: | :x: | | **Annotation** | | | | | Annotate images | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | | **Collaboration** | | | | | Review images | :white\_check\_mark: | :white\_check\_mark: | :x: | | Leave comments | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | # Assigning annotators Annotators can jump onto any image that is not yet started or you can assign annotators to specific images for better traceability. You can also automatically distribute images among multiple annotators. ## Assign an annotator You can assign images to an annotator using `Assign annotator`. When an image is assigned to an annotator, the name is shown as Assignee. Annotators can use this information to easily filter out images that they are assigned to. {% hint style="info" %} Assigning an annotator to an image does not prevent other members to annotate such images. {% endhint %} ## Assign multiple annotators at once If you want to distribute images among multiple members, batch assignment is a powerful way. 1. Open the dropdown next to Project breadcrumb. 2. Select `Assign annotator`. * Choose `Without subfolders` if you want to select images in the current directory but exclude images within subfolders. * Choose `With subfolders` if you want to select all images within the current directory including images within subfolders. 3. (Optional) Change the number of files to be assigned to annotators. 4. Select members you want to assign the images to. {% hint style="info" %} The number of files shows only those that are currently not assigned to any annotator. {% endhint %} ## Unassign annotators You can unassign annotators using the same methods as assigning annotators. # Working with a Project ## Overview AnnoStation provides a simple and intuitive user interface. Once in a Project, you can simply start working to get your job done. Here are some key points to get an overview of working with datasets in AnnoStation. ### Search You can search for images based on the filename. **Learn more about our search functionality here:** {% content-ref url="/pages/-MF-L2DbILR-dMn5sjj5" %} [Searching for images](/mastering-annostation/project/search) {% endcontent-ref %} ### Project breadcrumb You can use the breadcrumb to navigate through your Project. The drown-down icon next to your current location provides access to batch operations you can perform against all images in the current directory including or excluding images within subfolders. ### Reporting The Report panel provides an overview of the current annotation status. #### You can read more about reporting in here: {% content-ref url="/pages/-MFk-qkIGAiQKavTmDj5" %} [Report panel](/mastering-annostation/project/report) {% endcontent-ref %} ### Sort and Filter You can sort or filter images based on the annotations status, Assignee, etc. **You can learn more about our search functionality here:** {% content-ref url="/pages/-MF8e3Kw8GMI6LX0vlbx" %} [Sorting and Filtering](/mastering-annostation/project/sort-and-filter) {% endcontent-ref %} ### Select target files to perform actions You may often need to perform a certain action against target images, e.g. Download annotation results or Move specific images to a different folder. Such target can be: * a single image * specific images * all images in a current location with or without subfolders * based on the search result or filtered images **You can read more about selecting files here:** {% content-ref url="/pages/-MFoeSsrPKXF7QOa2kM8" %} [Selecting target files to perform actions](/mastering-annostation/project/selecting-target-files-to-perform-actions) {% endcontent-ref %} # Selecting target files to perform actions You may often need to perform a certain action against target images, e.g. Download annotation results or Move specific images to a different folder. You can easily identify and select your target images in AnnoStation. There are four ways to determine your target image: * a single image * specific images * all images in a current location with or without subfolders * based on the search result or filtered images ### Select a single image to perform an action: 1. Go to the image you want to perform an action. 2. Select the `...` button on the right and then choose a desired action from the drop-down menu. ### Select specific images to perform an action: 1. Select a checkbox next to the images you want to perform an action. 2. Click on **Actions** and then choose a desired action from the drop-down menu. ### Perform an action against all images in a current location 1. Click the dropdown icon next to Project breadcrumb. 2. Select a desired action from the drop-down menu. * Choose `Without subfolders` if you want to select images in the current directory but exclude images within subfolders. * Choose `With subfolders` if you want to select all images in the current directory including images within subfolders. ### Perform an action based on the search result or filtered images 1. Search or filter images. 2. In the display of results, you can do any of the above three options: * Select a single image to perform an action * Select specific images to perform an action * Perform an action against all the matched results by using the drop-down menu in the breadcrumb # Searching for images You can search for images based on the filename. Regardless your current location, it searches for images within the entire Project. ### Display of results The breadcrumb indicates the number of results found in the Project. You can also use the drop-down menu within the breadcrumb to perform batch operations against the found results. {% hint style="info" %} The file name contains a full path. If the found result exists within a subfolder, it contains the names of such subfolders. {% endhint %} # Sorting and Filtering You can use the drop-down menu next to the column header to sort or filter images. | Column | Available actions | | -------- | --------------------------------------------------------- | | Name | | | Status | | | Assignee | | # Report panel The report panel provides important metrics to help you understand the progress of your project. | Field | Description | Status of image | | --------------- | ------------------------------------------------------------- | ------------------------------------------- | | **Total** | The total number of images. | All | | **To do** | The number of images that have not started. | New | | **In Progress** | The number of images that have started but not yet submitted. |

In Progress

Waiting for change

| | **Submitted** | The number of images that are submitted by annotators. | Waiting for review | | **Approved** | The number of images that are approved by reviewers. | Done | {% hint style="info" %} The number is calculated based on the current location. It counts images that exist in the current directory including subfolders. If you go down a hierarchy, the number is recalculated based on the new location. {% endhint %} These metrics are connected to the Project workflow. **If you want to understand more about workflow, take a look here:** {% content-ref url="/pages/-MF3VMiAoV5z5u-LHqTP" %} [Workflow and status management](/mastering-annostation/workflow-and-status-management) {% endcontent-ref %} # Workflow and status management AnnoStation provides the build-in workflow so that you can easily track the status of your Project. The status of the image changes as it passes key checkpoints. ## Status The table below summarizes a list of status and who can make changes against an image in each status. Annotators are members with the Annotator [role ](/mastering-annostation/projectsetup/project-members/project-member-roles)and Reviewers are members with the Developer or the Manager [role](/mastering-annostation/projectsetup/project-members/project-member-roles). | Status | Description | Annotator | Reviewer | | ------------------ | ----------------------------------------------- | :------------------: | :------------------: | | New | No action has been taken against the image. | :white\_check\_mark: | :white\_check\_mark: | | In Progress | Some changes are saved for the image. | :white\_check\_mark: | :white\_check\_mark: | | Waiting for review | The image was submitted for review. | :x: | :white\_check\_mark: | | Waiting for change | Reviewers asked for change based on the review. | :white\_check\_mark: | :white\_check\_mark: | | Done | Reviewers passed the image based on the review. | :x: | :white\_check\_mark: | ## Workflow ![](https://776641706-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MFt1wP1Z1cQZQyKEtMt%2F-MFtFA6E29r91U65XZmN%2FWorkflow_NoSkip.jpg?alt=media\&token=f603c2a1-c6d0-47eb-a1d8-fa25c3a5dfd5) # Annotating an image AnnoStation is designed to foster the maximum productivity of annotators. ## Steps Here are some typical user steps to annotate an image in AnnoStation. 1. Open an image. 2. [Select a label](/mastering-annostation/annotating#select-a-label). 3. [Select an appropriate tool](/mastering-annostation/annotating#select-a-tool). 4. [Change the zoom level](/mastering-annostation/annotating#adjust-an-image-to-annotate) and annotate an object. 5. (Optional) [provide attribute values](/mastering-annostation/annotating#provide-attribute-values). 6. [Submit an image](/mastering-annostation/annotating#submit-an-image). 7. Move to the next image. You can use keyboard shortcut keys to switch between these operations. **You can learn all supported keyboard shortcut keys here:** {% content-ref url="/pages/-MF-06SWo1Qe4S745Eb2" %} [Keyboard shortcuts](/resources/shortcut) {% endcontent-ref %} ### Select a label Select a label to start annotating an object from[ a list of labels defined for the Project](/mastering-annostation/projectsetup/labels). ### Select a tool You can use various tools, such as Path, Polygon, Bounding Box, etc to annotate an object. Available tools are different depending on if the selected label is segmentation or vector. **To learn more about supported tools, read here:** {% content-ref url="/pages/-MF-KokNzgugNWsrUAFJ" %} [Annotation tools](/mastering-annostation/annotating/annotation-tools) {% endcontent-ref %} ### Control the view of an image To achieve precise annotation, you can adjust the zoom level of an image: * Zoom in/out * Pan * Fit to the window {% hint style="info" %} You can also use the `Ctrl or ⌘ + Mouse Wheel` to zoom in our out. {% endhint %} ### Provide attribute values If attributes are associated with a vector label, you are asked to provide values as soon as you complete drawing a vector shape. ### Submit an image Once you are done with annotating all objects, you can submit an image. Once an image is submitted, you can no longer make modifications unless you are *Developers* or *Managers* so make sure you annotated everything. {% hint style="info" %} You can also **save** an image before submitting an image. {% endhint %} **To learn more about the workflow function, read here:** {% content-ref url="/pages/-MF-1SjkL6drKJM\_X1Tl" %} [Working with a Project](/mastering-annostation/project) {% endcontent-ref %} ### Comment Leaving a comment is a great way to raise a flag and avoid possible iterations in the later phase. **You can learn more about our comment features here:** {% content-ref url="/pages/-MFkIT9-ioY1524rWMlH" %} [Comments](/mastering-annostation/collaboration/comments) {% endcontent-ref %} # Annotation tools Available tools are different depending on the type of the selected label. | Tool | Description | Segmentation | Vector | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | :------------------: | :------------------: | | Polygon | Create a polygon | :white\_check\_mark: | :white\_check\_mark: | | Bounding Box | Create a rectangle | :white\_check\_mark: | :white\_check\_mark: | | Point | Create a point | :no\_entry\_sign: | :white\_check\_mark: | | Path | Draw a straight line | :white\_check\_mark: | :white\_check\_mark: | | Selector | Select a vector shape | :no\_entry\_sign: | :white\_check\_mark: | | Pencil | Draw a free-form line | :white\_check\_mark: | :no\_entry\_sign: | | Polygon Eraser | Erase unwanted pixels using a polygon | :white\_check\_mark: | :no\_entry\_sign: | | Pencil Eraser | Erase unwanted pixels using a free-form line | :white\_check\_mark: | :no\_entry\_sign: | ## Segmentation Segementation create raster bitmaps. You can use various shapes to add or remove pixels. {% hint style="info" %} When you draw a shape using segmentation labels, it's like painting an image with the shape, thus it doesn't keep points of the shape once you drew it. If you want to modify the shape of a bitmap, you need to add more pixels using a shape or use eraser tools to erase unwanted pixels. {% endhint %} ## Vector Vector shape consists of single or multiple points. ### Edit a shape You can use the `Selector` tool to select a shape. You can move or delete the entire shape, or edit an individual point to modify the shape. ![](https://776641706-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MG6ZyA0tCyAYDEqOgJt%2F-MG6dvCFHZKuEYNU3PQ7%2FAnimated%20GIF-downsized_large.gif?alt=media\&token=b31e05e6-0ab3-4e89-b3b2-8ed174673d2b) {% hint style="info" %} You can double-click a point to remove it. {% endhint %} # Reviewing annotation Once an image is completed and [submitted](/mastering-annostation/annotating#submit-an-image), reviewers can check annotation for quality assurance. 1. If annotation requires no modification, click on **Pass**. 2. If annotation requires modification, select **Ask for change.** 3. Optionally [leave comments](/mastering-annostation/collaboration/comments) if further clarification is needed. Depending on the result of the review, the status of the image changes. **You can read more about workflow and status management here:** {% content-ref url="/pages/-MF3VMiAoV5z5u-LHqTP" %} [Workflow and status management](/mastering-annostation/workflow-and-status-management) {% endcontent-ref %} # Collaboration ## **Comments** Commenting can be a great way to remove ambiguity at an early stage of your project. Annotators can ask questions about edge cases or reviewers can clarify what changes are needed. **If you want to get more details on comments features you can have a look here:** {% content-ref url="/pages/-MFkIT9-ioY1524rWMlH" %} [Comments](/mastering-annostation/collaboration/comments) {% endcontent-ref %} ## **Collaborating with external Organizations** You may need to work with external partners for some Projects. You can invite external Organizations to your Project so that members from the external Organization can start accessing your Project. Learn more about collaborating with external Organizations here: {% content-ref url="/pages/-MFkIYQ-fqBw\_Bw14cSe" %} [Sharing Projects with external Organization](/mastering-annostation/collaboration/collaborating-with-external-organization) {% endcontent-ref %} # Comments Commenting can be a great way to remove ambiguity at an early stage of your project. Annotators can ask questions about edge cases or reviewers can clarify what changes are needed. ## Comment within an image ### Enter the comment mode You can view existing comments in the image or leave a new comment in the comment mode. To enter the comment mode, click on the **Comment** icon in the toolbar. ### Leave a comment 1. While you are in the comment mode, click anywhere in the image where you want to leave a comment 2. Enter texts and choose **Send**. #### Comment status The comment can be either **Unresolved** or **Resolved**. * A new comment is added as a **Unresolved** comment. * In the Project view, you can see a total number of Unresolved comments for eacn image. If you select **Resolved**, the comment becomes **Resolved**. ### Exit from the comment mode You can **exit** from the comment mode using two methods: * Click on the **Comment** icon again OR * Select any of [annotation tools](/mastering-annostation/annotating/annotation-tools) or navigate to a different image ## Reply to a comment You can reply to a comment and continue the discussion. {% hint style="info" %} Once the original issue is closed, for instance, an annotator fixed the issue with annotation, it is a good practice to resolve the comment. In this way, you can always track only Unresolved comments. {% endhint %} # Sharing Projects with external Organization You may need to work with external partners such as an annotation company or your clients for some Projects. You can invite external Organizations to your Project so that members from the external Organization can start accessing your Project. {% hint style="info" %} You can always invite your external members directly to your Organization as well. This is easier if you know exactly whom you need to invite, otherwise collaboration allows you to remove the overhead of managing members of the external Organization. {% endhint %} ## Invite external Organization to Project 1. Go to the Project you want to start collaborating with an external Organization. 2. Select the `Setting` tab, and then expand `Advanced settings`. 3. Turn on `Allow other organization to access via link`. A link will be generated which grants access to this Project. This link can be revoked anytime. 4. Copy the link and share it with a member of the external Organization. ### Start Collaboration To start collaborating, a member of the external Organization needs to activate collaboration by clicking the link you shared: 1. The member is asked to log in to AnnoStation. 2. If the member belongs to more than one Organization, select an Organization with which the Project is going to be shared. 3. Confirm the invitation. Once it is confirmed, the shared Project will start to appear in both Organizations. The shared Project is indicated so in the list of Projects. {% hint style="warning" %} You can only collaborate with [active members](/mastering-annostation/organization/member-types) that have an Organization created in AnnoStation. {% endhint %} ### Administration of a shared Project For the external Organization, the shared Project works slightly different compared to standard Projects. The first member who accepted the invitation acts as a Manager of the Project. Managers can add members to the shared Project from their Organization, but unlike standard Projects, they can only contribute to the project without any administrative permissions. **To learn more about how Project member roles work in shared Projects, read here:** {% content-ref url="/pages/-MFnoukYLs8AU3Dxp-Rb" %} [Project member roles in shared Projects](/mastering-annostation/collaboration/collaborating-with-external-organization/project-member-roles-in-shared-projects) {% endcontent-ref %} ## Workflow in a shared Project Since two Organizations are contributing to a shared Project, the review process can take place in both Organizations independently. An initial review cycle happens in the external Organization. Only when an image is approved, it can move on to the final review cycle in the host Organization. **You can learn more about how the workflow works in a shared Project here:** {% content-ref url="/pages/-MFoZ7CROmvdcMEUwACr" %} [Workflow in shared Projects](/mastering-annostation/collaboration/collaborating-with-external-organization/workflow-in-a-shared-project) {% endcontent-ref %} ## Stop Collaboration Collaboration can be stopped at any time from both ends. 1. Go the Project that you want to stop collaborating. 2. Go to the `Setting` tab. 3. Select `Stop collaborating with `. # Project member roles in shared Projects Project members in the external Organization can be either a Manager, or Annotator in shared Projects. ## Manager in a shared Project Managers in the external Organization are active contributors to the Project but do not have administrative permission except adding/removing members from their own Organization. **They can**: * Project administration * Add/remove members from their own Organization * Annotation * Annotate images * Collaboration * Leave comments ## Annotator in a shared project Annotators are active contributors to the Project, but have no administrative permissions. **They can**: * Annotation * Annotate images * Collaboration * Leave comments ## Recap Here is a visual summary of the different permission levels for each role: | | Host | | | External | | | -------------------------- | :------------------: | :------------------: | :------------------: | :------------------: | :------------------: | | | Manager | Developer | Annotator | Manager | Annotator | | **Project administration** | | | | | | | Rename/delete Project | :white\_check\_mark: | :x: | :x: | :x: | :x: | | Change Project settings | :white\_check\_mark: | :x: | :x: | :x: | :x: | | Assign/unassign annotators | :white\_check\_mark: | :x: | :x: | :x: | :x: | | Add/remove members | :white\_check\_mark: | :white\_check\_mark: | :x: | :white\_check\_mark: | :x: | | Add/delete labels | :white\_check\_mark: | :white\_check\_mark: | :x: | :x: | :x: | | **Working with data set** | | | | | | | Add/delete data set | :white\_check\_mark: | :white\_check\_mark: | :x: | :x: | :x: | | Download image files | :white\_check\_mark: | :white\_check\_mark: | :x: | :x: | :x: | | Download annotation data | :white\_check\_mark: | :white\_check\_mark: | :x: | :x: | :x: | | **Annotation** | | | | | | | Annotate images | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | | **Collaboration** | | | | | | | Review images | :white\_check\_mark: | :white\_check\_mark: | :x: | :white\_check\_mark: | :x: | | Leave comments | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | # Workflow in shared Projects ## Status in shared Projects The table below summarizes a list of image status and who can make changes against an image in each status. | Status | Description |

Annotator

(External)

|

Reviewer

(External)

|

Annotator

(Host)

|

Reviewer

(Host)

| | --------------------------------- | ------------------------------------------------------------------------------ | :-------------------------------: | :------------------------------: | :---------------------------: | :--------------------------: | | New | No action has been taken against the image. | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | | In Progress | Some changes are saved for the image. | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | | Waiting for collaborator's review |

The image was submitted for review by the external organization.

| :x: | :white\_check\_mark: | :x: | :white\_check\_mark: | | Waiting for owner's review | Reviewers in the external Organization passed the image. | :x: | :white\_check\_mark: | :x: | :white\_check\_mark: | | Waiting for change | Reviewers asked for change based on the review. | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | | Done | Reviewers in the host Organization passed the image based on the review. | :x: | :x: | :x: | :white\_check\_mark: | ## Workflow in shared Projects ![](https://776641706-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MFt1wP1Z1cQZQyKEtMt%2F-MFtFLtg15Yg6jUMCkxU%2FWorkflow_Collabo_NoSkip.jpg?alt=media\&token=b41215f3-d436-40e8-a138-e8176a0692cd) # Exporting datasets You can export annotation results and image files at any time. ## Exporting annotation results Annotation results can be exported from the Project at any time using `Download annotation data`. Annotation results are exported in the JSON format. **To learn more about the JSON format, read here:** {% content-ref url="/pages/-MF--o3BVqrC3IGsmGYk" %} [JSON format](/resources/json) {% endcontent-ref %} ## Exporting image files Image files can be exported from the Project at any time using `Download files`. # JSON format ## Data format ``` { "filename": STRING, "id": STRING, "status": STRING, "width": INTEGER, "height": INTEGER, "labels": [ { "name": STRING, "type": STRING, "color": STRING, "annotations": [RLE] or [vectors] }, ... ] } ``` * **filename**: Name of the image, pathname included. * **id**: ID of the annotation data in Annostation. * **status**: Status of the image, the possible values are: `new`, `in_progress`, `waiting_for_review`, `waiting_for_collaborator_review`, `waiting_for_owner_review`, `waiting_for_change`, `done` and `skipped` * When to use `waiting_for_review`, `waiting_for_collaborator_review` or `waiting_for_owner_review`: * If the project of the image is not being collaborated, simply use `waiting_for_review` * If the project of the image is being collaborated and you want the image to be reviewed by project collaborator, use `waiting_for_collaborator_review` * If the project of the image is being collaborated and you want the image to be reviewed by the project owner, use `waiting_for_owner_review` * **width**: Width of the image. * **height**: Height of the image. * **labels**: Array of objects, each object represents a label in AnnoStation. * **name**: Name of the label. * **type**: Type of the label, the possible values are: `segmentation` and `vector` * **color**: Color of the label. * [**annotations**](/resources/json/json-annotation): Array of RLE (run-length encoding) objects for `segmentation` type or vector objects for `vector` type, depends on `type`. # Annotation ## Annotation An image is composed of array of pixels, and we have two ways to annotate on the pixels, by using the `segmentation` tool (as RLE - run-length encoding) and `vector` tool. ### Segmentation (RLE) RLE (run-length encoding) object is used only when the label type is `segmentation`, and each label contains only one RLE object. When annotating with RLE, we basically annotate the pixel in the image:
An RLE object is represented as: ``` { "type": STRING, "segmentation": [ [x, y, length from x to right], ... ] } ``` * **type**: Type of the segmentation, which currently supports `rle` only. * **segmentation**: Two-dimensional array for RLE. * The minimal unit of segmentation is a 1x1 pixel area, which is an integer. * For example, given by the 4x4 pixel image below with annotation, the array will be: ``` { "segmentation": [ [2, 0, 2], [0, 1, 3], [2, 2, 1] ] } ``` ![](https://776641706-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MFspbkJkiU8E7msmH8W%2F-MFss-VXeB89_z9uMQZ8%2F90091317-9da63f00-dd58-11ea-94e1-a026179baa8a.png?alt=media\&token=d1a6b7f4-6cf4-44fb-a037-cc345566634a) ### vector A vector object is used only when the label type is `vector`, and each label can contain multiple vector objects. When annotating with vector, we basically describe the coordinates of the annotation in the image: ![](https://776641706-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MFspbkJkiU8E7msmH8W%2F-MFssAMnbdv3fbUGJ8aU%2F90106189-a52a1000-dd79-11ea-8c26-ec9afb42ded3.png?alt=media\&token=d75c0313-1079-4a2c-93b6-2c4ce8434ff2) A vector object is represented as: ``` { "type": STRING, "attributes": [ { "name": STRING, "values": [STRING] } ], "segmentation": [x1, y1, x2, y2, ..., xn, yn] } ``` * **type**: Type of the vector object, currently supports `polygon`, `boundingBox`, `path` and `point`. * **attributes**: Custom attributes to describe the vector object. * **name**: Name of the attribute. * **values**: Array of value to the attribute. * **segmentation**: Array of coordinate which represents the vector object. * The minimal unit of segmentation is a coordinate, which is float. * if the segmentation type is `polygon`, the value will be `[x1, y1, x2, y2, ..., xn, yn]`. * if the segmentation type is `boundingBox`, the value will be `[x1, y1, x2, y2, x3, y3, x4, y4]`. * if the segmentation type is `path`, the value will be `[x1, y1, x2, y2, ..., xn, yn]`. * if the segmentation type is `point`, the value will be `[x1, y1]`. * The coordinates can be either clockwise or counterclockwise as long as it follows the order. * For example, given by the 4x4 pixel images below with annotation, the array will be: ![](https://776641706-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MGDAW0CeC7zU0j86EBB%2F-MGDBUPUkflLwNWZ1I8s%2F90107448-68f7af00-dd7b-11ea-87c6-e0875d7ff79a%20\(1\).png?alt=media\&token=bb300e2a-7e86-41cb-b9b4-2ba3fe1ab2c8) ![](https://776641706-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MGDAW0CeC7zU0j86EBB%2F-MGDBbMWY4SxSnuhK_YC%2F90107831-0226c580-dd7c-11ea-9f6f-d714bc0fc883%20\(1\).png?alt=media\&token=c06f178a-acd5-4d3c-87f7-40e8ca4deaa6) # Examples ## One segmentation label ``` { "filename": "PoC/001.jpg", "id": "8051d7cf-ef7f-481e-8ef6-17d77c97fbe4", "status": "waiting_for_review", "width": 1920, "height": 1080, "labels": [ { "name": "Dog", "type": "segmentation", "color": "#ff0000", "annotations": [ { "type": "rle", "segmentation": [ [827, 1209, 5], [826, 1210, 7], [825, 1211, 9] ] } ] } ] } ``` ### Two segmentation labels ``` { "filename": "DCIM001.jpg", "id": "8051d7cf-ef7f-481e-8ef6-17d77c97fbe4", "status": "in_progress", "width": 1920, "height": 1080, "labels": [ { "name": "Dog", "type": "segmentation", "color": "#ff0000", "annotations": [ { "type": "rle", "segmentation": [ [827, 1209, 5], [826, 1210, 7], [825, 1211, 9] ] } ] }, { "name": "Cat", "type": "segmentation", "color": "#91FF00", "annotations": [ { "type": "rle", "segmentation": [ [846, 1273, 11], [846, 1274, 11], [847, 1275, 10] ] } ] } ] } ``` ### One vector label with two shapes ``` { "filename": "/POC/RAW/DCIM001.jpg", "id": "8051d7cf-ef7f-481e-8ef6-17d77c97fbe4", "status": "in_progress", "width": 1920, "height": 1080, "labels": [ { "name": "Car", "type": "vector", "color": "#ff0000", "annotations": [ { "type": "boundingBox", "segmentation": [ 2039, 535, 2649, 535, 2649, 917, 2039, 917 ] "attributes": [ { "name": "status" "values": ["scratch", "dent", ...] } ] }, { "type": "polygon", "segmentation": [85, 48, 74, 85, 15, 59, 73, 17], "attributes": [ { "name": "size" "values": ["medium"] }, { "name": "type" "values": ["SUV"] } ] } ] } ] } ``` ### One segmentation label and one vector label ``` { "filename": "DCIM001.jpg", "id": "8051d7cf-ef7f-481e-8ef6-17d77c97fbe4", "status": "skipped", "width": 1920, "height": 1080, "labels": [ { "name": "Dog", "type": "segmentation", "color": "#ff0000", "annotations": [ { "type": "rle", "segmentation": [ [827, 1209, 5], [826, 1210, 7], [825, 1211, 9] ] } ] }, { "name": "Car", "type": "vector", "color": "#ff0000", "annotations": [ { "type": "boundingBox", "segmentation": [ 2039, 535, 2649, 535, 2649, 917, 2039, 917 ] "attributes": [ { "name": "status" "values": ["scratch", "dent", ...] } ] }, { "type": "polygon", "segmentation": [85, 48, 74, 85, 15, 59, 73, 17], "attributes": [ { "name": "size" "values": ["medium"] }, { "name": "type" "values": ["SUV"] } ] } ] } ] } ``` # Keyboard shortcuts Shortcut keys allow easy and quick methods for navigating or annotating objects. ## Navigation | Windows | Mac | Description | | ------- | --- | --------------------- | | `J` | `J` | Go the Previous Image | | `K` | `K` | Go the Next Image | | `H` | `H` | Back to file list | ## General actions | Windows | Mac | Description | | -------------- | ---- | --------------------------- | | `Ctrl` `S` | `⌘S` | Save image | | `Ctrl` `Enter` | `⌘↩` | Submit Image | | `Shift` `K` | `⌘K` | Approve (Pass) | | `Ctrl` `D` | `⌘D` | Ask for Change (Decline) | | `C` | `C` | Select Comment Tool | | `?` | `?` | Open Keyboard shortcut list | ## View controls | Windows | Mac | Description | | ---------- | ---- | ------------------------- | | `Ctrl` `+` | `⌘+` | Zoom-in | | `Ctrl` `-` | `⌘-` | Zoom-out | | `Ctrl` `0` | `⌘0` | Fit Image with playground | | `N` | `N` | Select Pan(Hand) Tool | ## Annotating ### Label list | Windows | Mac | Description | | ----------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------- | | `1, 2, 3, ..., n` | `1, 2, 3, ..., n` |

Switch to a specific label

The number is assigned automatically to each label from the top of the list

| | `T` | `T` | Show/Hide all labels | ### Actions | Windows | Mac | Description | | ------------------ | ----- | ----------- | | `Ctrl` `Z` | `⌘Z` | Undo | | `Ctrl` `Shift` `Z` | `⌘⇧Z` | Redo | ### Annotation Tools You need to select a label first in order to use the following shortcuts. #### Common | Windows | Mac | Description | | ------- | --- | ------------ | | `P` | `P` | Polygon | | `B` | `B` | Bounding Box | | `A` | `A` | Path | #### Segmentation only | Windows | Mac | Description | | ----------- | ---- | -------------- | | `L` | `L` | Pencil | | `Shift` `P` | `⇧P` | Polygon Eraser | | `Shift` `L` | `⇧L` | Pencil Eraser | #### Vector only | Windows | Mac | Description | | ------- | --- | ----------- | | `O` | `O` | Point | | `S` | `S` | Selector | # FAQ ## Where and how is my data stored? All user data and content is stored in Japan on [amazon aws](https://aws.amazon.com/). Some content (e.g: HTML pages) may be cached by our CDN in other countries to improve end-user performance. ## Who has rights to the data? Your data is yours. We respect your privacy and when you create an account you don't grant us any rights to your data, except for the ones that needs for the application functioning. We don't use your data for any commercial or non-commercial purposes and share it with nobody. You can learn more in the [terms of service](https://www.orni.co.jp/annostation/terms). ## **How can I reset my password?** You can reset your password via the following link: [Reset password](https://annostation.com/users/password/new). Make sure you use the same email address you used when you signed up. ## What browsers are supported by **AnnoStation**? AnnoStation supports the current versions of [Chrome](https://www.google.com/chrome/), [Firefox](http://www.mozilla.org/firefox/), and [Safari](http://www.apple.com/safari/). # AnnoStation ナレッジベース ## はじめに [**AnnoStationを使い始める**](/jpn/getting-started/intro)\ ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MF9U1xZymkpqYXQ_gqi%2F-MF9bAtXaR995KNyOjBN%2Frocket_96px.png?alt=media\&token=3350151a-f988-4d32-acf0-d9e09321f502) ## トピックを参照 | | | | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |


Organization

|



プロジェクトの設定

|


プロジェクト

| |


ワークフロー

|


アノテーション

|


レビュー

| |

コラボレーション

|

​ ​

​エクスポート

| | ## リソース {% content-ref url="/pages/-MF--o3BVqrC3IGsmGYk" %} [JSONフォーマット](/jpn/resources/json) {% endcontent-ref %} {% content-ref url="/pages/-MF-06SWo1Qe4S745Eb2" %} [キーボードショートカット](/jpn/resources/shortcut) {% endcontent-ref %} {% content-ref url="/pages/-MG7DccY18mA2\_cw6j89" %} [よくある質問](/jpn/resources/faq) {% endcontent-ref %} # AnnoStationとは AnnoStationは画像認識AIを牽引する開発チーム向けアノテーションソフトウェアです。 アノテーションの質は、画像認識AIモデルの精度に大きな影響を及ぼします。AnnoStationは、アノテーションツール、プロジェクト管理機能、コラボレーションサポートなど、高品質なトレーニングデータを効率的に作成するために必要なすべての機能を提供し、チームのプロジェクトを成功へと導きます。 ## AnnoStationで実現できること * **使いやすいく豊富な機能を備えたアノテーションツールでアノテーターの生産性を向上。** セマンティックセグメンテーションでもオブジェクト認識でも、AnnoStation には高品質で正確なアノテーションを実現するための豊富なツールが用意されています。 ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MFDmcv8zDmigY7C541N%2F-MFDpr8BgprLnDEMsod-%2Fsolution_6_AnnotateAccurate.png?alt=media\&token=94f17a6e-358d-449e-83c5-2395ae6f2a66) * **迅速にフィードバックループをまわして、効率的に一貫性のあるアノテーションを実現。** リアルタイムのコラボレーションにより、アノテーションとフィードバックを同じアプリケーション内で行えます。不要なやりとりを減らし、一貫したアノテーションを保証します。 ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MG2slF7K-g9LLw5foah%2F-MG2vkOIG21XVUAJxSjX%2F2020-08-31_185149.png?alt=media\&token=d609bc03-75c2-46e4-9cd5-c4563b9f2fa0) * **常にプロジェクトの状況を把握し、最新の情報に基づいた意思決定を行う事で、プロジェクトの遅延を回避できます。** ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MG2slF7K-g9LLw5foah%2F-MG2x0SoyZYnZM75HKZt%2F2020-08-31_185759.png?alt=media\&token=818d424b-b2e1-4649-9b20-67840e04d8e0) プロジェクトの最新の状況を常に把握できます。アノテーションの進み具合やフィードバックの内容など、プロジェクトに関するすべての情報をベースにより良い判断を下すことで、プロジェクトの遅延やボトルネックを回避することができます。 # クイックスタート ## クイックスタート ### **アカウントを作成して AnnoStation の使いはじめる** 1. AnnoStationのウェブサイトを訪問してください。**新しいアカウントを作成**し、30日間のトライアルを開始します。 * サインアップ後に、確認のメールが送信されます。 2. メールアドレスを確認します。 3. AnnoStationに**ログイン**します。 {% hint style="info" %} すべてのトライアルアカウントは30日間無料で、クレジットカードは必要ありません。 {% endhint %} #### **あなたのOrganizationにメンバーを招待します** AnnoStationを最大限に活用するにはOrganizationにメンバーを招待してください。[メンバーの種類](/jpn/mastering-annostation/organization/member-types)を定義し、Organizationやプロジェクトの管理を担当する人を決めます。 **組織と招待方法についての詳細はこちらをご覧ください。** {% content-ref url="/pages/-MF3U9Nx9D4Z-Rh\_kz2l" %} [Organization](/jpn/mastering-annostation/organization) {% endcontent-ref %} **Organizationに招待されましたか？** Organizationへの招待メールを受け取った場合、招待されたチームとのコラボレーションをすぐに開始できます。Organizationに参加する前に、正しいアカウントでログインしていることを確認してください。 ### 画像をアノテーションする #### プロジェクトを作成する 新しいプロジェクトを作成することでAnnoStationを使い始められます。プロジェクトごとに、画像をインポートしたり、アノテーションラベルを設定できます。 **プロジェクトの設定方法についての詳細はこちらをご覧ください。** {% content-ref url="/pages/-MF--dai9QMvAvT6D3nX" %} [プロジェクトの設定](/jpn/mastering-annostation/projectsetup) {% endcontent-ref %} {% hint style="info" %} プロジェクトを作成するボタンが表示されませんか？新規プロジェクトを作成するには、組織の[オーナー](/jpn/mastering-annostation/organization/member-types)である必要があります。 {% endhint %} **メンバーの種類について知りたい場合はこちらをご覧ください。** {% content-ref url="/pages/-MFi94gCvAvKxtn1g1W3" %} [メンバーの種類](/jpn/mastering-annostation/organization/member-types) {% endcontent-ref %} #### 画像のインポート ローカルディレクトリからプロジェクトに画像をインポートしたり、amazon S3やGoogle Driveなどの外部データソースに保存されている画像を接続したりすることができます。 **画像のインポートと外部データへの接続についての詳細はこちらをご覧ください。** {% content-ref url="/pages/-MF-LMumQctyTf4ZBbxU" %} [外部データを使用する](/jpn/mastering-annostation/projectsetup/data-set/connecting-to-external-data) {% endcontent-ref %} #### **アノテーションの開始** 画像を開いて、対象となるオブジェクトをアノテーション（ラベル付け）します。プロジェクト用に定義されたラベルリストから目的のラベルを選択します。ラベルがベクターなのかセグメンテーションなのかによって、オブジェクトにアノテーションを行うツールを使い分けることができます。 **アノテーション機能の詳細については、こちらを参照してください。** {% content-ref url="/pages/-MF-0cxQAUmQekgdpze-" %} [画像をアノテーションする](/jpn/mastering-annostation/annotating) {% endcontent-ref %} キーボードショートカットキーを使用して、ツールを素早く切り替えることができます。 **サポートされているすべてのキーボードショートカットキーはこちらで確認できます。** {% content-ref url="/pages/-MF-06SWo1Qe4S745Eb2" %} [キーボードショートカット](/jpn/resources/shortcut) {% endcontent-ref %} 画像に含まれるすべてのオブジェクトをアノテーションしたら、**Submit**をクリックし、アノテーションが終了したことを登録します。画像のステータスが変更されるため、レビュー担当者はどの画像がレビューを必要としているかを簡単に知ることができます。 **ワークフローの詳細についてはこちらをご覧ください。** {% content-ref url="/pages/-MF3VMiAoV5z5u-LHqTP" %} [ワークフローとステータス管理](/jpn/mastering-annostation/workflow-and-status-management) {% endcontent-ref %} ## **コラボレーション** AnnoStationは生産性を最大化するさまざまなコラボレーション機能を提供しています。 #### **コメント・レビュー** アノテーターが何をどう修正したらよいのか間違いなく理解するには、問題がある箇所にコメントし、詳細な指示を出すのが効果的です。 **レビュー機能の詳細を知りたい場合は、こちらをご覧ください:** {% content-ref url="/pages/-MF-1g\_w97WEnZYbWLfl" %} [アノテーションをレビューする](/jpn/mastering-annostation/review) {% endcontent-ref %} #### **特定の画像にアノテータをアサインする** まだアノテーションが開始されていない画像をランダムに選んでアノテーションすることもできますが、特定の画像をアノテータに割り当てるとトレーサビリティを向上できます。複数のアノテータに自動的に画像をアサインしたり、特定のメンバーに画像をアサインできます。 **アサイン機能についての詳細はこちらをご覧ください**。 {% content-ref url="/pages/-MF3SU3bgK9YuCD\_bDS5" %} [アノテータをアサインする](/jpn/mastering-annostation/projectsetup/assigning-annotators) {% endcontent-ref %} **パートナーとプロジェクトを共有する** プロジェクトによっては、外部のパートナーと協力する必要があります。パートナーのOrganizationをプロジェクトに招待すると、そのOrganizationのメンバーがプロジェクトにアクセスできるようになります。 {% hint style="info" %} 外部のパートナーをあなたのOrganizationに直接招待することもできます。これは、招待する必要があるメンバーを正確に知っていれば簡単です。そうでない場合、パートナーのOrganizationとプロジェクトを共有することにより、パートナーのメンバーをあなた自身が管理する必要がなくなります。 {% endhint %} パートナーとのコラボレーションについてはこちらをご覧ください。 {% content-ref url="/pages/-MFkIYQ-fqBw\_Bw14cSe" %} [別のOrganizationとプロジェクトを共有する](/jpn/mastering-annostation/collaboration/collaborating-with-external-organization) {% endcontent-ref %} # Organization ## Organizationとは？ Organizationにはプロジェクトに参加するメンバーが属します。同僚やクライアント、パートナーをOrganizationに招待し、AnnoStationでのコラボレーションを開始します。 {% hint style="info" %} 複数のOrganizationに所属することができます。複数のOrganizationに所属している場合は、ログイン後に作業するOrganizationを選択することができます。 {% endhint %} ## あなたのOrganizationにメンバーを招待する 1. `Organization Members`タブを選択します。 2. **Invite member**をクリックし、招待したいメンバーのメールアドレスを入力します。 3. **Send invitation**を選択します。 * そのメンバーが初めてAnnoStationを利用する場合、入力したメールアドレスに招待状のメールが送信されます。 これで、メンバーがOrganizationに追加されたことが確認できます。管理者権限を与えたい場合は、メンバーの種類を `owner` に変更する必要があります。 {% hint style="info" %} メンバーを招待するには、Organizationのownerである必要があります。 {% endhint %} **メンバーの種類についての詳細はこちらを参照してください。** {% content-ref url="/pages/-MFi94gCvAvKxtn1g1W3" %} [メンバーの種類](/jpn/mastering-annostation/organization/member-types) {% endcontent-ref %} ### メンバーのステータス **保留中** メールアドレスの確認がまだ完了していないメンバーは、ステータスが**Pending**になります。PendingステータスのメンバーはAnnoStationにログインできません。 メンバーが招待を受け入れると、ステータスは**Active**に変わります。 **Active**なメンバーはAnnoStationにログインして、プロジェクトに参加することができます。 ## メンバーの削除 オーナーは削除したいメンバーの横にあるゴミ箱のアイコンをクリックすることで、メンバーを削除することができます。 # メンバーの種類 メンバーはownerまたはmemberになることができます。 ## owner ownerは、あなたのOrganizationの管理者権限を持っています。**ownerは以下のことができます：** * `Organization Members`タブへのアクセス * メンバーの招待 * メンバーの種類を変更 * メンバーの削除 * 新規プロジェクトの作成 * Organization内にあるすべてのプロジェクトへのアクセス {% hint style="info" %} ownerは、Organization内にあるすべてのプロジェクトにアクセスできます。 ただし、プロジェクトの内容にアクセスするには、ownerをプロジェクトメンバーに追加する必要があります。 {% endhint %} プロジェクトメンバーの詳細については、こちらを参照してください。 {% content-ref url="/pages/-MF-1kuOnAWFwxCbpylY" %} [プロジェクトにメンバーを追加する](/jpn/mastering-annostation/projectsetup/project-members) {% endcontent-ref %} ## member memberはプロジェクトに参加できますが、ownerとは異なり、Organizationの管理者権限はありません。**memberは以下のことができます：** * プロジェクトメンバーの一員であるプロジェクトへのアクセス **memberは以下のことはできません：** * `Organization Members`タブへのアクセス * メンバーの招待 * メンバーの種類を変更 * メンバーの削除 * 新規プロジェクトの作成 * Organization内にあるすべてのプロジェクトへのアクセス # プロジェクトの設定 プロジェクトはAnnoStationでトレーニングデータを管理し、アノテーション作業を行うベースとなります。プロジェクト毎にデータセットを追加し、ラベルを定義し、メンバーを追加します。 ## 新しいプロジェクトを作成する ownerは新しいプロジェクトを作成することができます。`Project`タブで**New Project**をクリックし、プロジェクト名を入力してください。 {% hint style="info" %} プロジェクト名はOrganization内でユニークでなければなりません。 {% endhint %} 新しいプロジェクトを作成したら、[データセットを追加](/jpn/mastering-annostation/projectsetup/data-set)しましょう。 ## プロジェクトの名前を変更する プロジェクトの名前を変更するには 1. 名前を変更したいプロジェクトを開きます。 2. `Settings`タブに移動します。 3. 新しい名前を入力して、**Update**をクリックします。 {% hint style="info" %} 名前の変更や削除を行うには、適切な[**ロール**](/jpn/mastering-annostation/projectsetup/project-members/project-member-roles)が必要です。 {% endhint %} **ロールの詳細については、こちらをご覧ください。** {% content-ref url="/pages/-MFjcnxbvRF4C4ToyQXO" %} [プロジェクトメンバーのロール](/jpn/mastering-annostation/projectsetup/project-members/project-member-roles) {% endcontent-ref %} ## プロジェクトの削除 プロジェクトは削除できますが、いったん削除すると、プロジェクト内のデータはすべて消去され、元に戻すことはできません。十分注意して削除するようにしてください。 削除したいプロジェクトを開きます。 1. `Settings`タブに移動します。 2. `Danager zone`を開き、**Delete**をクリックします。 3. 削除するかどうか聞かれるので、動作を確認します。 # データセットを追加する ## 概要 AnnoStationにデータセットを追加するには、2つの方法があります。 1. ローカルディレクトリから画像をインポートし、AnnoStationにアップロードします。 2. amazon S3 や Google Drive などの外部データソース、または社内ネットワークに保存されている画像に接続します。 {% hint style="info" %} 外部データソースに接続する場合、画像自体はAnnoStationにアップロードされません。 {% endhint %} ## サポートされているフォーマット 以下のフォーマットに対応しています。 * JPEG * PNG * GIF # 画像をインポートする ## AnnoStationに画像をインポートする 1. **New**を選択し`Import file`をクリックします。 2. **Choose Files**をクリックします。 3. インポートしたい画像を選択します。 4. **Upload**をクリックします。 # 外部データを使用する ## 概要 amazon awsやGoogle Driveなどの外部データソースに画像を保存している場合、AnnoStationからこれらの画像に接続することができます。 これらの画像は外部データソースに保存されたままで、AnnoStationにはアップロードされません。 外部データソースに接続するには、以下の手順に従ってください。 * CSVファイルを準備します * CSVファイルを AnnoStation にインポートします * CORS の設定を行います ## CSVファイルを準備します 以下のフィールドをCSVファイルに含めてください。 | Field | Description | | ---------- | ----------------------------------------------- | | `filename` | ユーザーが生成した画像名。この文字列は、AnnoStationで画像の名前として使用されます。 | | `imageURL` | 外部に保存された画像URLのパス | 例: ``` filename,url 42515384_external.jpg,http://127.0.0.1:8080/static/42515384_copy.jpg 73037153_external.jpg,http://127.0.0.1:8080/static/73037153.jpg 73037866_external.jpg,http://127.0.0.1:8080/static/73037866.jpg 10280687_external.jpg,http://127.0.0.1:8080/static/10280687.jpg m_768_42515384_external.jpg,http://127.0.0.1:8080/static/m_768_42515384.jpg ``` ## CSVファイルをインポートする CSV ファイルを AnnoStation にインポートするには、以下の手順に従います。 1. **New**を選択し、Import fileを選択する。 2. `Use External Data`タブをクリックする。 3. **Choose Files**を選択し、用意したCSVファイルを選択します。 4. **Import**をクリックします。 {% hint style="info" %} CSVファイル内の画像名がAnnoStation内にすでに存在する場合、そのような画像を**スキップ**するか、既存の画像を**上書き**するかを選択できます。 {% endhint %} {% hint style="info" %} 画像の横にあるアイコンは、画像が AnnoStation にアップロードされているか、外部データソースに保存されているかを示します。 {% endhint %} ### 画像ファイルのURLを確認する 外部データソースに保存されている画像のURLを手動で確認し、必要に応じて値を変更することができます。 1. URLパスを確認したい画像に移動し、右側の `...` ボタンを選択して、`File settings`を選択します。 2. 外部データセットの編集ダイアログが開きます。ファイル名とURLを変更し、**保存**をクリックします。 ## **Cross-origin resource sharing** (**CORS**) オプションの設定 Cross-origin resource sharing (CORS) とは、amazon aws や Google Drive のようなリソース（この場合は画像）を提供するドメインに対して、そのドメイン以外の別のドメインに属する AnnoStationが リソースをリクエストできるようにするメカニズムです。 AnnoStationが画像を正常に表示するためには、Cross-origin requestを許可するように外部データソースを設定する必要があります。 Cross-origin requestが許可されていない場合、AnnoStationは画像を表示することができません。その場合は、すべての画像をAnnoStationサーバーから強制的にレンダリングすることができます。これを有効にするには、以下の手順に従ってください。 1. プロジェクトの `Setting` タブを開きます。 2. `Advanced settings`を開き、`Force all the images render from server to prevent CORS issue`を選択します。 3. **Update Project**をクリックします。 {% hint style="warning" %} CORSの問題で画像が表示できない場合、AnnoStationはエラーメッセージを表示します。エラーが表示された場合は、CORSオプションを有効にしてみてください。 {% endhint %} # データを整理する フォルダを作成しプロジェクト内に階層を作成することで、画像ファイルを整理できます。 ## フォルダの作成 1. **New**を選択し、`Create folder`を選択します。 2. 任意の名前を入力します。 {% hint style="info" %} 階層のレベルは無制限にサポートしているので、必要なだけフォルダを作成できます。 {% endhint %} ## フォルダ間で画像を移動する `Move to`メニューを使って、画像ファイルを別のフォルダに移動できます。 ## 画像やフォルダを削除する `Delete`メニューを使って画像ファイルやフォルダを削除することができます。いったん削除された画像ファイルは消去され、元に戻すことができないため注意してください。 {% hint style="warning" %} フォルダを削除すると、サブフォルダを含むフォルダに含まれるすべての画像が削除されます。 {% endhint %} # ラベルを定義する ## 概要 高品質のトレーニングデータを作成するには、クリーンでよく考えられたラベルが必要です。 AnnoStationは以下の2種類のラベルをサポートしています。 | タイプ | 説明 | | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | セグメンテーション | セグメンテーションは通常オブジェクトの形状を正確に検出できるモデルを訓練する場合に使用されます。画像の*各ピクセル*に対してそのピクセルがあらわすオブジェクトのクラスを定義します。 | | ベクター |

ベクターは、画像内の特定の物体を検出するためによく使われます。オブジェクトの形状の輪郭をそのオブジェクトがあらわすクラスを用いて定義します。

AnnoStation は以下のタイプのベクトルオブジェクトをサポートしています：

| ベクターラベルの場合は、[カスタム属性を定義](/jpn/mastering-annostation/projectsetup/labels#kasutamu)して分類を追加することもできます。 ## 新しいラベルを作成する 1. `Annotation Labels`タブに移動します。 2. **Add label**をクリックします。 3. 名前を入力し、色を選択します。 4. ラベルが **Segmentation**または **Vector**のどちらかを選択します。 * ベクターラベルの場合は、カスタム属性を定義できます。 5. **Create Label**を選択します。 ### カスタム属性 アノテーションされたオブジェクトを分類したい場合に強力な方法がカスタム属性です。 AnnoStationは以下のタイプのカスタム属性をサポートしています。 {% hint style="info" %} カスタム属性を使用しないと、認識させたいオブジェクトの種類ごとにラベルを定義する必要があります。 たとえば、「車」と「トラック」を分けてモデルに認識させたい場合、ラベルをそれぞれ作成します。一方、「車」を種類ごと、たとえば「軽」「セダン」「スポーツカー」に分類したい場合、それぞれにラベルを作成するとアノテーターは都度ラベルを選択する必要があります。 「車」に対して「種類」という属性を付与すると、画像の中から車をラベル付けするという行為と、その車の種類を分類するという行為を分けられるため、作業効率は格段に改善します。 {% endhint %} | タイプ | 説明 | | -------- | --------------------------------------------------------------------------------------------- | | テキスト | | | ラジオボタン | | | チェックボックス | | | ドロップダウン | | #### カスタム属性を追加するには 1. ベクターラベルに対して、**Add attribute**を選択します。 2. 属性の名前を入力し、タイプを選択します。 3. （テキスト以外のタイプの場合）値のオプションを追加します。 4. 「Other」をオプションとして含めるかどうかを定義します。 5. **Add attribute**ボタンをクリックすると、追加の属性を定義できます。 ## ラベルの変更 ラベルの定義を変更するとラベルに関連付けられている既存のアノテーションに影響を与えるため、十分注意して行ってください。 ラベルを変更するには、変更したいラベルの右側にある鉛筆アイコンを選択します。 {% hint style="info" %} ラベルを変更すると、以下の影響があります。 * 名前や色を変更すると、既存のアノテーションが更新されます。 * 属性やオプションを削除すると、既存の属性や値が削除されます。 * 属性のタイプを変更すると、既存の値を保存できない場合、既存の値が削除されることがあります。 {% endhint %} ## ラベルの削除 ラベルの定義を削除するとラベルに関連付けられている既存のアノテーションはすべて削除され、元に戻すことはできないため、十分注意して行ってください。 ラベルを削除するには、削除したいラベルの右側にあるゴミ箱アイコンを選択します。 # プロジェクトにメンバーを追加する プロジェクトを設定しアノテーションを開始する準備ができたら、プロジェクトにメンバーを追加します。 ## プロジェクトにメンバーを追加する 1. `Members`タブに移動します。 2. **Add member**をクリックします。 3. 追加したいメンバーのチェックボックスを選択します。 4. メンバーの[ロール](/jpn/mastering-annostation/projectsetup/project-members/project-member-roles)を定義します。 5. **追加**を選択します。 {% hint style="info" %} 追加できるメンバーは、自分のOrganizationに所属しているメンバーのみです。リストにメンバーが表示されていない場合は、まず[自分のOrganizationにメンバーを招待する](/jpn/mastering-annostation/organization)必要があります。 {% endhint %} ## プロジェクトからメンバーを削除する 削除したいメンバーの横にあるゴミ箱のアイコンをクリックすると、メンバーを削除することができます。 # プロジェクトメンバーのロール プロジェクトメンバーは、Manager（マネージャー）、 Developer（開発者）、 Annotator（アノテーター）のいずれかになります。 ## Manager マネージャーはプロジェクトのプロジェクトマネージャーとして行動し、プロジェクトの完全な管理権限を持っています。**以下のことができます：** * **プロジェクト管理** * プロジェクトの名前の変更・削除 * 設定の変更 * アノテータのアサイン・アサイン解除 * メンバーの追加・削除 * ラベルの追加・削除 * **データセットを扱う** * データセットの追加。削除 * フォルダの作成 * 画像ファイルのダウンロード * アノテーションデータのダウンロード * **アノテーション** * 画像のアノテーション * **コラボレーション** * 画像のレビュー * コメント ## Developer 開発者はプロジェクトへの積極的な貢献者ですが、管理者とは異なり、部分的な管理権限を持っています。**開発者は以下ができます：** * **プロジェクト管理** * メンバーの追加・削除 * ラベルの追加・削除 * **データセットを扱う** * データセットの追加・削除 * フォルダの作成 * 画像ファイルのダウンロード * アノテーションデータのダウンロード * **アノテーション** * 画像のアノテーション * **コラボレーション** * 画像のレビュー * コメント ## Annotator アノテーターはプロジェクトへの積極的な貢献者ですが、管理者権限はありません。**アノテーター**は以下ができます。 * **アノテーション** * 画像のアノテーション * **コラボレーション** * コメント ## まとめ | | Manager | Developer | Annotator | | ----------------- | :-----: | :-------: | :-------: | | **プロジェクト管理** | | | | | プロジェクトの名前の変更・削除 | ✅ | ❌ | ❌ | | 設定の変更 | ✅ | ❌ | ❌ | | アノテータのアサイン・アサイン解除 | ✅ | ❌ | ❌ | | メンバーの追加・削除 | ✅ | ✅ | ❌ | | ラベルの追加・削除 | ✅ | ✅ | ❌ | | **データセットを扱う** | | | | | データセットの追加・削除 | ✅ | ✅ | ❌ | | 画像ファイルのダウンロード | ✅ | ✅ | ❌ | | アノテーションデータのダウンロード | ✅ | ✅ | ❌ | | **アノテーション** | | | | | 画像のアノテーション | ✅ | ✅ | ✅ | | **コラボレーション** | | | | | 画像のレビュー | ✅ | ✅ | ❌ | | コメント | ✅ | ✅ | ✅ | # アノテータをアサインする まだアノテーションが開始されていない画像をランダムに選んでアノテーションすることもできますが、特定の画像をアノテータに割り当てるとトレーサビリティを向上できます。複数のアノテータに自動的に画像をアサインしたり、特定のメンバーに画像をアサインできます。 ## アノテーターをアサインする アノテーターに画像をアサインするには、`Assign annotator`を使います。画像がアノテーターに割り当てられると、アノテーターの名前が**Assignee**として表示されます。 アノテーターはこの情報を使って、自分にアサインされた画像を簡単にフィルタリングすることができます。 {% hint style="info" %} 画像にアノテーターを割り当てても、他のメンバーがその画像にアノテーションするのは妨げません。 {% endhint %} ## 複数のアノテーターを一度にアサインする 複数のメンバーに画像をアサインしたい場合は、一括アサイン機能を使用します。 1. プロジェクトのパンくずにあるドロップダウンを開きます。 2. `Assign annotator` を選択します。 * 現在のディレクトリ内の画像は選択するがサブフォルダ内の画像を除外したい場合は、`Without subfolders`を選択します。 * サブフォルダ内の画像を含めてカレントディレクトリ内のすべての画像を選択したい場合は、`With Subfolders`を選択します。 3. （オプション）アノテーターにアサインしたい画像の数を変更します。 4. アサインしたいメンバーを選択します。 {% hint style="info" %} ファイルの数は、現在どのアノテーターにも割り当てられていないファイルのみを表示します。 {% endhint %} ## アノテーターのアサインを解除する アノテーターのアサインと同じ方法で、`Unassign annotator`メニューを使用することによりアサインを解除することができます。 # プロジェクト ## 概要 AnnoStationは、シンプルで直感的なユーザーインターフェースを提供します。プロジェクトを開けば、すぐに作業を開始できます。 ここでは、AnnoStationでのデータセットの操作の概要を知るためのキーポイントをいくつか紹介します。 ### 検索 ファイル名を元に画像を検索することができます。 **検索機能の詳細については、こちらをご覧ください:** {% content-ref url="/pages/-MF-L2DbILR-dMn5sjj5" %} [画像を検索する](/jpn/mastering-annostation/project/search) {% endcontent-ref %} ### パンくず パンくずを使ってプロジェクト内を移動できます。 パンくずはプロジェクト内で現在いるディレクトリの場所を表示します。パンくず内の矢印アイコンを開くことにより、現在のディレクトリ内のすべての画像（サブフォルダ内の画像を含む）に対してバッチ処理を実行できます。 ### レポート レポートパネルにはアノテーション状況の概要が表示されます。 #### レポートについての詳細はこちらをご覧ください。 {% content-ref url="/pages/-MFk-qkIGAiQKavTmDj5" %} [レポートパネル](/jpn/mastering-annostation/project/report) {% endcontent-ref %} ### 並べ替えとフィルタ アノテーションのステータスなどに基づいて画像を並べ替えたり、フィルタリングしたりすることができます。 **並び替えとフィルタの詳細については、こちらをご覧ください。** {% content-ref url="/pages/-MF8e3Kw8GMI6LX0vlbx" %} [ソートとフィルタリング](/jpn/mastering-annostation/project/sort-and-filter) {% endcontent-ref %} ### 対象ファイルの選択 アノテーション結果をダウンロードする、または特定の画像ファイルを別のフォルダに移動するなど、対象ファイルに対して特定のアクションを実行したいケースがあります。対象ファイルには以下のようなケースがあります。 * 単一の画像ファイル * 複数の特定画像ファイル * 現在のディレクトリにあるすべての画像ファイル * 検索結果またはフィルタリングされた画像ファイル **ファイルの選択方法についての詳細はこちらを参照してください。** {% content-ref url="/pages/-MFoeSsrPKXF7QOa2kM8" %} [対象ファイルを選択する](/jpn/mastering-annostation/project/selecting-target-files-to-perform-actions) {% endcontent-ref %} # 対象ファイルを選択する アノテーション結果をダウンロードする、または特定の画像ファイルを別のフォルダに移動するなど、対象ファイルに対して特定のアクションを実行したいケースがあります。 AnnoStationでは、ターゲット画像を簡単に特定して選択することができます。対象画像を特定するには、以下の4つの方法があります。 * 単一の画像ファイル * 複数の特定画像ファイル * 現在のディレクトリにあるすべての画像ファイル * 検索結果またはフィルタリングされた画像ファイル ## 画像を選択してアクションを実行 1. アクションを実行したい画像を選択します。 2. 右側の `...` ボタンを選択し、ドロップダウンメニューからアクションを選択します。 ## 特定の画像を選択してアクションを実行 1. アクションを実行したい画像の横にあるチェックボックスを選択します。 2. **Actions**をクリックし、ドロップダウンメニューから必要なアクションを選択します。 ## 現在のディレクトリにあるすべての画像に対してアクションを実行 1. プロジェクトのパンくずにあるドロップダウンを開きます。 2. ドロップダウンメニューから必要なアクションを選択します。 * 現在のディレクトリ内の画像は選択するがサブフォルダ内の画像を除外したい場合は、`Without subfolders`を選択します。 * サブフォルダ内の画像を含めてカレントディレクトリ内のすべての画像を選択したい場合は、`With Subfolders`を選択します。 ## 検索結果やフィルタリングされた画像に基づいてアクションを実行 1. 画像を検索またはフィルタリングします。 2. 結果が表示された画面では、下記3つのオプションのいずれかを行うことができます： * 1つの画像を選択してアクションを実行する * 特定の画像を選択してアクションを実行する * パンくずのドロップダウンメニューを使用して、すべての結果に対してアクションを実行する # 画像を検索する ファイル名に基づいて画像を検索することができます。現在いるディレクトリに関係なく、プロジェクト内のすべての画像ファイルを検索します。 ## 検索結果を表示する パンくずはプロジェクト内で見つかった画像ファイルの数を表示します。 パンくず内のドロップダウンメニューを使用して、見つかった画像ファイルに対してバッチ処理を実行できます。 {% hint style="info" %} ファイル名にはフルパスが含まれます。見つかった結果がサブフォルダ内に存在する場合は、そのサブフォルダの名前が含まれます。 {% endhint %} # ソートとフィルタリング 列のヘッダーにあるドロップダウンメニューを使用して画像ファイルのソートやフィルタリングが行えます。 | 列 | サポートされている操作 | | -------- | ---------------------------------------------- | | Name | | | Status | | | Assignee | | # レポートパネル レポートパネルには、プロジェクトの進捗状況を把握するのに役立つ重要なメトリクスが表示されます。 | Field | Description | Status of image | | --------------- | --------------------------- | ------------------------------------------- | | **Total** | 画像の総数 | All | | **To do** | アノテーションが開始していない画像の数 | New | | **In Progress** | アノテーションが開始しているが、完了していない画像の数 |

In Progress

Waiting for change

| | **Submitted** | アノテーターが完了したと登録した画像の数 | Waiting for review | | **Approved** | レビューに合格した画像の数 | Done | {% hint style="info" %} 画像の数は現在のディレクトリを基準にして計算されます。サブフォルダを含め、現在のディレクトリに存在するすべての画像を対象にカウントします。そのため、下の階層にいくと新しいディレクトリに基づいて数が再計算されます。 {% endhint %} これらのメトリクスは、プロジェクトのワークフローと密接に関係しています。 **ワークフローについて詳しく知りたい場合は、こちらをご覧ください。** {% content-ref url="/pages/-MF3VMiAoV5z5u-LHqTP" %} [ワークフローとステータス管理](/jpn/mastering-annostation/workflow-and-status-management) {% endcontent-ref %} # ワークフローとステータス管理 AnnoStationは、プロジェクトの進捗を簡単に追跡できるように、ビルドインのワークフローを提供します。 イメージのステータスは重要なチェックポイントを通過すると更新されます。 ## ステータス 以下の表は、ステータスの一覧と、そのステータスで誰が画像に対して変更を加えることができるかをまとめたものです。アノテーターはAnnotatorの[ロール](/jpn/mastering-annostation/projectsetup/project-members/project-member-roles)を持つメンバーであり、レビュアーはDeveloperまたはManagerの[ロール](/jpn/mastering-annostation/projectsetup/project-members/project-member-roles)を持つメンバーです。 | ステータス | 説明 | アノテーター | レビュアー | | ------------------ | -------------------------- | :------------------: | :------------------: | | New | 画像に対してまだ何のアクションもとられていない状態。 | :white\_check\_mark: | :white\_check\_mark: | | In Progress | 画像に対してアノテーションが保存されている状態。 | :white\_check\_mark: | :white\_check\_mark: | | Waiting for review | 画像がレビュー待ちとして登録されている状態。 | :x: | :white\_check\_mark: | | Waiting for change | レビューの結果、変更依頼が出されている状態。 | :white\_check\_mark: | :white\_check\_mark: | | Done | レビューの結果、合格した状態。 | :x: | :white\_check\_mark: | ## ワークフロー ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MFt1wP1Z1cQZQyKEtMt%2F-MFtFA6E29r91U65XZmN%2FWorkflow_NoSkip.jpg?alt=media\&token=f603c2a1-c6d0-47eb-a1d8-fa25c3a5dfd5) # 画像をアノテーションする AnnoStationは、アノテーターの生産性を最大限に高めるために設計されています。 ## ステップ ここでは、AnnoStationで画像にアノテーションをする一般的なステップを紹介します。 1. 画像を開きます。 2. [ラベルを選択します](/jpn/mastering-annostation/annotating#raberuwosuru)。 3. [適切なツールを選択します](/jpn/mastering-annostation/annotating#tsruwoshimasu)。 4. [ズームレベルを変更](/jpn/mastering-annostation/annotating#adjust-an-image-to-annotate)し、オブジェクトをアノテーションします。 5. （オプション）[カスタム属性の値を入力](/jpn/mastering-annostation/annotating#wosuru-1)します。 6. [画像を登録します](/jpn/mastering-annostation/annotating#submit-an-image)。 7. 次の画像に移動します。 これらの操作は、キーボードのショートカットキーで切り替えることができます。 **サポートされているすべてのキーボードショートカットキーについてはこちらをご覧ください。** {% content-ref url="/pages/-MF-06SWo1Qe4S745Eb2" %} [キーボードショートカット](/jpn/resources/shortcut) {% endcontent-ref %} ### ラベルを選択する [プロジェクトに定義されているラベルのリスト](https://github.com/Incubit/annostation_document/tree/a629375efa4369aad5e331254a4168ade8363132/mastering-annostation/annotating/projectsetup/labels.md)から、アノテーションしたいオブジェクトのラベルを選択します。 ### ツールを選択する 直線、多角形、矩形（バウンディングボックス）など様々なツールを使ってアノテーションできます。選択されているラベルがセグメンテーションかベクターかによって、使用できるツールが異なります。 **サポートされているツールの詳細については、こちらを参照してください。** {% content-ref url="/pages/-MF-KokNzgugNWsrUAFJ" %} [アノテーションツール](/jpn/mastering-annostation/annotating/annotation-tools) {% endcontent-ref %} ### 画像の表示を**変更する** 画像のズームレベルを調整し、正確なアノテーションを行うことができます。 * 拡大・縮小 * パン * ウィンドウに合わせる {% hint style="info" %} `Ctrl または ⌘ + マウスホイール` を使って拡大・縮小することもできます。 {% endhint %} ### 属性値を入力する カスタム属性がベクターラベルに関連付けられている場合は、形状の描画が完了すると、値を入力するよう求められます。 ### 画像を登録する すべてのオブジェクトのアノテーションが終わったら、画像をSubmit（登録）します。一度登録された画像は *Developer* または *Managerの*ロールがないと変更できなくなるため、登録する前にすべてのオブジェクトがアノテーションされているか確認してください。 {% hint style="info" %} 画像を登録する前に**Save（保存）**することもできます。 {% endhint %} **ワークフロー機能の詳細については、こちらを参照してください。** {% content-ref url="/pages/-MF3VMiAoV5z5u-LHqTP" %} [ワークフローとステータス管理](/jpn/mastering-annostation/workflow-and-status-management) {% endcontent-ref %} ### コメント 不明点があった際にはコメントを残すことができます。早い段階でエッジケースをつぶすことにより、後からのやり直しを避けることができます。 **コメント機能の詳細についてはこちらをご覧ください。** {% content-ref url="/pages/-MFkIT9-ioY1524rWMlH" %} [コメント機能](/jpn/mastering-annostation/collaboration/comments) {% endcontent-ref %} # アノテーションツール 選択したラベルの種類によって利用できるツールが異なります。 | ツール | 説明 | セグメンテーション | ベクター | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | :------------------: | :------------------: | | Polygon | 多角形を作成する | :white\_check\_mark: | :white\_check\_mark: | | Bounding Box | 四角形を作成する | :white\_check\_mark: | :white\_check\_mark: | | Point | ポイント（点）を作成する | :no\_entry\_sign: | :white\_check\_mark: | | Path | 直線を作成する | :white\_check\_mark: | :white\_check\_mark: | | Selector | ベクター形状を選択する | :no\_entry\_sign: | :white\_check\_mark: | | Pencil | 鉛筆で塗りつぶす | :white\_check\_mark: | :no\_entry\_sign: | | Polygon Eraser | 多角形で不必要なピクセルを削除する | :white\_check\_mark: | :no\_entry\_sign: | | Pencil Eraser | 鉛筆で不必要なピクセルを削除する | :white\_check\_mark: | :no\_entry\_sign: | ## セグメンテーション ビットマップを作成します。様々な図形を使ってピクセルの追加や削除ができます。 {% hint style="info" %} セグメンテーションにおいて、図形は対象のピクセルを簡単に塗りつぶすために使われます。塗りつぶした結果はビットマップになるため、使用した図形のポイント自体は保持されません。 ビットマップの形状を変更したい場合は、新しい図形を描画することによりピクセルを追加するか、消しゴムツールを使って不要なピクセルを削除する必要があります。 {% endhint %} ## ベクター ベクターは、1点または複数点で構成されます。 ### ベクター形状を編集する 選択ツールを使って図形を選択することができます。形状全体を移動または削除したり、個々の点を編集して形状を変更できます。 ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MG6ZyA0tCyAYDEqOgJt%2F-MG6dvCFHZKuEYNU3PQ7%2FAnimated%20GIF-downsized_large.gif?alt=media\&token=b31e05e6-0ab3-4e89-b3b2-8ed174673d2b) {% hint style="info" %} ポイントをダブルクリックすると削除することができます。 {% endhint %} # アノテーションをレビューする 画像のアノテーションが終了して[Submit（登録）](/jpn/mastering-annostation/annotating#submit-an-image)されると、レビューワーはアノテーションを確認し、品質を担保することができます。 1. アノテーションの変更が必要ない場合は、**Pass（合格）**をクリックします。 2. 変更が必要な場合は、**Ask for change（変更を依頼する）**を選択します。 3. さらに明確な説明が必要な場合は、オプションで[コメントを残す](/jpn/mastering-annostation/collaboration/comments)ことが可能です。 レビューの結果に応じて、画像の状態が変化します。 **ワークフローとステータス管理についてはこちらをご覧ください。** {% content-ref url="/pages/-MF3VMiAoV5z5u-LHqTP" %} [ワークフローとステータス管理](/jpn/mastering-annostation/workflow-and-status-management) {% endcontent-ref %} # コラボレーション ## **コメント機能** コメントは、プロジェクトの初期段階で曖昧さを取り除くのに最適な方法です。注釈者はエッジケースについて質問をしたり、レビュアーはどのような変更が必要なのかを明確にすることができます。 **コメント機能の詳細については、こちらをご覧ください。** {% content-ref url="/pages/-MFkIT9-ioY1524rWMlH" %} [コメント機能](/jpn/mastering-annostation/collaboration/comments) {% endcontent-ref %} ## **外部パートナーとの連携** プロジェクトによっては、外部のパートナーと協力する必要があります。別のOrganizationとプロジェクトを共有すると、外部パートナーのメンバーがプロジェクトにアクセスできるようになります。 **外部パートナーとの連携についての詳細はこちらをご覧ください。** {% content-ref url="/pages/-MFkIYQ-fqBw\_Bw14cSe" %} [別のOrganizationとプロジェクトを共有する](/jpn/mastering-annostation/collaboration/collaborating-with-external-organization) {% endcontent-ref %} # コメント機能 コメントは、プロジェクトの初期段階で曖昧さを取り除くのに最適な方法です。注釈者はエッジケースについて質問をしたり、レビュアーはどのような変更が必要なのかを明確にすることができます。 ## 画像内でのコメント ### コメントモードに入る 既存のコメントを画像に表示したり、コメントモードで新しいコメントを残したりできます。 コメントモードに入るには、ツールバーの**コメント**アイコンをクリックします。 ### コメントを残す 1. コメントモードで、画像のどこかコメントを残したい場所をクリックしてください。 2. テキストを入力し、**Send**を選択します。 #### コメントのステータス コメントは**Unresolved（未解決）**または**Resolved（解決済み）**のいずれかになります。 * 新しいコメントは、**Unresolved（未解決）**コメントとして追加されます。 * プロジェクトビューでは、各画像の**Unresolved（未解決）**コメントの総数が表示されます。 コメントに対して**Resolved**を選択すると、コメントは**Resolved（解決済み）**になります。 ### コメントモードを終了する コメントモードを**終了**するには、以下の方法があります。 * **コメント**アイコンを再度クリックします。 * [アノテーションツール](https://github.com/Incubit/annostation_document/tree/93ced605062f25eccdad0281723dae064cb5804a/mastering-annostation/collaboration/annotating/annotation-tools.md)のいずれかを選択します。 * 別の画像に移動してください。 ## コメントへの返信 コメントに返信して議論を続けることができます。 {% hint style="info" %} 元々の問題が解決したら、例えばアノテータがコメントで指摘された問題を修正したら、コメントを常に解決するようにします。 そうすることによって常にUnresolved（未解決）コメントだけを追跡することができます。 {% endhint %} # 別のOrganizationとプロジェクトを共有する プロジェクトによっては、アノテーション会社やクライアントなどの外部パートナーと協力する必要があります。別のOrganizationをプロジェクトに招待して、そのOrganizationのメンバーとプロジェクトを共有できます。 {% hint style="info" %} 外部のパートナーをあなたのOrganizationに直接招待することもできます。これは、招待する必要があるメンバーを正確に知っていれば簡単です。そうでない場合、パートナーのOrganizationとプロジェクトを共有することにより、パートナーのメンバーをあなた自身が管理する必要がなくなります。 {% endhint %} ## 別のOrganizationをプロジェクトに招待する 1. 別のOrganizationを招待したいプロジェクトを開きます。 2. `Setting`タブを選択し、`Advanced settings`を展開する。 3. `Allow other organization to access via link`をオンにします。 このプロジェクトへのアクセスを許可するリンクが生成されます。このリンクはいつでも取り消すことができます。 4. リンクをコピーして、別のOrganizationのメンバーと共有します。 ### コラボレーション開始 コラボレーションを開始するには、別のOrganizationのメンバーが共有したリンクをクリックしてコラボレーションを有効にする必要があります。 1. メンバーは AnnoStation にログインするよう求められます。 2. メンバーが複数のOrganizationに属している場合は、プロジェクトを共有するOrganizationを選択します。 3. 招待を確認します。 確認されると、共有されたプロジェクトが両方のOrganizationに表示されます。共有されているプロジェクトは、プロジェクト一覧にそのように明記されます。 {% hint style="warning" %} プロジェクトはAnnoStation内ですでにOrganizationに属している[アクティブメンバー](https://github.com/Incubit/annostation_document/tree/36cab20e975ec39bc7dd1144feaf9f8f28bdb882/mastering-annostation/collaboration/collaborating-with-external-organization/.../.../organization/member-types.md)とのみ共有できます。 {% endhint %} ### 共有プロジェクトの管理 共有されているプロジェクトは通常のプロジェクトとはその管理において若干異なります。 最初に招待を受け入れたメンバーは共有プロジェクトの外部Organizationのマネージャーになります。 マネージャーは共有プロジェクトに対して自身が属しているOrganizationからメンバーを追加することはできますが、標準プロジェクトとは異なり、プロジェクト自体の管理者権限は持ちません。 **共有プロジェクトにおけるプロジェクトメンバーの役割の詳細については、こちらを参照してください。** {% content-ref url="/pages/-MFnoukYLs8AU3Dxp-Rb" %} [共有プロジェクトにおけるメンバーロール](/jpn/mastering-annostation/collaboration/collaborating-with-external-organization/project-member-roles-in-shared-projects) {% endcontent-ref %} ## 共有プロジェクトでのワークフロー 2つの組織が共有プロジェクトに貢献しているので、レビュープロセスは、両方の組織で独立して行うことができ**ます**。 最初のレビューサイクルはプロジェクトの共有先である外部Organization内で行われます。画像が承認された場合のみ、Projectの共有元のOrganization内でのレビューに進みます。 **共有プロジェクトでのワークフローの詳細については、こちらを参照してください。** {% content-ref url="/pages/-MFoZ7CROmvdcMEUwACr" %} [共有プロジェクトにおけるワークフロー](/jpn/mastering-annostation/collaboration/collaborating-with-external-organization/workflow-in-a-shared-project) {% endcontent-ref %} ## コラボレーションを**中止する** コラボレーションは共有先または共有元のOrganizationどちら側からもいつでも止められます。 1. コラボレーションを中止したいプロジェクトに移動します。 2. `Setting`タブに移動します。 3. `Stop collaborating with `を選択します。 共有プロジェクトが共有先のOrganizationでは表示されなくなり、そのOrganizationのメンバーはアクセスできなくなります。 # 共有プロジェクトにおけるメンバーロール 外部Organizationのプロジェクトメンバーは、共有プロジェクトではManager（マネージャー）、またはAnnotator（アノテーター）のいずれかになることができます。 ## 共有プロジェクトのManager 外部Organizationのマネージャーは、プロジェクトへの積極的な貢献者ですが、自分の組織からメンバーを追加/削除する以外の管理者権限は持っていません。**マネージャーは以下ができます。** * **プロジェクト管理** * 自分の組織からメンバーを追加・削除する * **アノテーション** * 画像をアノテーションする * **コラボレーション** * コメントを残す ## 共有プロジェクトのアノテータ 注釈者はプロジェクトへの積極的な貢献者ですが、管理者権限はありません。アノテータは、このプロジェクトに貢献していますが、管理者権限はありません。 * **アノテーション** * 画像をアノテーションする * **コラボレーション** * コメントを残す ## まとめ | | Host | | | External | | | ----------------- | :-----: | :-------: | :-------: | :------: | :-------: | | | Manager | Developer | Annotator | Manager | Annotator | | **プロジェクト管理** | | | | | | | プロジェクトの名前の変更・削除 | ✅ | ❌ | ❌ | ❌ | ❌ | | 設定の変更 | ✅ | ❌ | ❌ | ❌ | ❌ | | アノテータのアサイン・アサイン解除 | ✅ | ❌ | ❌ | ❌ | ❌ | | メンバーの追加・削除 | ✅ | ✅ | ❌ | ✅ | ❌ | | ラベルの追加・削除 | ✅ | ✅ | ❌ | ❌ | ❌ | | **データセットを扱う** | | | | | | | データセットの追加・削除 | ✅ | ✅ | ❌ | ❌ | ❌ | | 画像ファイルのダウンロード | ✅ | ✅ | ❌ | ❌ | ❌ | | アノテーションデータのダウンロード | ✅ | ✅ | ❌ | ❌ | ❌ | | **アノテーション** | | | | | | | 画像のアノテーション | ✅ | ✅ | ✅ | ✅ | ✅ | | **コラボレーション** | | | | | | | 画像のレビュー | ✅ | ✅ | ❌ | ✅ | ❌ | | コメント | ✅ | ✅ | ✅ | ✅ | ✅ | # 共有プロジェクトにおけるワークフロー 以下の表は、ステータスの一覧と、そのステータスで誰が画像に対して変更を加えることができるかをまとめたものです。アノテーターはAnnotatorのロールを持つメンバーであり、レビュアーはDeveloperまたはManagerのロールを持つメンバーです。 | Status | Description |

Annotator

(External)

|

Reviewer

(External)

|

Annotator

(Host)

|

Reviewer

(Host)

| | --------------------------------- | -------------------------------------- | :-------------------------------: | :------------------------------: | :---------------------------: | :--------------------------: | | New | 画像に対してまだ何のアクションもとられていない状態。 | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | | In Progress | 画像に対してアノテーションが保存されている状態。 | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | | Waiting for collaborator's review |

画像がレビュー待ちとして登録されている状態。

| :x: | :white\_check\_mark: | :x: | :white\_check\_mark: | | Waiting for owner's review | 外部Organizationのレビューワーがレビューした結果、合格した状態。 | :x: | :white\_check\_mark: | :x: | :white\_check\_mark: | | Waiting for change | レビューの結果、変更依頼が出されている状態。 | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | :white\_check\_mark: | | Done | 共有元のホストOrganizationのレビューの結果、合格した状態。 | :x: | :x: | :x: | :white\_check\_mark: | ## 共有プロジェクトにおけるワークフロー ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MFt1wP1Z1cQZQyKEtMt%2F-MFtFLtg15Yg6jUMCkxU%2FWorkflow_Collabo_NoSkip.jpg?alt=media\&token=b41215f3-d436-40e8-a138-e8176a0692cd) # データセットのエクスポート アノテーション結果や画像ファイルはいつでもエキスポートできます。 ## アノテーション結果のエクスポート アノテーション結果は `Download annotation data`メニューからいつでもエクスポートできます。 アノテーション結果はJSON形式でエクスポートされます。 **JSON形式の詳細については、こちらを参照してください。** {% content-ref url="/pages/-MF--o3BVqrC3IGsmGYk" %} [JSONフォーマット](/jpn/resources/json) {% endcontent-ref %} ## 画像ファイルをエクスポートする 画像ファイルは `Download files` メニューからいつでもエキスポートできます。 # JSONフォーマット ## データ形式 ``` { "filename": STRING, "id": STRING, "status": STRING, "width": INTEGER, "height": INTEGER, "labels": [ { "name": STRING, "type": STRING, "color": STRING, "annotations": [RLE] or [vectors] }, ... ] } ``` * **filename**: 画像のファイル名。pathnameが含まれます。 * **id**: AnnoStation内のアノテーションデータのID。 * **status**: 画像のステータス。とりうる値： `new`, `in_progress`, `waiting_for_review`, `waiting_for_collaborator_review`, `waiting_for_owner_review`, `waiting_for_change`, `done` ,`skipped` * 以下の値は次の条件によって使い分けてください： `waiting_for_review`, `waiting_for_collaborator_review` , `waiting_for_owner_review`: * プロジェクトを別のOrganizationと共有していない場合は、以下を使用してください： `waiting_for_review` * プロジェクトを別のOrganizationと共有していて、共有先のOrganizationにレビューして欲しい場合は、以下を使用してください： `waiting_for_collaborator_review` * プロジェクトを別のOrganizationと共有していて、共有元のOrganizationにレビューして欲しい場合は、以下を使用してください： `waiting_for_owner_review` * **width**: 画像の幅。 * **height**: 画像の高さ。 * **labels**: オブジェクトの配列。各オブジェクトはAnnoStationのラベルをあらわします。 * **name**: ラベルの名前。 * **type**: ラベルのタイプ。とりうる値： `segmentation` または `vector` * **color**: ラベルの色。 * [**annotations**](/jpn/resources/json/json-annotation): `type`によって、`segmentation` の場合は RLE (run-length encoding)オブジェクト、`vector`の場合はベクターオブジェクトの配列。 # アノテーション ## Annotation 画像はピクセルの配列から構成されています。ピクセルに対してアノテーションする方法として、 `segmentation` ツール（RLE - run-length encodingとして出力） または `vector` ツール（形状を構成する点を出力）の二つの方法をサポートしています。 ### セグメンテーション (RLE) RLE (run-length encoding) オブジェクトは、ラベルタイプが `segmentation`の場合 に使用され、各ラベルは一つのRLEオブジェクトを持てます。セグメンテーションを用いてアノテーションをすると、画像内のピクセルをアノテーションすることになります。
RLEオブジェクトは以下のように記述します： ``` { "type": STRING, "segmentation": [ [x, y, length from x to right], ... ] } ``` * **type**: セグメンテーションの種類。`rle` のみサポートされています。 * **segmentation**: RLEの2次元配列。 * segmentationの最小単位は整数の1x1のピクセルエリアになります。 * 例えば、4x4ピクセルの画像に対するアノテーションがあった場合、配列は以下のような値をとりえます： ``` { "segmentation": [ [2, 0, 2], [0, 1, 3], [2, 2, 1] ] } ``` ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MFspbkJkiU8E7msmH8W%2F-MFss-VXeB89_z9uMQZ8%2F90091317-9da63f00-dd58-11ea-94e1-a026179baa8a.png?alt=media\&token=d1a6b7f4-6cf4-44fb-a037-cc345566634a) ### ベクター ベクターオブジェクトは、ラベルタイプが`vector` の場合のみ使用され、各ラベルは複数のベクターオブジェクトを持てます。ベクターを用いてアノテーションすると、画像内のアノテーションの形状の座標を記述することになります： ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MFspbkJkiU8E7msmH8W%2F-MFssAMnbdv3fbUGJ8aU%2F90106189-a52a1000-dd79-11ea-8c26-ec9afb42ded3.png?alt=media\&token=d75c0313-1079-4a2c-93b6-2c4ce8434ff2) ベクターオブジェクトは以下のように記述します： ``` { "type": STRING, "attributes": [ { "name": STRING, "values": [STRING] } ], "segmentation": [x1, y1, x2, y2, ..., xn, yn] } ``` * **type**: ベクターオブジェクトの種類。以下の種類をサポートしています： `polygon`, `boundingBox`, `path` , `point`。 * **attributes**: ベクターオブジェクトに付与されたカスタム属性。 * **name**: 属性の名前。 * **values**: 属性の値の配列。 * **segmentation**: ベクターオブジェクトを記述する座標の配列。 * segmentationの最小単位は float (浮動小数点型)の座標になります。 * segmentationの種類が `polygon`の場合、以下のような値をとります `[x1, y1, x2, y2, ..., xn, yn]`。 * segmentationの種類が`boundingBox`の場合、以下のような値をとります `[x1, y1, x2, y2, x3, y3, x4, y4]`。 * segmentationの種類が`path`の場合、以下のような値をとります `[x1, y1, x2, y2, ..., xn, yn]`。 * segmentationの種類が`point`の場合、以下のような値をとります`[x1, y1]`。 * 座標は時計回りでも反時計回り一貫した順序に沿っていればどちらでも構いません。 * 例えば、4x4ピクセルの画像に対するアノテーションがあった場合、配列は以下のように記述できます： ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MGDAW0CeC7zU0j86EBB%2F-MGDBUPUkflLwNWZ1I8s%2F90107448-68f7af00-dd7b-11ea-87c6-e0875d7ff79a%20\(1\).png?alt=media\&token=bb300e2a-7e86-41cb-b9b4-2ba3fe1ab2c8) ![](https://2146518255-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MEzwb1apIVYCtVsgB9Y%2F-MGDAW0CeC7zU0j86EBB%2F-MGDBbMWY4SxSnuhK_YC%2F90107831-0226c580-dd7c-11ea-9f6f-d714bc0fc883%20\(1\).png?alt=media\&token=c06f178a-acd5-4d3c-87f7-40e8ca4deaa6) # 例 ## 1つのセグメンテーションラベルがある例 ``` { "filename": "PoC/001.jpg", "id": "8051d7cf-ef7f-481e-8ef6-17d77c97fbe4", "status": "waiting_for_review", "width": 1920, "height": 1080, "labels": [ { "name": "Dog", "type": "segmentation", "color": "#ff0000", "annotations": [ { "type": "rle", "segmentation": [ [827, 1209, 5], [826, 1210, 7], [825, 1211, 9] ] } ] } ] } ``` ## 2つのセグメンテーションラベルがある例 ``` { "filename": "DCIM001.jpg", "id": "8051d7cf-ef7f-481e-8ef6-17d77c97fbe4", "status": "in_progress", "width": 1920, "height": 1080, "labels": [ { "name": "Dog", "type": "segmentation", "color": "#ff0000", "annotations": [ { "type": "rle", "segmentation": [ [827, 1209, 5], [826, 1210, 7], [825, 1211, 9] ] } ] }, { "name": "Cat", "type": "segmentation", "color": "#91FF00", "annotations": [ { "type": "rle", "segmentation": [ [846, 1273, 11], [846, 1274, 11], [847, 1275, 10] ] } ] } ] } ``` ## 1つのベクターラベルに対して2つ形状がある例 ``` { "filename": "/POC/RAW/DCIM001.jpg", "id": "8051d7cf-ef7f-481e-8ef6-17d77c97fbe4", "status": "in_progress", "width": 1920, "height": 1080, "labels": [ { "name": "Car", "type": "vector", "color": "#ff0000", "annotations": [ { "type": "boundingBox", "segmentation": [ 2039, 535, 2649, 535, 2649, 917, 2039, 917 ] "attributes": [ { "name": "status" "values": ["scratch", "dent", ...] } ] }, { "type": "polygon", "segmentation": [85, 48, 74, 85, 15, 59, 73, 17], "attributes": [ { "name": "size" "values": ["medium"] }, { "name": "type" "values": ["SUV"] } ] } ] } ] } ``` ## 1つのセグメンテーションラベルと1つのベクターラベルがある例 ``` { "filename": "DCIM001.jpg", "id": "8051d7cf-ef7f-481e-8ef6-17d77c97fbe4", "status": "skipped", "width": 1920, "height": 1080, "labels": [ { "name": "Dog", "type": "segmentation", "color": "#ff0000", "annotations": [ { "type": "rle", "segmentation": [ [827, 1209, 5], [826, 1210, 7], [825, 1211, 9] ] } ] }, { "name": "Car", "type": "vector", "color": "#ff0000", "annotations": [ { "type": "boundingBox", "segmentation": [ 2039, 535, 2649, 535, 2649, 917, 2039, 917 ] "attributes": [ { "name": "status" "values": ["scratch", "dent", ...] } ] }, { "type": "polygon", "segmentation": [85, 48, 74, 85, 15, 59, 73, 17], "attributes": [ { "name": "size" "values": ["medium"] }, { "name": "type" "values": ["SUV"] } ] } ] } ] } ``` # キーボードショートカット キーボードショートカットを使うと、アノテーションやナビゲーションを素早く行えます。 ## ナビゲーション | Windows | Mac | Description | | ------- | --- | ----------- | | `J` | `J` | 前の画像に移動する | | `K` | `K` | 次の画像に移動する | | `H` | `H` | 画像の一覧に移動する | ## 一般 | Windows | Mac | Description | | -------------- | ---- | ------------------ | | `Ctrl` `S` | `⌘S` | アノテーションを保存 | | `Ctrl` `Enter` | `⌘↩` | アノテーションを登録 | | `Shift` `K` | `⌘K` | 承認 | | `Ctrl` `D` | `⌘D` | 変更を依頼 | | `C` | `C` | コメントツールを選択 | | `?` | `?` | キーボードショートカットの一覧を表示 | ## 表示の制御 | Windows | Mac | Description | | ---------- | ---- | ------------- | | `Ctrl` `+` | `⌘+` | 拡大 | | `Ctrl` `-` | `⌘-` | 縮小 | | `Ctrl` `0` | `⌘0` | 画像をキャンバス全体に表示 | | `N` | `N` | パンツールを選択 | ## アノテーション ### ラベルリスト | Windows | Mac | Description | | ----------------- | ----------------- | -------------------------------------------- | | `1, 2, 3, ..., n` | `1, 2, 3, ..., n` |

ラベル選択

注：リストの上部から番号は自動で割り当てられます

| | `T` | `T` | ラベルの表示/非表示 | ### アクション | Windows | Mac | Description | | ------------------ | ----- | ----------- | | `Ctrl` `Z` | `⌘Z` | 取り消し | | `Ctrl` `Shift` `Z` | `⌘⇧Z` | やり直し | ### アノテーションツール 以下のショートカットを使うには、ラベルを選択している必要があります。 #### 共通 | Windows | Mac | Description | | ------- | --- | --------------- | | `P` | `P` | ポリゴン（多角形） | | `B` | `B` | バウンディングボックス（矩形） | | `A` | `A` | パス（線） | #### セグメンテーション | Windows | Mac | Description | | ----------- | ---- | ------------- | | `L` | `L` | 鉛筆 | | `Shift` `P` | `⇧P` | ポリゴン（多角形）消しゴム | | `Shift` `L` | `⇧L` | 鉛筆消しゴム | #### ベクター | Windows | Mac | Description | | ------- | --- | ----------- | | `O` | `O` | 点 | | `S` | `S` | セレクター | # よくある質問 ## データはどこに、どのように保存されていますか？ 全てのユーザーデータとコンテンツは日本国内の[amazon aws](https://aws.amazon.com/)に保存されています。 一部のコンテンツ（例：HTMLページ）は、エンドユーザーのパフォーマンスを向上させるために、他の国にあるCDNによってキャッシュされる場合があります。 ## 誰がデータの権利を持っているのですか？ ユーザのデータはユーザのものです。 私たちはユーザのプライバシーを尊重します。アカウントを作成する際、ユーザのデータへの権利は、アプリケーションが機能するために必要最小限なものを除いて、私たちに与えられていません。私たちはユーザのデータを商業的または非商業的な目的のために使用せず、弊社グループ会社以外とは共有しません。詳しくは[利用規約](https://www.orni.co.jp/annostation/terms)を参照ください. ## パスワードをリセットするにはどうすればいいですか？ 以下の[リンク](https://annostation.com/users/password/new)からパスワードをリセットすることができます。 ログイン時に使用したメールアドレスと同じものを使用してください。 ## AnnoStationではどのブラウザをサポートしていますか？ AnnoStationは現在のバージョンの[Chrome](https://www.google.com/chrome/), [Firefox](http://www.mozilla.org/firefox/), [Safari](http://www.apple.com/safari/)をサポートしています。