Annotation Instructions

annotation instructions can be created, viewed & managed by anyone with access to the project the has the workspace role project manager , developer or admin 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 the classes cars and pedestrians in addition, you may also want to clarify class related annotation rules in a separate guideline document, for example, that the 3d bounding 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 geometry type description 2d bounding box mark an object in an image using a box 3d bounding box mark an object in a point cloud using a cuboid 2d & 3d bounding box mark an object in both an image and a point cloud using a box and a cuboid 2d semantic segmentation mark a class in an image using multiple polygons 3d semantic segmentation mark a class in a point cloud using multiple 3d polygons 2d instance segmentation mark an instance of a class in an image using a polygon 2d polyline mark an object, e g lane marking or object boundary, in an image using a polyline 2d point cluster allows you to place a set amount of points each with its' own properties 2d point place a point in a 2d space 3d point place a point in a 3d space 3d line place a line using x, y, and z coordinates 3d lane place a polyline in 3d with a width that's defined by the left and right edges at each node, you will get the left and right points which are orthogonal to the direction of the geometry 2d instance segmentation & 3d bounding box mark an instance of a class in an image using a polygon in 2d and an object in a point cloud using a cuboid in 3d 2d polyline & 3d line mark an object with a polygon in 2d and with a cuboid in 3d 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 property type description multiple choice use when your question can be answered with either a single answer or multiple answers from a set of options the different options can be configured to your need true / false use when your question can be answered with either true or false connect object used if you want the property to match with another annotated object for example, used when you want to answer which object another object is pulling free form text used if you need text as input horizontal reference line used to mark a horizontal line within a 2d bounding box vertical reference line used to mark a vertical line within a 2d bounding box, e g to indicate the closest corner of a vehicle 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 setting name description default value multiple time instances allow multiple feature instances over time with the same id if an object reappears the id is preserved false persist shape properties property shapes will be interpolated in the same way as normal shapes false interpolate polygons enables interpolation of regular polygons (not multipolygons) false allow outside image used for limiting drawing to be within a percent of the image width/height set it to 0 (zero) to force all shapes to be within the image 0 5 disable histogram equalization disable the histogram equalization functionality false disable image settings disable image settings for controlling brightness and contrast false use frustum show frustum in lidar based on the camera calibration to highlight the area which the image corresponds to true frustum length how long you want the frustum to be in meters 10000 disable filter empty cuboids disable the filter empty stationary cuboid feature in lidar cuboid sequence tasks false disable field of view toggle disable the toggle function for fov in lidar false projections enable time compensated projections both from 3d to 2d and 3d to 3d false require polygon coverage require that polygons covers the entire image false enable 2d layering if true all drawn 2d shapes will have an "order" which dictates which objects are in front of other objects false default to cuboid estimation when enabled, machine assisted drawing will be activated by default, and users will be forced to draw cuboids with machine assisted center/side mode when not enabled, users can select other drawing tools for cuboids, such as 'point mode' to use machine assistance, users must hold 'shift' when drawing without this setting, there's a risk that users will not use the tools available to them to be as productive as they can false default point cloud color mode default point cloud color mode can be changed by the user last selected by user export at frame timestamp determines whether the exported open labels should reflect the motion compensated point cloud or revert to the original non motion compensated point cloud false disable field of view toggle enforces the user to see the tasks in configured point cloud highlight mode and prevents them from switching between field of view and full view modes false disable interpolation disable interpolation for sequence data false multi lidar sensor coloring when using a multi lidar setup, you can specify the point cloud colors for the different lidar sensors, making sure that these become distinct randomly generated colors 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 https //docs kognic com/qfo1 introduction 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 https //docs kognic com/qfo1 introduction 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