Commit 5522f6d0 authored by Abhishek Dutta's avatar Abhishek Dutta

updated README and via-3.0.0 release

parent b372e37c
Copyright (c) 2016-2019, Abhishek Dutta, Visual Geometry Group, Oxford University.
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
# VGG Image Annotator
VGG Image Annotator is a simple and standalone manual
annotation software for image, audio and video. VIA runs in a web browser and
does not require any installation or setup. The complete VIA software fits in a
single self-contained HTML page of size less than 300 Kilobyte that runs as an
offline application in most modern web browsers.
VIA is an [open source](https://gitlab.com/vgg/via) project based solely on
HTML, Javascript and CSS (no dependency on external libraries). VIA is
developed at the [Visual Geometry Group](http://www.robots.ox.ac.uk/~vgg/) (VGG)
and released under the BSD-2 clause [license](https://gitlab.com/vgg/via/blob/master/LICENSE)
which allows it to be useful for both academic projects and commercial applications.
## Screenshots
/home/tlm/dev/via/
![Screenshot showing basic image annotation](via-2.x.y/doc/screenshots/via_demo_screenshot2_via-2.0.2.jpg)
![Temporal segments showing different human activities (e.g. break egg, pour liquid, etc.) and spatial regions (e.g. bounding box of cup) occupied by different objects in a still video frame are manually delineated in a video showing preparation of a drink.](via-3.x.y/doc/screenshots/via_video_annotator.png)
![Speech segments of two individuals is manually delineated in an audio recording of conversation between ATC and pilot](via-3.x.y/doc/screenshots/via_audio_annotator.png)
![Screenshot of VIA being used for face annotation](via-2.x.y/doc/screenshots/via_face_demo_screenshot4.jpg)
![Screenshot of VIA being used for face track annotation](via-2.x.y/doc/screenshots/via_face_track_demo_screenshot1.jpg)
## Download
Detailed instructions for download of VIA3 are available at http://www.robots.ox.ac.uk/~vgg/software/via/
## Demo
We have created self contained demo to illustrate the usage of VIA3. These demo
have been preloaded with some sample audio and video files. Furthermore, we have
also added some sample manual annotations to these demo. These demo applications
are very useful to get familiar with the commonly used features of VIA3.
* [Basic Image Annotation Demo](http://www.robots.ox.ac.uk/~vgg/software/via/via_demo.html)
* [Face Annotation Demo](http://www.robots.ox.ac.uk/~vgg/software/via/via_face_demo.html)
* [Remote Image Annotation Demo](http://www.robots.ox.ac.uk/~vgg/software/via/via_wikimedia_demo.html)
* [Face Track Annotation Demo](http://www.robots.ox.ac.uk/~vgg/software/via/docs/face_track_annotation.html)
* [Video Annotator Demo](http://www.robots.ox.ac.uk/~vgg/software/via/demo/via_video_annotator.html)
* [Audio Annotator Demo](http://www.robots.ox.ac.uk/~vgg/software/via/demo/via_audio_annotator.html)
## Open Source Ecosystem
The development of VIA software began in August 2016 and the first public
release of version 1 was made in April 2017. Many new advanced features
for image annotation were introduced in version 2 which was released in June 2018.
Recently released version 3 of VIA software supports annotation of audio and video.
As of May 2019, the VIA software has been used more than 600,000 times (+150,000 unique pageviews).
We have nurtured a large and thriving open source community which not
only provides feedback but also contributes code to add new features
and improve existing features in the VIA software. The open source
ecosystem of VIA thrives around its [source code repository](https://gitlab.com/vgg/via)
hosted by the Gitlab platform. Most of our users report issues and
request new features for future releases using the [issue portal](https://gitlab.com/vgg/via/issues).
Many of our users not only submit bug reports but also suggest a potential
fix for these software issues. Some of our users also contribute code
to add new features to the VIA software using the [merge request portal](https://gitlab.com/vgg/via/merge_requests).
We welcome all forms of contributions (code update, documentation, bug reports, etc) from users.
Such contributions must must adhere to the existing [license](https://gitlab.com/vgg/via/blob/master/LICENSE) of
the VIA project.
## Contact
Contact [Abhishek Dutta]([email protected]) for any queries or feedback related to this application.
## Acknowledgements
This work is supported by EPSRC programme grant Seebibyte: Visual Search for the Era of Big Data ( [EP/M013774/1](http://www.seebibyte.org/index.html) )
# VGG Image Annotator
# VGG Image Annotator Version 1
VGG Image Annotator (VIA) is an open source project developed at the
[Visual Geometry Group](http://www.robots.ox.ac.uk/~vgg/) and released under
the BSD-2 clause license. This work is supported by EPSRC programme grant
Seebibyte: Visual Search for the Era of Big Data ([EP/M013774/1](http://www.seebibyte.org/index.html)).
Visit the [VGG software page](http://www.robots.ox.ac.uk/~vgg/software/via/) for more details.
VGG Image Annotator version 1 is an early version of VIA which is still useful
for basic image annotation tasks. VIA runs in a web browser and
does not require any installation or setup. The complete VIA software fits in a
single self-contained HTML page of size less than 300 Kilobyte that runs as an
offline application in most modern web browsers.
VIA is an [open source](https://gitlab.com/vgg/via) project based solely on
HTML, Javascript and CSS (no dependency on external libraries). VIA is
developed at the [Visual Geometry Group](http://www.robots.ox.ac.uk/~vgg/) (VGG)
and released under the BSD-2 clause [license](https://gitlab.com/vgg/via/blob/master/LICENSE)
which allows it to be useful for both academic projects and commercial applications.
## Features:
* based solely on HTML, CSS and Javascript (no external javascript libraries)
* can be used off-line (full application in a single html file of size < 200KB)
* requires nothing more than a modern web browser (tested on Firefox, Chrome and Safari)
* supported region shapes: rectangle, circle, ellipse, polygon and point
* import/export of region data in csv and json file format
## Screenshots
![Screenshot showing basic image annotation](via-1.x.y/doc/screenshots/big_ben_annotation.jpg)
## Downloads
* VGG Image Annotator (VIA)
* [via-1.0.5.zip](http://www.robots.ox.ac.uk/~vgg/software/via/downloads/via-1.0.5.zip) : includes the VIA application (< 200KB) and its demo
* [via-src-1.0.5.zip](http://www.robots.ox.ac.uk/~vgg/software/via/downloads/via-src-1.0.5.zip) : source code and [code documentation](https://gitlab.com/vgg/via/blob/master/CodeDoc.md)
* [via.html](http://www.robots.ox.ac.uk/~vgg/software/via/via.html) : online version of VIA application
* [via_demo.html](http://www.robots.ox.ac.uk/~vgg/software/via/via_demo.html) : live online demo (with preloadd images and regions)
## Download
Detailed instructions for download of VIA are available at http://www.robots.ox.ac.uk/~vgg/software/via/
## Demo
* VGG Image Annotator (VIA)
* [via_demo-1.0.5.html](http://www.robots.ox.ac.uk/~vgg/software/via/via_demo.html) : live demo of VIA application with preloaded image
We have created self contained demo to illustrate the usage of VIA3. These demo
have been preloaded with some sample audio and video files. Furthermore, we have
also added some sample manual annotations to these demo. These demo applications
are very useful to get familiar with the commonly used features of VIA3.
* [Basic Image Annotation Demo](http://www.robots.ox.ac.uk/~vgg/software/via/via-1.0.6_demo.html)
## Open Source Ecosystem
The development of VIA software began in August 2016 and the first public
release of version 1 was made in April 2017. Many new advanced features
for image annotation were introduced in version 2 which was released in June 2018.
Recently released version 3 of VIA software supports annotation of audio and video.
As of May 2019, the VIA software has been used more than 600,000 times (+150,000 unique pageviews).
We have nurtured a large and thriving open source community which not
only provides feedback but also contributes code to add new features
and improve existing features in the VIA software. The open source
ecosystem of VIA thrives around its [source code repository](https://gitlab.com/vgg/via)
hosted by the Gitlab platform. Most of our users report issues and
request new features for future releases using the [issue portal](https://gitlab.com/vgg/via/issues).
Many of our users not only submit bug reports but also suggest a potential
fix for these software issues. Some of our users also contribute code
to add new features to the VIA software using the [merge request portal](https://gitlab.com/vgg/via/merge_requests).
## Docs
* Getting Started : this can be accessed by pressing F1 key in the VIA application.
* [VIA Software page @ VGG](http://www.robots.ox.ac.uk/~vgg/software/via/)
* [VIA Wikipedia page](https://en.wikipedia.org/wiki/VGG_Image_Annotator)
We welcome all forms of contributions (code update, documentation, bug reports, etc) from users.
Such contributions must must adhere to the existing [license](https://gitlab.com/vgg/via/blob/master/LICENSE) of
the VIA project.
## Developer Resources
For development, [via.js](https://gitlab.com/vgg/via/blob/develop/via.js)
......@@ -41,25 +56,20 @@ packs the VIA application into a single and standalone application file
Javascript, HTML and CSS.
* Source code
* [VGG Image Annotator @ develop branch](https://gitlab.com/vgg/via/blob/develop)
* [Source code documentation](https://gitlab.com/vgg/via/blob/develop/CodeDoc.md)
* [Contributing Guidelines](https://gitlab.com/vgg/via/blob/develop/CONTRIBUTING.md)
* [VGG Image Annotator @ develop branch](https://gitlab.com/vgg/via/blob/master/via-1.x.y)
* [Source code documentation](https://gitlab.com/vgg/via/blob/master/via-1.x.y/CodeDoc.md)
* [Contributing Guidelines](https://gitlab.com/vgg/via/blob/master/via-1.x.y/CONTRIBUTING.md)
* Unit Tests
* [tests/via_test_fileio.js](tests/via_test_fileio.js) : tests for import/export of annotations
* [tests/via_test_region.js](tests/via_test_region.js) : tests for region create, move, delete operations
* [tests/via_test_fileio.js](via-1.x.y/tests/via_test_fileio.js) : tests for import/export of annotations
* [tests/via_test_region.js](via-1.x.y/tests/via_test_region.js) : tests for region create, move, delete operations
The [Quality Assessment](https://gitlab.com/vgg/via/blob/develop/QualityAssessment.md)
The [Quality Assessment](https://gitlab.com/vgg/via/blob/master/via-1.x.y/QualityAssessment.md)
page describes the guidelines to ensure the quality of VIA application, source
code and its documentation.
Software bug reports and feature requests should be
[submitted here](https://gitlab.com/vgg/via/issues/new) (requires gitlab account).
For all other queries, please contact [Abhishek Dutta](mailto:[email protected]).
## Contact
Contact [Abhishek Dutta]([email protected]) for any queries or feedback related to this application.
## License
VIA is an open source project released under the
[BSD-2 clause license](https://gitlab.com/vgg/via/blob/master/LICENSE).
## Acknowledgements
This work is supported by EPSRC programme grant Seebibyte: Visual Search for the Era of Big Data ( [EP/M013774/1](http://www.seebibyte.org/index.html) )
## Author
[Abhishek Dutta](mailto:[email protected])
Aug. 31, 2016
......@@ -13,8 +13,8 @@ and released under the BSD-2 clause [license](https://gitlab.com/vgg/via/blob/ma
which allows it to be useful for both academic projects and commercial applications.
## Screenshots
![Screenshot of VIA showing human activities (e.g.\ break egg, pour liquid, etc.) and objects in a video being labelled using VIA.](via-3.x.y/doc/screenshots/via_video_annotator.png "Human activities (e.g.\ break egg, pour liquid, etc.) and objects are labelled in a video describing the preparation of a drink.")
![Screenshot of VIA showing an audio being manually annotated to delineate speech segments of two individuals in an audio recording of conversation between ATC and pilot.](via-3.x.y/doc/screenshots/via_audio_annotator.png "VIA software being used to manually delineate speech segments of two individuals in an audio recording of conversation between ATC and pilot.")
![Temporal segments showing different human activities (e.g. break egg, pour liquid, etc.) and spatial regions (e.g. bounding box of cup) occupied by different objects in a still video frame are manually delineated in a video showing preparation of a drink.](via-3.x.y/doc/screenshots/via_video_annotator.png)
![Speech segments of two individuals is manually delineated in an audio recording of conversation between ATC and pilot](via-3.x.y/doc/screenshots/via_audio_annotator.png)
## Download
Detailed instructions for download of VIA3 are available at http://www.robots.ox.ac.uk/~vgg/software/via/
......@@ -30,9 +30,9 @@ are very useful to get familiar with the commonly used features of VIA3.
## Open Source Ecosystem
The development of VIA software began in August 2016 and the first public
release of version 1 was made in April 2017. Many new advanced features
for image annotation were introduced in version 2 which was released in June 2018~\cite{dutta2019vgg}.
for image annotation were introduced in version 2 which was released in June 2018.
Recently released version 3 of VIA software supports annotation of audio and video.
As of May 2019, the VIA software has been used more than $600,000$ times ($+150,000$ unique pageviews).
As of May 2019, the VIA software has been used more than 600,000 times (+150,000 unique pageviews).
We have nurtured a large and thriving open source community which not
only provides feedback but also contributes code to add new features
......@@ -53,3 +53,4 @@ Contact [Abhishek Dutta]([email protected]) for any queries or f
## Acknowledgements
This work is supported by EPSRC programme grant Seebibyte: Visual Search for the Era of Big Data ( [EP/M013774/1](http://www.seebibyte.org/index.html) )
......@@ -8069,7 +8069,7 @@ function _via(via_container) {
this.d = new _via_data();
// debug code
if ( true ) {
if ( false ) {
this.d.store = _via_dp[2]['store'];
this.d._cache_update();
......
......@@ -8099,7 +8099,7 @@ function _via(via_container) {
this.d = new _via_data();
// debug code
if ( true ) {
if ( false ) {
this.d.store = _via_dp[2]['store'];
this.d._cache_update();
......
......@@ -16,7 +16,7 @@ function _via(via_container) {
this.d = new _via_data();
// debug code
if ( true ) {
if ( false ) {
this.d.store = _via_dp[2]['store'];
this.d._cache_update();
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment