Code Monkey home page Code Monkey logo

visual-inspection-tool's Introduction

visual-inspection-tool

Annotation and visualization tool for Multimodal Data. It uses sessions file collected with the LearningHub. For more information about the LearningHub https://github.com/janschneiderou/LearningHub

Version :1.6 // Credits: Daniele Di Mitri - Open University of The Netherlands Copyright information: (CC BY-SA 4.0) https://creativecommons.org/licenses/by-sa/4.0/

1. Installing the VIT

  1. Clone the repository git clone https://github.com/dimstudio/visual-inspection-tool.git
  2. Open index.html with a browser (Google Chrome suggested)
  3. Load a LearningHub session (.zip file). Look in the folder /examples for a sample session. If the session contains a valid video and sensor files they will be loaded.
  4. Select 1 or multiple attributes from the Attribute List to plot them in the chart

2. Setting custom time-intervals

  1. When the chart is populated you can zoom in a custom time-interval by resizing the legend below the chart.
  2. You will see the that in the panel Time intervals the [start, end] of the interval you selected.
  3. You can add this interval to the list.
  4. Click again in the plot legend to zoom out.

3. Setting custom annotations

  1. You can add an annotation by name in the panel "Edit annotation"
  2. The annotations are Key-value pairs and are assigned to the time intervals.
  3. Once completed with assigning annotations you can "export" the annotations.

4. Contact and support

In case of questions you can email [email protected]

5. Screenshot

alt text

6. Cite this

Di Mitri D., Schneider J., Specht M., Drachsler H. (2019) Read Between the Lines: An Annotation Tool for Multimodal Data for Learning. In Proceedings of the 9th International Conference on Learning Analytics & Knowledge - LAK19 (pp. 51–60). New York, NY, USA: ACM. DOI: 10.1145/3303772.3303776

http://doi.org/10.1145/3303772.3303776

visual-inspection-tool's People

Contributors

dimstudio avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

visual-inspection-tool's Issues

Consider a dedicated software license instead of Creative Commons

I saw the repository is licensed under the CC-BY-SA. Thanks for making this tool freely available!

If you want to ensure the free usability and improvement of this software, Creative Commons Licenses are unfortunately not ideal for software.
See https://creativecommons.org/faq/#can-i-apply-a-creative-commons-license-to-software
Citing the imporant part:

We recommend against using Creative Commons licenses for software. Instead, we strongly encourage you to use one of the very good software licenses which are already available. We recommend considering licenses listed as free by the Free Software Foundation and listed as “open source” by the Open Source Initiative.

Unlike software-specific licenses, CC licenses do not contain specific terms about the distribution of source code, which is often important to ensuring the free reuse and modifiability of software. Many software licenses also address patent rights, which are important to software but may not be applicable to other copyrightable works. Additionally, our licenses are currently not compatible with the major software licenses, so it would be difficult to integrate CC-licensed work with other free software. Existing software licenses were designed specifically for use with software and offer a similar set of rights to the Creative Commons licenses.

Version 4.0 of CC’s Attribution-ShareAlike (BY-SA) license is one-way compatible with the GNU General Public License version 3.0 (GPLv3). This compatibility mechanism is designed for situations in which content is integrated into software code in a way that makes it difficult or impossible to distinguish the two. There are special considerations required before using this compatibility mechanism.

Here is an easy choice of a free software license: https://choosealicense.com/
Github also provides the option to easily add a License file with the right text to your repository: https://docs.github.com/en/github/building-a-strong-community/adding-a-license-to-a-repository

Since you currently use the Share Alike CC License, a natural fit would be a copyleft license like AGPL3+ that ensures that modified versions that are distributed publicly have to share their improvements to the code under the same terms.
In comparison to GPL3+, the AGPL3+ also considers someone hosting this as a website instead of directly giving out the program as a public distribution and thus they also have to share their improvements back to the community.

I hope this can be helpful to ensuring your software can be used, integrated and improved upon by more people without having to worry about licensing issues/compatibility with CC-BY-SA.
In case the licensing decision was made intentionally as is, feel free to ignore and close this issue! :)

Intervals, unclear assignment of annotations

There is an unclear and confusing relationship between intervals and annotations.
Logically there is a n:m relationship between Intervals and Annotations.

But when one annotation is assigned to an interval, the list of annotations still shows all annotations ever used in the session for other intervals.
It is hence not clear, if the annotations still are assigned to that specific time interval, especially if the don't make particurlarly sense.

It would probably make most sense to have the annotations split into two panels.
One panel just listing the annotations without values, and a second panel showing the selected annotations for each interval with values.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.