PROJECT MANAGEMENT
Annotation Instruction
15 min
an annotation instruction is a specification of what you want to be annotated, but also an explanation or guidance of how you want it to be annotated for example, you may specify that you would like to annotate cars and pedestrians, which we call classes in addition, you may also want to clarify class related annotation rules in a separate guideline document, for example, that the 3d box annotations around each car should not include the side mirrors where can i find it? defining your annotation instruction is done in the project where you want the annotations delivered the tool is available under the tab annotation instruction revisions you can have multiple revisions of your annotation instruction this becomes important when a version of your instruction has been used in production once used in production, it has to be left in that state to keep a version controlled history that allows us to go back and see which version was used when producing a specific annotation as you learn more about your dataset, you probably want to update your instruction, which is handled by creating new revisions revision states a newly created revision will always be in draft mode the following flowchart describes the different states a revision must go through to be available to use in production draft draft a draft where everything is editable published published a published revision is considered completed and locked for further changes however, to use it in production some configuration still needs to be added by kognic experts ready for production ready for production a revision that is ready for production has been extended with the required configuration and is ready to be used in production the revision is locked for further changes revision visibility all revisions that are either published or ready for production are visible to every project manager with access to the specific project revisions in draft mode can either be private or public private drafts only visible to the creator when listing revisions if the creator shares a link to their private draft, the revision is still viewable (and editable) by another manager with project access public drafts visible (and editable) by any manager with project access this is mainly used to ease collaboration when working on a revision together revision content each revision contains classes, class properties, scene properties, and a guideline a description of each part can be found below classes a class is a description of what type of objects you want to have annotated, e g , cars or traffic signs geometry type the geometry type of the class determines which tool you want it to be annotated with, e g , a 3d cube or a semantic segmentation polygon each annotated instance/object of a class will get a unique id in the exported content you can connect class properties to your class in order to annotate object attributes, e g if a car is parked or not we currently support the following geometry types 225 false true false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type add condition to a property in a class card any property added to a classification can be used under a condition of another property this is also available in scene properties nesting is only supported for properties of the type true / false and multiple choice where the number of selectable options is single class collections with this feature, users can group classes into a class collection and add properties to it class collections are created in the classifications tab simply select the classes you want in your collection with the left hand checkboxes and then click the create new class button at the bottom of the screen two classes selected class properties if you want to annotate specific attributes on a class object you can add class properties these can be reused for multiple classes in the revision we support a variety of class property types ranging from true or false (boolean) questions, to drawing sub objects within your annotated object which properties you can connect to your class depends on its geometry type some property types, like horizontal reference line , are only available for 2d bounding box geometries we currently support the following property types 215 false true false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type scene properties scene properties are questions/attributes on the uploaded scene instead of the class, for example, what the weather is they are very similar to class properties, except that you can't use property types only applicable for classes, e g , connect object aren't available configuration configuration contains various advanced global task settings most of these settings can be edited in the ui, but it is also to edit settings throught the json editor since some advanced and experimental features are not yet available in the ui true false 199false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type guideline upload the guideline associated with the annotation instruction here tips & tricks below are some tips and tricks to help you succeed when creating your annotation instruction help annotators by keeping your elements in an intuitive order all items that can be moved and rearranged , e g classes a class's properties a multiple choice property's options scene properties will also appear in the same order for the annotators in the task view placing these entities in an intuitive order will help the annotator while annotating! preview your annotation instruction in a task context while adding classes, class properties, etc , you can easily verify that the annotation instruction looks and behaves as intended by using the preview tool the preview tool will open the instruction together with some dummy data in the task view this is done by simply pressing the preview button you can also share the preview link by copying the url if you want someone else to have a look at your work