annotell-input-api 0.3.2

Annotell Input Api Client

Annotell Input Api

Python 3 library providing access to Annotell Input Api

To install with pip run pip install annotell-input-api

Example

Set env ANNOTELL_CREDENTIALS to the credentials file provided to you by Annotell, see annotell-auth.

Once set, the easiest way to test if everything is working is to use the command line util annoutil (this is a part of the pip package).

$ annoutil projects

Changelog

All notable changes to this project will be documented in this file.

[0.3.2] - 2020-09-01

Changed

• SLAM - startTs and endTs not optional in Slam request

[0.3.1] - 2020-07-16

Changed

• If the upload of point clouds or images crashes and returns status code 429, 408 or 5xx the script will retry the upload before crashing. The default settings may be changed when initializing the InputApiClient by specifying values to the max_upload_retry_attempts and max_upload_retry_wait_time parameters.

[0.3.0] - 2020-07-03

Changed

• The method create_inputs_point_cloud_with_images in InputApiClient now takes an extra parameter: dryrun: bool. If set to True all the validation checks will be run but no inputJob will be created, and if it is set to False an inputJob will be created if the validation checks all pass.

Bugfixes

• Fixed bug where the uploading of .csv files to GCS crashed if run on some windows machines.

[0.2.9] - 2020-07-02

Added

• New public method in InputApiClient: count_inputs_for_external_ids.

[0.2.8] - 2020-06-30

Added

• Docstrings for all public methods in the InputApiClient class

[0.2.7] - 2020-06-29

Added

• Require time specification to be send when posting slam requests

[0.2.6] - 2020-06-26

Changed

• Removed CalibrationSpec from CalibratedSceneMetaData and SlamMetaData. Updated so that create_calibration_data in InputApiClient only takes a CalibrationSpec as parameter.

[0.2.5] - 2020-06-22

Bugfixes

• Fixed issue where a path including a "~" would not expand correctly.

[0.2.4] - 2020-06-17

Changed

• Changed pointcloud_with_images model. Images and point clouds are now represented as Image and PointCloud containing filename and source. Consequently, images_to_source is removed from SourceSpecification.

Added

• create Image inputs via create_images_input_job
• It's now possible to invalidate erroneous inputs via invalidate_inputs
• Support for removing specific inputs via remove_inputs_from_input_list
• SLAM support (not generally available)

Bugfixes

• Fixed issue where annoutils would not deserialize datas correctly when querying datas by internalId

[0.2.3] - 2020-04-21

Changed

• Changed how timestamps are represented when receiving responses.

[0.2.2] - 2020-04-17

Added

• Methods get_datas_for_inputs_by_internal_ids and get_datas_for_inputs_by_external_ids can be used to get which Data are part of an Input, useful in order to check which images, lidar-files have been uploaded. Both are also available in the CLI via :

$ annoutil inputs --get-datas <internal_ids>
$ annoutil inputs-externalid --get-datas <external_ids>

• Support has been added for Kannala camera types. Whenever adding calibration for Kannala undistortion coefficients must also be added.
• Calibration is now represented as a class and is no longer just a dictionary, making it easier to understand how the Annotell format is structured and used.

[0.2.0] - 2020-04-16

Changed

• Change constructor to disable legacy api token support and only accept an auth parameter

[0.1.5] - 2020-04-07

Added

• Method get_input_jobs_status now accepts lists of internal_ids and external_ids as arguments.