# Tutorial (Single Image Example)

## Annotation

```bash
labelme apc2016_obj3.jpg
```

![](.readme/annotation.jpg)

## Visualization

To view the json file quickly, you can use utility script:

```bash
./draw_json.py apc2016_obj3.json
```

<img src=".readme/draw_json.jpg" width="70%" />

## Convert to Dataset

To convert the json to set of image and label, you can run following:

```bash
./export_json.py apc2016_obj3.json
```

It generates standard files from the JSON file.

- [img.png](apc2016_obj3/img.png): Image file.
- [label.png](apc2016_obj3/label.png): uint8 label file.
- [label_viz.png](apc2016_obj3/label_viz.png): Visualization of `label.png`.
- [label_names.txt](apc2016_obj3/label_names.txt): Label names for values in `label.png`.

## How to load label PNG file?

Note that loading `label.png` is a bit difficult
(`scipy.misc.imread`, `skimage.io.imread` may not work correctly),
and please use `PIL.Image.open` to avoid unexpected behavior:

```python
# see load_label_png.py also.
>>> import numpy as np
>>> import PIL.Image

>>> label_png = 'apc2016_obj3/label.png'
>>> lbl = np.asarray(PIL.Image.open(label_png))
>>> print(lbl.dtype)
dtype('uint8')
>>> np.unique(lbl)
array([0, 1, 2, 3], dtype=uint8)
>>> lbl.shape
(907, 1210)
```

Also, you can see the label PNG file by:

```bash
./draw_label_png.py apc2016_obj3/label.png
```

<img src=".readme/draw_label_png.jpg" width="35%" />
