annosaurus 0.2.10

This a bug fix release. The direction of a SQL JOIN could cause NullPointerExceptions when marshaling SQL results to JSON.

annosaurus 0.2.9

Added fast queries for certain bulk annotation requests.

Example queries:

Description	URL Example
Find by Concept	http://localhost:8082/anno/v1/fast/concept/Aegina
Find by Concept, with limit/offset	http://localhost:8082/anno/v1/fast/concept/Aegina?limit=2000&offset=10001
Find by Concept, with limit/offset, include ancillary data	http://localhost:8082/anno/v1/fast/concept/Aegina?limit=2000&offset=10001&data=true
Find by Concept, include ancillary data	http://localhost:8082/anno/v1/fast/concept/Aegina?limit=2000&offset=10001&data=true
Find by video reference UUID	http://localhost:8082/anno/v1/fast/videoreference/fae31bea-daf8-4cca-abc5-732eebf61bb0
Find by video reference UUID, with limit/offset	http://localhost:8082/anno/v1/fast/videoreference/fae31bea-daf8-4cca-abc5-732eebf61bb0?limit=100&offset=101
Find by video reference UUID, include ancillary data	http://localhost:8082/anno/v1/fast/videoreference/fae31bea-daf8-4cca-abc5-732eebf61bb0&data=true

Concurrent Video Request

POST http://localhost:8082/anno/v1/fast/concurrent
Content-Type: application/json

{
  "start_timestamp": "2014-11-04T17:02:12Z",
  "end_timestamp": "2014-11-05T19:02:12Z",
  "video_reference_uuids": [
    "c101ecb4-d22d-4f5c-aa9f-1d1048643086", 
    "fae31bea-daf8-4cca-abc5-732eebf61bb0"
  ]
}

Multi Video Request

POST http://localhost:8082/anno/v1/fast/multi
Content-Type: application/json

{
  "video_reference_uuids": [
    "c101ecb4-d22d-4f5c-aa9f-1d1048643086", 
    "fae31bea-daf8-4cca-abc5-732eebf61bb0"
  ]
}

annosaurus 0.2.8

Added a method to make a bulk annotation request across multiple videos. This is to be used by annotation systems that need to things such as fetch all annotations for a deployment which spans multiple videos.

Count annotations

Count annotations for given videos via their video_reference_uuid:

POST /v1/annotations/multi/count
Content-Type: application/json

{
  "video_reference_uuids": [
      "a8307ef9-8e49-40d3-f163-00b37ce4971e", 
      "ec8de1e1-ea59-49b1-bbdb-3f83260d204f"
  ]
}

Retrieve annotations

Retrieve annotations for given videos via their video_reference_uuid. This method accepts limit and offset query params in the URL.

POST /v1/annotations/multi
Content-Type: application/json

{
  "video_reference_uuids": [
      "a8307ef9-8e49-40d3-f163-00b37ce4971e", 
      "ec8de1e1-ea59-49b1-bbdb-3f83260d204f"
  ]
}

In theory, you can supply any number of video_reference_uuids. In practice, this should be limited to less than 1000.

annosaurus 0.2.7

Added a method to make a bulk association request. This is needed to support the new identity-reference and old identity-reference features in vars-annotation. It returns modified associations (aka descriptors) that have the given link_name and belong to one of the media referenced via their video_reference_uuid.

Request Assocations

POST /v1/associations/conceptassociations
Content-Type: application/json

{
  "link_name": "identity-reference"
  "video_reference_uuids": [
      "a8307ef9-8e49-40d3-f163-00b37ce4971e", 
      "ec8de1e1-ea59-49b1-bbdb-3f83260d204f"
  ]
}

The response will be JSON formatted as follows:

{
  "concept_association_request": {
    "link_name": "identity-reference"
    "video_reference_uuids": [
       "a8307ef9-8e49-40d3-f163-00b37ce4971e", 
       "ec8de1e1-ea59-49b1-bbdb-3f83260d204f"
    ]
  },
  "concept_associations": [
    {
      "uuid": "1eba510d-f334-4a5e-b865-5d88a87e981e",
      "video_reference_uuid": "ec8de1e1-ea59-49b1-bbdb-3f83260d204f",
      "concept": "Foo",
      "link_name": "identity-reference",
      "to_concept": "self",
      "link_value": "8",
      "mime_type": "text/plain"
    },
    {
      "uuid": "1eba510d-f334-4a5e-b865-5d88a87e981e",
      "video_reference_uuid": "a8307ef9-8e49-40d3-f163-00b37ce4971e",
      "concept": "Bar",
      "link_name": "identity-reference",
      "to_concept": "self",
      "link_value": "4",
      "mime_type": "text/plain"
    }
  ]
}

annosaurus 0.2.5

This is a bug fix release. There was a typo in the SQL used for counting annotations in version 0.2.4

annosaurus 0.2.4

Added a method to make a bulk request for annotations belonging to different videos.

Count annotations

Count annotations between dates that refer to the given videos via their video_reference_uuid:

POST /v1/annotations/concurrent/count
Content-Type: application/json

{
  "start_timestamp": "2019-05-06T00:00:00Z",
  "end_timestamp": "2019-05-06T11:00:00Z",
  "video_reference_uuids": [
      "a8307ef9-8e49-40d3-f163-00b37ce4971e", 
      "ec8de1e1-ea59-49b1-bbdb-3f83260d204f"
  ]
}

Retrieve annotations

Retrieve annotations between dates that refer to the given videos via their video_reference_uuid. This method accepts limit and offset query params in the URL.

POST /v1/annotations/concurrent
Content-Type: application/json

{
  "start_timestamp": "2019-05-06T00:00:00Z",
  "end_timestamp": "2019-05-06T11:00:00Z",
  "video_reference_uuids": [
      "a8307ef9-8e49-40d3-f163-00b37ce4971e", 
      "ec8de1e1-ea59-49b1-bbdb-3f83260d204f"
  ]
}

In theory, you can supply any number of video_reference_uuids. In practice, this should be limited to less than 1000.

annosaurus 0.2.3

Added:

1. Streaming (chunked) v2 API to retrieve annotations by video_reference_uuid at /v2/annotations/videoreference/:uuid
2. Annotations can be restricted between dates: /v2/annotations/videoreference/:uuid?start=yyyyMMddTHHmmssZ&end=yyyyMMddTHHmmssZ. This is useful for finding concurrent annotations.

annosaurus 0.1.7

Added index API endpoints to speed up timestamp modifications.

annosaurus 0.1.5

Fixed issue with JSON serialization of CachedVideoReferenceInfo missionId. Deployed to docker hub.

annosaurus 0.1.4

Fixed issue #5.