-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Showing
1 changed file
with
86 additions
and
11 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,27 +1,102 @@ | ||
| <div align="center" markdown> | ||
|
|
||
| <img src="https://i.imgur.com/UdBujFN.png" width="250" /> <br> | ||
|
|
||
| <img src="https://i.imgur.com/vhrUP20.png" width="100"/> | ||
|
|
||
| # Classes stats for images | ||
| <img src="https://i.imgur.com/cISE5uw.png"/> | ||
|
|
||
| # | ||
|
|
||
| <p align="center"> | ||
|
|
||
| <a href="#overview">Overview</a> • | ||
| <a href="#description">Description</a> • | ||
| <a href="#installation">Installation</a> • | ||
| <a href="#how-to-use">How to use</a> | ||
| <a href="#How-To-Run">How To Run</a> • | ||
| <a href="#Explanation">Explanation</a> | ||
| </p> | ||
|
|
||
| [](https://supervise.ly/slack) | ||
|  | ||
|
|
||
|
|
||
| [](https://supervise.ly) | ||
| [](https://supervise.ly) | ||
| [](https://supervise.ly) | ||
|
|
||
| </div> | ||
|
|
||
| Report gives detailed statistics for all classes in images project | ||
| ## Overview | ||
|
|
||
| Data Exploration for Segmentation and Detection tasks is underestimated by many researchers. The accuracy of your models highly depends on how good you understand data. | ||
|
|
||
| This app **"Classes Stats for Images"** generates report with detailed general and per image statistics for all classes in images project. It allows to see big picture as well as shed light on hidden patterns and edge cases (see <a href="#how-to-use">How to use</a> section). | ||
|
|
||
|
|
||
| ## How To Run | ||
|
|
||
| ### Step 1: Run from context menu of project / dataset | ||
|
|
||
| Go to "Context Menu" (images project or dataset) -> "Report" -> "Classes stats for images" | ||
|
|
||
| <img src="https://i.imgur.com/dGGzVsm.png" width="600"/> | ||
|
|
||
| ### Step 2: Configure running settings | ||
|
|
||
| Choose the percentage of images that should be randomly sampled. By default all images will be used. And then press "Run" button. In advanced settings you can change agent that will host the app and change version (latest available version is used by default). | ||
|
|
||
| <img src="https://i.imgur.com/lI6jenf.png" width="400"/> | ||
|
|
||
|
|
||
| ### Step 3: Open app | ||
|
|
||
| Once app is started, new task appear in workspace tasks. Monitor progress from both "Tasks" list and from application page. To open report in a new tab click "Open" button. | ||
|
|
||
| <img src="https://i.imgur.com/WW4Kacc.png"/> | ||
|
|
||
| App saves resulting report to "Files": `/reports/classes_stats/{USER_LOGIN}/{WORKSPACE_NAME}/{PROJECT_NAME}.lnk`. To open report file in future use "Right mouse click" -> "Open". | ||
|
|
||
| ## Explanation | ||
|
|
||
| ### Per Image Stats | ||
| <img src="https://i.imgur.com/9Hl78Lg.png"/> | ||
|
|
||
| Columns: | ||
| * `IMAGE ID` - image id in Supervisely Instance | ||
| * `IMAGE` - image name with direct link to annotation tool. You can use table to find some anomalies or edge cases in your data by sorting different columns and then quickly open images with annotations to investigate deeper. | ||
| * `HEIGHT`, `WIDTH` - image resolution in pixels | ||
| * `CHANNELS` - number of image channels | ||
| * `UNLABELED` - percentage of pixels (image area) | ||
|
|
||
| Columns for every class: | ||
| * <img src="https://i.imgur.com/tyDf3qi.png" width="100"/> - class area (%) | ||
| * <img src="https://i.imgur.com/1EquheL.png" width="100"/> - number of objects of a given class (%) | ||
|
|
||
| ### Per Class Stats | ||
|
|
||
| <img src="https://i.imgur.com/ztE4BCG.png"/> | ||
|
|
||
| * `CLASS NAME` | ||
| * `IMAGES COUNT` - total number of images that have at least one object of a given class | ||
| * `OBJECTS COUNT` - total number of objects of a given class | ||
| * `AVG CLASS AREA PER IMAGE (%)` - | ||
|
|
||
| ``` | ||
| the sum of a class area on all images | ||
| -------------------------------------------------------------- | ||
| the number of images with at least one object of a given class | ||
| ``` | ||
|
|
||
| * `AVG OBJECTS COUNT PER IMAGE (%)` - | ||
| ``` | ||
| total number of class objects | ||
| -------------------------------------------------------------- | ||
| the number of images with at least one object of a given class | ||
| ``` | ||
|
|
||
| ### Histogram: AVG AREA / AVG OBJECTS COUNT | ||
|
|
||
| <img src="https://i.imgur.com/6LXoXHH.png"/> | ||
|
|
||
| Histogram view for two metrics from previous chapter: `AVG CLASS AREA PER IMAGE (%)` and `AVG OBJECTS COUNT PER IMAGE (%)` | ||
|
|
||
| ### Images Count With / Without Class | ||
|
|
||
| <img src="https://i.imgur.com/veerIHk.png"/> | ||
|
|
||
| ### TOP-10 Image Resolutions | ||
|
|
||
| <img src="https://i.imgur.com/UwrkTBf.png"/> |