Package: wai.annotations
Python library for converting between annotation formats of data domains such as images and audio.Also offers plugins for preprocessing data, for generating statistics and visualizations,
as well as incorporating predictions made via a Redis backend (e.g., using deep learning models).Changelog0.8.0 (2022-09-06)wai.annotations.tf is now optionalinstall.sh now has -o flag to install optional modules when installing latest (-l)Upgraded wai.annotations.commonvoice to 1.0.2Upgraded wai.annotations.core to 0.2.0Upgraded wai.annotations.imgaug to 1.0.6Upgraded wai.annotations.layersegments to 1.0.2Upgraded wai.annotations.video to 1.0.2Upgraded wai.annotations.yolo to 1.0.1Added wai.annotations.coqui 1.0.00.7.8 (2022-06-29)Added wai.annotations.audioAdded wai.annotations.genericUpgraded wai.annotations.core to 0.1.8Upgraded wai.annotations.subdir to 1.0.10.7.7 (2022-06-13)Added wai.annotations.grayscaleUpgraded wai.annotations.bluechannel to 1.0.2Upgraded wai.annotations.coco to 1.0.2Upgraded wai.annotations.core to 0.1.7Upgraded wai.annotations.grayscale to 1.0.1Upgraded wai.annotations.imgaug to 1.0.5Upgraded wai.annotations.imgstats to 1.0.3Upgraded wai.annotations.imgvis to 1.0.3Upgraded wai.annotations.indexedpng to 1.0.1Upgraded wai.annotations.redis.predictions to 1.0.2Upgraded wai.annotations.roi to 1.0.1Upgraded wai.annotations.video to 1.0.10.7.6 (2022-05-12)Added wai.annotations.imgstats.Added wai.annotations.imgvis.Added wai.annotations.opex.Added wai.annotations.video.Added wai.annotations.redis.predictions.Upgraded wai.annotations.core version.0.7.5 (2022-03-10)Upgraded wai.annotations.tf version.0.7.4 (2022-03-01)Included wai.annotations.imgaug.Included wai.annotations.yolo.0.7.3 (2021-11-11)Upgraded wai.annotations.tf version from 1.1.0 to 1.2.0.Included wai.annotations.voc.0.7.2 (2021-07-28)Upgraded wai.annotations.tf version from 1.0.0 to 1.1.0.0.7.1 (2021-05-21)Fixed build (hopefully).0.7.0 (2021-05-20)Split packages into separate modules so individual formats can be used/excluded.0.6.0 (2021-03-30)Sub-commands (convert, plugins, domains).Can use –help/-h anywhere in a command string and get help.Updated documentation.Bug fixes.0.5.4 (2020-11-05)Bug fixes.0.5.3 (2020-11-03)Added ability to provide a source iterable when usingiterate_files.ConversionPipelineBuildernow works with any combination of sources, processors and sinks.Data elements now are only referred to by their base filename.0.5.2 (2020-11-02)Added the layer-segments image-segmentation format.Added theod-to-iscross-domain converter.Bug fixes.0.5.1 (2020-10-30)Fixed bug in calculating output directory from command-line option.Addedstrip-annotationsISP.Stopped COCO/ROI/VGG image object-detection formats from writing negative annotations.Fixed bug in coercions where negatives instances weren’t being handled correctly.Added–denseoption toto-tf-odwhich encodes masks in the dense numerical format.0.5.0 (2020-10-27)Refactor of the internal structure to aid in debugging.All input/output formats now end in the short-code of their domain.0.4.7 (2020-09-03)Fixed bug where–category-output-filewas being written to an arbitrary location.0.4.6 (2020-08-05)Added –category-output-file option to to-coco format for writing the categories to a simple
comma-separated text file.Added the subdir image classification format.Added the ADAMS image classification format.Refactored label-mapping, image format conversion and label filtering into their own
ISPs (were options on object detection readers/writers).Better error messages when domains are incorrectly matched.Upgraded wai.common requirement to fix bug with file iteration.0.4.5 (2020-08-03)Made help more helpful.Added macros, which allow for simple command-line argument substitution.Improved logging during split-writes. More improvements to come.0.4.4 (2020-07-29)Separated base reader/writer functionality into abstract bases which don’t assume
local disk access.0.4.3 (2020-07-28)Added new option to the MS-COCO format to sort the categories.0.4.2 (2020-07-28)Added new options to the MS-COCO format for pre-specifying the categories to expect.0.4.1 (2020-07-27)Added domain information to the–list-pluginscommand.Basic support for speech annotations, including CommonVoice and FestVox formats.Added–debugglobal flag to aid in debugging.Added file_iterator method to conversion chains, allowing iteration over the converted file-data.Fixed dependency error on installation from PyPI caused by pycocotools.Bug fixes.0.4.0 (2020-07-02)Major restructure to introduce domains other than object-detection in images.0.3.6 (2020-06-22)Modified numpy/pycocotools requirements to work with EfficientDet.Added sha256, is_crowd and area features to TFRecords format to work with EfficientDet.Fixed bug where full set of TFRecord shard files wasn’t being generated.0.3.5 (2020-04-03)Added InputChain and OutputChain classes, encapsulating the stages of input and output respectively.Modified parsing so that users can create “main-like” CLI interfaces.Bug fixes.0.3.4 (2020-03-31)Updated requirement for wai.common to v0.0.31.Updated requirement for wai.bynning to v0.0.2.0.3.3 (2020-03-27)Added support for BMP-format images.Added--convert-imageoption to convert images to a given image-format.0.3.2 (2020-03-24)Added--split-namesand--split-ratiosoptions for creating splits in the
dataset.Added--seedoption for randomising file-read order.0.3.1 (2020-03-18)Bug fix where plugin registry was being recreated every run.Bug fix where previous registry incarnation was being loaded instead of new version.0.3.0 (2020-03-18)Converted formats to use a plug-in system so other libraries can define their own formats.0.2.3 (2020-03-17)Upgraded wai.common requirement to v0.0.28.Separated main settings from library settings.Changed--include-zero-areaflag to min/max width/height/area flags.Added--commentsoption for ROI writer to insert comments at the beginning
of written files.Input directories read all contained files ending in.reportwhen usingadamsformat.Added--sample-strideoption to tfrecords input which sub-samples the mask when generating
the polygon for speed increase.Added--mask-thresholdoption to tfrecords input which sets the probability to consider
the mask inside the polygon.Internal format is now an object rather than a tuple.Added--size-modeflag to ROI format which writes ROI files with x,y,w,h headers rather
than x0,y0,x1,y1 headers.0.2.2 (2020-03-11)Upgraded wai.common requirement to v0.0.26.0.2.1 (2020-03-11)VGG/COCO formats can now take a--prettyflag to pretty-print their JSON annotations.Upgraded wai.common requirement to v0.0.25.image_utils.lists_to_polygonmethod converts lists of X and Y coordinates into aplanar.Polygonimage_utils.polygon_to_bboxmethod returns the x0,y0,x1,y1 coordinates of the bounding box around
the suppliedplanar.Polygonobject0.2.0 (2020-03-06)Conversions now automatically discard annotations with zero area, can be reverted
with--include-zero-areaflag.image_utils.mask_to_polygoncan now work with a view of the mask instead of
the full mask to speed up the polygon detectionModified utilities for getting labels/prefixes to be able to specify a default value.Upgraded wai.common requirement to v0.0.24.Added requirement for wai.json v0.0.4.0.1.4 (2020-02-18)Added compatibility layer for Tensorflow V1.Now ensures Tensorflow is in eager execution mode.0.1.3 (2020-02-12)Upgraded wai.common requirement to v0.0.22.0.1.2 (2020-01-24)Fixed default filename for ROI format (“-rois.csv” rather than “-roi.csv”).Added the ability to specify a prefix and suffix for reading/writing ROI files.Logging changes.Moved utilities for each format into their own sub-package.Added reader options to read input files from list files.0.1.1 (2020-01-23)Separated command-line option parsing from io/converter classes so that imports
unique to specific formats are not required unless using that format.Refactoring of package structure.Added logging of when files are being written.Conversion to COCO format now report polygon mask area, rather than just bounding-
box area.Added support for non-standard keywords to the ROI format.0.1.0 (2020-01-22)Added the ability to specify inputs by glob syntax, and also specify negative
images with no annotations.Added utility functions for images (image_to_numpyarray, remove_alpha_channel)
and for masks (mask_to_polygon, polygon_to_minrect, polygon_to_lists) in module wai.annotations.image_utilsAdded –extensions option to control the search order for associated images.Added –verbosity flag to control logging verbosity.Added polygon mask support to the ROI format.0.0.4 (2020-01-15)Modified requirements to include Cython as this is required in later versions
of pycocotools. Moved pycocotools to end of dependency list to ensure all
requirements are met before installation.0.0.3 (2019-12-16)Changed –coerce option to –force.Tensorflow is no longer a dependency in setup.py as can work with
tensorflow or tensorflow-gpu.TFRecords format can now handle polygon-mask annotations.0.0.2 (2019-12-09)Can now work with images that contain no annotations.0.0.1 (2019-12-04)Initial release