geowatch.cli.watch_coco_stats module

class geowatch.cli.watch_coco_stats.WatchCocoStats(*args, **kwargs)[source]

Bases: DataConfig

Print geowatch-relevant information about a kwcoco dataset.

This provides summary information about:

  • Basic kwcoco stats (number of annotations / images / videos / categories)

  • Average GSDs

  • sensor / channel histograms

  • image / annotation / video attribute historams

  • Breakdowns over sensor / channel / video / dataset

  • Per video summaries

CommandLine

geowatch stats special:shapes8 vidshapes vidshapes-msi vidshapes-geowatch

Todo

  • [ ] Add other useful geowatch stats to this script

SeeAlso:

kwcoco stats

Valid options: []

Parameters:
  • *args – positional arguments for this data config

  • **kwargs – keyword arguments for this data config

classmethod main(cmdline=True, **kw)[source]

Example

>>> from geowatch.cli import watch_coco_stats
>>> import geowatch
>>> dset1 = geowatch.coerce_kwcoco('geowatch-msi', geodata=True, dates=True, heatmap=True)
>>> dset2 = geowatch.coerce_kwcoco('vidshapes8')
>>> kw = dict(src=[dset1.fpath, dset2.fpath])
>>> cmdline = 0
>>> watch_coco_stats.__cli__.main(cmdline=cmdline, **kw)

Example

>>> from geowatch.cli import watch_coco_stats
>>> import geowatch
>>> dset1 = geowatch.coerce_kwcoco('geowatch-msi', geodata=True, dates=True, heatmap=True)
>>> kw = dict(src=dset1.fpath)
>>> cmdline = 0
>>> watch_coco_stats.__cli__.main(cmdline=cmdline, **kw)
default = {'io_workers': <Value('avail')>, 'src': <Value(None)>, 'with_video_info': <Value(False)>}
geowatch.cli.watch_coco_stats.coco_watch_stats(dset, with_video_info=False)[source]
Parameters:

dset (kwcoco.CocoDataset)

Returns:

stat_info

Return type:

Dict[str, Any]

Example

>>> from geowatch.cli.watch_coco_stats import *  # NOQA
>>> import geowatch
>>> dset = geowatch.coerce_kwcoco('geowatch-msi-geodata-heatmap-dates')
>>> stat_info = coco_watch_stats(dset)
geowatch.cli.watch_coco_stats.build_year_summary(image_df)[source]
geowatch.cli.watch_coco_stats.coco_sensorchan_gsd_stats(coco_dset)[source]

Checks the GSD of each band.

geowatch.cli.watch_coco_stats.main(cmdline=True, **kw)

Example

>>> from geowatch.cli import watch_coco_stats
>>> import geowatch
>>> dset1 = geowatch.coerce_kwcoco('geowatch-msi', geodata=True, dates=True, heatmap=True)
>>> dset2 = geowatch.coerce_kwcoco('vidshapes8')
>>> kw = dict(src=[dset1.fpath, dset2.fpath])
>>> cmdline = 0
>>> watch_coco_stats.__cli__.main(cmdline=cmdline, **kw)

Example

>>> from geowatch.cli import watch_coco_stats
>>> import geowatch
>>> dset1 = geowatch.coerce_kwcoco('geowatch-msi', geodata=True, dates=True, heatmap=True)
>>> kw = dict(src=dset1.fpath)
>>> cmdline = 0
>>> watch_coco_stats.__cli__.main(cmdline=cmdline, **kw)