
# Dataset of ppk/PPK/PPK (Girls' Frontline)

This is the dataset of ppk/PPK/PPK (Girls' Frontline), containing 182 images and their tags.

The core tags of this character are `long_hair, earrings, brown_eyes, hair_ornament, blonde_hair, very_long_hair, breasts, light_brown_hair, cross_earrings, hairband, frilled_hairband, bangs, ribbon`, which are pruned in this dataset.

Images are crawled from many sites (e.g. danbooru, pixiv, zerochan ...), the auto-crawling system is powered by [DeepGHS Team](https://github.com/deepghs)([huggingface organization](https://huggingface.co/deepghs)).

## List of Packages

| Name             |   Images | Size       | Download                                                                                                            | Type       | Description                                                          |
|:-----------------|---------:|:-----------|:--------------------------------------------------------------------------------------------------------------------|:-----------|:---------------------------------------------------------------------|
| raw              |      182 | 281.93 MiB | [Download](https://huggingface.co/datasets/CyberHarem/ppk_girlsfrontline/resolve/main/dataset-raw.zip)              | Waifuc-Raw | Raw data with meta information (min edge aligned to 1400 if larger). |
| 800              |      182 | 137.21 MiB | [Download](https://huggingface.co/datasets/CyberHarem/ppk_girlsfrontline/resolve/main/dataset-800.zip)              | IMG+TXT    | dataset with the shorter side not exceeding 800 pixels.              |
| stage3-p480-800  |      453 | 301.49 MiB | [Download](https://huggingface.co/datasets/CyberHarem/ppk_girlsfrontline/resolve/main/dataset-stage3-p480-800.zip)  | IMG+TXT    | 3-stage cropped dataset with the area not less than 480x480 pixels.  |
| 1200             |      182 | 236.91 MiB | [Download](https://huggingface.co/datasets/CyberHarem/ppk_girlsfrontline/resolve/main/dataset-1200.zip)             | IMG+TXT    | dataset with the shorter side not exceeding 1200 pixels.             |
| stage3-p480-1200 |      453 | 458.83 MiB | [Download](https://huggingface.co/datasets/CyberHarem/ppk_girlsfrontline/resolve/main/dataset-stage3-p480-1200.zip) | IMG+TXT    | 3-stage cropped dataset with the area not less than 480x480 pixels.  |

### Load Raw Dataset with Waifuc

We provide raw dataset (including tagged images) for [waifuc](https://deepghs.github.io/waifuc/main/tutorials/installation/index.html) loading. If you need this, just run the following code

```python
import os
import zipfile

from huggingface_hub import hf_hub_download
from waifuc.source import LocalSource

# download raw archive file
zip_file = hf_hub_download(
    repo_id='CyberHarem/ppk_girlsfrontline',
    repo_type='dataset',
    filename='dataset-raw.zip',
)

# extract files to your directory
dataset_dir = 'dataset_dir'
os.makedirs(dataset_dir, exist_ok=True)
with zipfile.ZipFile(zip_file, 'r') as zf:
    zf.extractall(dataset_dir)

# load the dataset with waifuc
source = LocalSource(dataset_dir)
for item in source:
    print(item.image, item.meta['filename'], item.meta['tags'])
```

## List of Clusters

List of tag clustering result, maybe some outfits can be mined here.

### Raw Text Version

|   # |   Samples | Img-1                           | Img-2                           | Img-3                           | Img-4                           | Img-5                           | Tags                                                                                                                                                                                                                                                                                                                 |
|----:|----------:|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|   0 |        28 | ![](samples/0/clu0-sample0.png) | ![](samples/0/clu0-sample1.png) | ![](samples/0/clu0-sample2.png) | ![](samples/0/clu0-sample3.png) | ![](samples/0/clu0-sample4.png) | 1girl, puffy_short_sleeves, frills, solo, jewelry, walther, handgun, black_gloves, cross, holding_gun, black_dress, looking_at_viewer, smile, gothic_lolita, yellow_eyes, simple_background                                                                                                                          |
|   1 |         8 | ![](samples/1/clu1-sample0.png) | ![](samples/1/clu1-sample1.png) | ![](samples/1/clu1-sample2.png) | ![](samples/1/clu1-sample3.png) | ![](samples/1/clu1-sample4.png) | 1girl, black_dress, cross, jewelry, solo, looking_at_viewer, mod3_(girls'_frontline), small_breasts, bare_shoulders, black_gloves, choker, hairclip, hair_ribbon, collarbone, medium_breasts, official_alternate_costume, simple_background, smile, walther, black_footwear, full_body, thighhighs, white_background |
|   2 |        13 | ![](samples/2/clu2-sample0.png) | ![](samples/2/clu2-sample1.png) | ![](samples/2/clu2-sample2.png) | ![](samples/2/clu2-sample3.png) | ![](samples/2/clu2-sample4.png) | 1girl, elbow_gloves, jewelry, looking_at_viewer, race_queen, solo, official_alternate_costume, cross, fingerless_gloves, medium_breasts, blush, checkered_flag, smile, visor_cap, white_headwear, holding_flag, thigh_boots, black_footwear, black_thighhighs, thighs                                                |
|   3 |        30 | ![](samples/3/clu3-sample0.png) | ![](samples/3/clu3-sample1.png) | ![](samples/3/clu3-sample2.png) | ![](samples/3/clu3-sample3.png) | ![](samples/3/clu3-sample4.png) | 1girl, solo, jewelry, looking_at_viewer, official_alternate_costume, smile, navel, blush, cross, black_bikini, hairclip, medium_breasts                                                                                                                                                                              |

### Table Version

|   # |   Samples | Img-1                           | Img-2                           | Img-3                           | Img-4                           | Img-5                           | 1girl   | puffy_short_sleeves   | frills   | solo   | jewelry   | walther   | handgun   | black_gloves   | cross   | holding_gun   | black_dress   | looking_at_viewer   | smile   | gothic_lolita   | yellow_eyes   | simple_background   | mod3_(girls'_frontline)   | small_breasts   | bare_shoulders   | choker   | hairclip   | hair_ribbon   | collarbone   | medium_breasts   | official_alternate_costume   | black_footwear   | full_body   | thighhighs   | white_background   | elbow_gloves   | race_queen   | fingerless_gloves   | blush   | checkered_flag   | visor_cap   | white_headwear   | holding_flag   | thigh_boots   | black_thighhighs   | thighs   | navel   | black_bikini   |
|----:|----------:|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------------------------------|:--------|:----------------------|:---------|:-------|:----------|:----------|:----------|:---------------|:--------|:--------------|:--------------|:--------------------|:--------|:----------------|:--------------|:--------------------|:--------------------------|:----------------|:-----------------|:---------|:-----------|:--------------|:-------------|:-----------------|:-----------------------------|:-----------------|:------------|:-------------|:-------------------|:---------------|:-------------|:--------------------|:--------|:-----------------|:------------|:-----------------|:---------------|:--------------|:-------------------|:---------|:--------|:---------------|
|   0 |        28 | ![](samples/0/clu0-sample0.png) | ![](samples/0/clu0-sample1.png) | ![](samples/0/clu0-sample2.png) | ![](samples/0/clu0-sample3.png) | ![](samples/0/clu0-sample4.png) | X       | X                     | X        | X      | X         | X         | X         | X              | X       | X             | X             | X                   | X       | X               | X             | X                   |                           |                 |                  |          |            |               |              |                  |                              |                  |             |              |                    |                |              |                     |         |                  |             |                  |                |               |                    |          |         |                |
|   1 |         8 | ![](samples/1/clu1-sample0.png) | ![](samples/1/clu1-sample1.png) | ![](samples/1/clu1-sample2.png) | ![](samples/1/clu1-sample3.png) | ![](samples/1/clu1-sample4.png) | X       |                       |          | X      | X         | X         |           | X              | X       |               | X             | X                   | X       |                 |               | X                   | X                         | X               | X                | X        | X          | X             | X            | X                | X                            | X                | X           | X            | X                  |                |              |                     |         |                  |             |                  |                |               |                    |          |         |                |
|   2 |        13 | ![](samples/2/clu2-sample0.png) | ![](samples/2/clu2-sample1.png) | ![](samples/2/clu2-sample2.png) | ![](samples/2/clu2-sample3.png) | ![](samples/2/clu2-sample4.png) | X       |                       |          | X      | X         |           |           |                | X       |               |               | X                   | X       |                 |               |                     |                           |                 |                  |          |            |               |              | X                | X                            | X                |             |              |                    | X              | X            | X                   | X       | X                | X           | X                | X              | X             | X                  | X        |         |                |
|   3 |        30 | ![](samples/3/clu3-sample0.png) | ![](samples/3/clu3-sample1.png) | ![](samples/3/clu3-sample2.png) | ![](samples/3/clu3-sample3.png) | ![](samples/3/clu3-sample4.png) | X       |                       |          | X      | X         |           |           |                | X       |               |               | X                   | X       |                 |               |                     |                           |                 |                  |          | X          |               |              | X                | X                            |                  |             |              |                    |                |              |                     | X       |                  |             |                  |                |               |                    |          | X       | X              |


task_categories:text-to-image size_categories:n<1K license:mit art not-for-all-audiences region:us
{"license": "mit", "size_categories": ["n<1K"], "task_categories": ["text-to-image"], "tags": ["art", "not-for-all-audiences"]}
TAGS
#task_categories-text-to-image #size_categories-n<1K #license-mit #art #not-for-all-audiences #region-us 

Dataset of ppk/PPK/PPK (Girls' Frontline)
=========================================


This is the dataset of ppk/PPK/PPK (Girls' Frontline), containing 182 images and their tags.


The core tags of this character are 'long\_hair, earrings, brown\_eyes, hair\_ornament, blonde\_hair, very\_long\_hair, breasts, light\_brown\_hair, cross\_earrings, hairband, frilled\_hairband, bangs, ribbon', which are pruned in this dataset.


Images are crawled from many sites (e.g. danbooru, pixiv, zerochan ...), the auto-crawling system is powered by DeepGHS Team(huggingface organization).


List of Packages
----------------



### Load Raw Dataset with Waifuc


We provide raw dataset (including tagged images) for waifuc loading. If you need this, just run the following code


List of Clusters
----------------


List of tag clustering result, maybe some outfits can be mined here.


### Raw Text Version



### Table Version




### Load Raw Dataset with Waifuc


We provide raw dataset (including tagged images) for waifuc loading. If you need this, just run the following code


List of Clusters
----------------


List of tag clustering result, maybe some outfits can be mined here. ### Raw Text Version ### Table Version
TAGS
#task_categories-text-to-image #size_categories-n<1K #license-mit #art #not-for-all-audiences #region-us 
 ### Load Raw Dataset with Waifuc


We provide raw dataset (including tagged images) for waifuc loading. If you need this, just run the following code


List of Clusters
----------------


List of tag clustering result, maybe some outfits can be mined here. ### Raw Text Version ### Table Version