diff --git a/_howtos/annotate.markdown b/_howtos/annotate.markdown index f351f18..c91a3ef 100644 --- a/_howtos/annotate.markdown +++ b/_howtos/annotate.markdown @@ -2,41 +2,48 @@ title: Annotate --- -### Background +# **Annotate** -The Media Suite annotation tool started to be built by reusing previous applications developed at The Netherlands Institute for Sound and Vision during projects such as [LinkedTV](https://www.linkedtv.eu/), [Axes](https://www.axes-project.eu/), [ArtTube](https://www.arttube.nl/), and lately the project *[The Mind of the Universe](https://themindoftheuniverse.org/explore)* produced, among others, by the Dutch broadcaster VPRO. In the first project (LinkedTV), a strong emphasis was put on the automatic extraction of entities (e.g., names of persons, locations, buildings, etc.) from the spoken, written and visual message. Since this extraction could not fully rely on automatic means, a decision was taken to focus more on manual annotation and using automatically extracted information to aid the annotator (by displaying entity word clouds, or shot and scene thumbnails, or delete some of the automatically suggested links to web pages when these were unreliable). This tool was improved in the AXES project, where users were offered a way to annotate videos with the purpose of creating a “ground truth” to be used in further evaluation of video hyperlinking. +The Media Suite offers a manual annotation tool where it is possible to annotate on item level and on segment level. When annotating on item level, you add an annotation relating to the whole item. When annotating on segment level you add an annotation to a specific selection within that item.\ +\ +**Annotation on item level** \ +To annotate on item level, first select the item you wish to annotate, which will open in the ‘resource viewer’ environment. Go to ‘My Annotations’ on the right-hand side of the screen, and click on ‘Resource’. Clicking on “Resource” opens a drop-down menu with four options: -In this way, the editing tools evolved into a manual annotation tool that has been “rebuilt” within the CLARIAH Media Suite infrastructure. The tool is currently evolving to incorporate the most essential functionalities (i.e. segmenting, tagging, commenting, linking, and adding personal metadata via customizable templates) that were detected to be necessary in the aforementioned projects. +* **“Code”** allows you to label the media item using terms from existing thesauri (such as GTAA and UNESCO) or using your own custom-made taxonomy. -You can read more about this tool and how it has been used in scholarly research by one of the CLARIAH research pilot projects in: Aasman, S., Melgar Estrada, L., Ros, V., Slotweg, T., & Wegter, R. (2018). Exploring Video Annotation for Doing Media History. *VIEW Journal of European Television History and Culture*, *in print*. +* **“Comment”** gives you the possibility to enter your own comments about the item without a set word limit. -### How to use +* **“Link”** allows you to include links to items in the Media Suite or outside of it. -> See at our CLARIAH YouTube channel the [Screencast: "Manual video annotation"](https://www.youtube.com/watch?v=KL-YXK856OQ&t=157s), and ["Annotate"](https://www.youtube.com/watch?v=el5QzQgh58g&t=2s) +* **“Metadata”** allows you to devise your own metadata scheme for the item. -The control buttons are still under development, but the hotkeys allow you to create segments. +Once you have added annotations they will appear in the project overview in your workspace, just as your saved queries.\ +\ +**Annotation on segment level** \ +To annotate on segment level, you first need to create a segmentation layer. In a segmentation layer, you group together manually created segments according to, for example, a motif or a theme. -**Essential keyboard shortkuts:** +* You create a segmentation layer by clicking on “ADD LAYER” on the left hand side below the video player and you can give the layer a name by double-clicking on the layer’s text box. -- i (input key, start from a segment) -- o (output key, end from a segment) -- SHIFT+s (save the segment as an annotation) -- SHIFT+e (open annotation tool in a pop-up) -- SHIFT+n (new segment) +* To subsequently create a segment, first pause the video or audio where you want to begin the segment. After having chosen a beginning point press “i” (“i” stands for “in”). A red line/time marker will appear at the point chosen. -**Other useful keyboard shortcuts (on test for Version 4):** +* Subsequently, you need to choose an endpoint for your segment. Use the cursor to choose an endpoint and press “o” (“o” stands for out) to confirm the end point. Alternately, you may simply drag the end point of the segment using your mouse (the same goes for the beginning of the segment). You have now created a segment. -- SHIFT + i (jump to the marked starting point) -- SHIFT + o (jump to the marked ending point) -- SHIFT + 1-9 (jump forward x seconds in the video) -- Left arrow (jump 1 minute back in the video) -- Right arrow (jump 1 minute ahead in the video) -- CTRL+n (new segment from the end of the selected segment) -- SHIFT+rechts (select the next segment) -- SHIFT+links (select the previous segment) -- SHIFT+a (add new annotation to the resource (as a whole)) +* In order to make a new segment, you need to press the “\+”-symbol in the layer you just made, or create a new layer consisting of new segments. This is important, because it makes sure that your segment is saved. If you proceed to setting new in and out points using the “i” and “o” keys without first pressing “\+” you will end up modifying the segment you just made instead of creating a new one. -Note: to assign a title to your segment, use the "metadata cards", the title is set to use the value you enter in the "metadata.title" field. in the new version of the Resource viewer/Annotation tool, if you don't assign any value, the title will be generated by the comments/codes/links +Now you have created a segment in your video item and are ready to annotate it. In order to do so, you first need to find and select the segment in the “Segments” overview in the “My Annotations” column on your right hand side. -*(Last update: July, 2018)*. *If you have any questions, please [contact us](/contact).* +* Click on the segment from the “Segments” overview that you wish to annotate. Upon clicking, a drop-down menu will appear with the same four options that was offered for annotating on item level (“Code”, “Comment”, “Link” and “Metadata”) +* Using these four options, you may annotate the segment in a similar fashion as when you annotated the item. + +* Saved annotations will appear in the project overview in the workspace. + +For more information on the annotation tool, please see the following pages: + +* [Tutorial](https://mediasuite.clariah.nl/learn/subject-tutorials/media-suite-tutorial-searching-annotating-and-linking-for-film-historical-research): Searching, annotating and linking for film historical research + +* [Tutorial](https://mediasuite.clariah.nl/learn/subject-tutorials/media-suite-tutorial-video-segmentation-annotation-and-structuralist-film-analysis): Video Segmentation, Annotation and Structuralist Film Analysis + +* [Media Suite Screencast](https://www.youtube.com/watch?v=KL-YXK856OQ&t=157s): Manual video annotation + +* [Media Suite Screencast](https://www.youtube.com/watch?v=el5QzQgh58g&t=2s): Annotate \ No newline at end of file