size_categories:100M<n<1B language:en license:cc-by-4.0 region:us
---
license: cc-by-4.0
thumbnail: >-
  https://huggingface.co/datasets/Linaqruf/bandori-card-dataset/resolve/main/samples/thumbnail.png
size_categories:
- 100M<n<1B
language:
- en
---
# Bandori Card Dataset

![Sample Image](https://huggingface.co/datasets/Linaqruf/bandori-card-dataset/resolve/main/samples/sample.png)

The Bandori Card Dataset is a comprehensive collection of cards from the game "BanG Dream! Girls Band Party!" (Bandori). It aims to provide card metadata and corresponding artwork images for analysis, research, and other purposes.

## Dataset Description

The dataset includes the following information for each card:

- Card ID: Unique identifier for each card in the game.
- Rarity: The rarity level of the card, ranging from 1 to 5.
- Name: The name or title of the card.
- Artwork URLs: URLs pointing to the artwork images associated with each card.

The dataset is organized based on card rarity, with separate folders for each rarity level. Within each folder, you can find the artwork images corresponding to the respective rarity.

## Dataset Structure

The dataset follows the following file structure:
```
        /
        ├── images/
        │ ├── rarity1/
        │ │ ├── Bushido%21.png
        │ │ ├── Cat-Eared_Producer.png
        │ │ ├── Cool_%26_Fierce_Singer.png
        │ │ └── ...
        │ ├── rarity2/
        │ │ ├── %E2%99%A1For_you.png
        │ │ ├── A_Caring_Princess.png
        │ │ ├── A_Crucial_Member.png
        │ │ └── ...
        │ ├── rarity3/
        │ │ ├── %22Just_a_Bite%22_Surprise.png
        │ │ ├── 1%2C_2%2C_3%2C_to_the_Light.png
        │ │ ├── 180_Degrees%2C_12_Minutes.png
        │ │ └── ...
        │ ├── rarity4/
        │ │ ├── %22Dramatic%22_Daily_Life.png
        │ │ ├── %22The_School_Prince%22.png
        │ │ ├── %E2%88%9ESurprise%21.png
        │ │ └── ...
        │ └── rarity5/
        │   ├── Afternoon_Coffee_T.png
        │   ├── Autumn_Dream_T.png
        │   ├── Blue-Tinted_Stroll_T.png
        │   └── ...
        └── metadata/
          ├── rarity1.json
          ├── rarity2.json
          ├── rarity3.json
          ├── rarity4.json
          └── rarity5.json
```

The `images` folder contains subfolders for each rarity level (rarity1, rarity2, etc.), and within each rarity folder, you can find the corresponding card artwork images.

The `metadata` folder contains JSON files for each rarity level, containing card metadata in the following format:

```json
[
    {
        "id": 1,
        "rarity": 1,
        "name": "Bushido!",
        "art_url": "https://example.com/images/rarity1/Bushido%21.png"
    },
    {
        "id": 2,
        "rarity": 1,
        "name": "Cat-Eared Producer",
        "art_url": "https://example.com/images/rarity1/Cat-Eared_Producer.png"
    },
    ...
]
```

## Usage
To use this dataset, you can download a zipfile from this [direct link](https://huggingface.co/datasets/Linaqruf/bandori-card-dataset/resolve/main/bandori-card-dataset.zip) or download the artwork images and access the metadata for each card by using [Bandori Wiki Scraper](https://colab.research.google.com/github/Linaqruf/Scraper/blob/main/Bandori_Wiki_Scraper.ipynb) notebook. The metadata provides information such as card ID, rarity level, name, and the URL of the artwork image.

## Image Count
The total number of image files is `1454`, distributed across the different rarity levels as follows:
```
      Rarity1: 35 images
      Rarity2: 404 images
      Rarity3: 448 images
      Rarity4: 546 images
      Rarity5: 21 images
```
Please note that the numbers may vary based on the dataset version.

# License
The Bandori Card Dataset is provided under the [Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)](https://creativecommons.org/licenses/by-nc/4.0/) license.

# Acknowledgments
We would like to acknowledge the [BanG Dream! Girls Band Party! Fandom](https://bandori.fandom.com/) website for providing the card data and artwork used in this dataset.

## Limitations

While the Bandori Card Dataset strives to provide comprehensive card data and artwork from the BanG Dream! Girls Band Party! game, there are a few limitations to be aware of:

1. **Incomplete Image Coverage**: The dataset includes card data and artwork from a range of card rarities and IDs up to an index of 1-1800. However, it's important to note that only 1453 images are available in the dataset. This means that there might be gaps in the image coverage for certain card IDs within the specified index range.

2. **Incomplete Coverage**: Additionally, the dataset covers a range of card rarities and IDs up to a specific maximum index. However, there may be newer cards or updates to the game that are not included in the dataset. It's advisable to cross-reference the dataset with the latest game data for the most up-to-date information.

3. **Website Structure Dependency**: The scraper code relies on the specific HTML structure of the BanG Dream! Girls Band Party! Fandom website. Any changes to the website structure may impact the scraper's ability to extract card data accurately. It's important to monitor and adjust the scraper code accordingly if there are changes to the website.

4. **Data Integrity**: While efforts have been made to ensure the accuracy and completeness of the dataset, errors or discrepancies in the card data and artwork may exist. Users are encouraged to verify and validate the dataset independently for their specific use cases.

## Data Quality

The Bandori Card Dataset aims to provide high-quality card data and artwork. Here are a few considerations regarding the dataset's organization and image files:

1. **Image File Separation by Rarity**: The artwork images in the dataset are organized and stored in separate folders based on the card rarity, rather than the index. Each rarity level has its own folder in the `images` directory, making it easier to locate images based on their rarity. Please refer to the directory structure provided in the repository for more details.

2. **Data Source**: The card data and artwork are sourced from the BanG Dream! Girls Band Party! Fandom website. The dataset quality is dependent on the accuracy and consistency of the information available on the website. It's advisable to refer to official game sources for authoritative data.

3. **Artwork Resolution**: The artwork images in the dataset are obtained from the website and may vary in resolution and quality. The provided images are the best available representations within the limitations of the source material.

4. **Metadata Accuracy**: The metadata provided in the dataset, including card ID, rarity, and name, is extracted from the website. While efforts have been made to ensure accuracy, there may be instances of typographical errors or discrepancies between the dataset and the actual game data.

If you encounter any significant issues with the dataset's quality or have suggestions for improvement, please feel free to contribute or reach out to us using the contact information provided below.


# Citation
If you use this dataset in your research or any other work, please consider citing it as:
```
    @dataset{linaqruf/bandori-card-dataset,
      author = {Furqanil Taqwa},
      title = {Bandori Card Dataset},
      year = {2023},
      publisher = {Hugging Face},
      version = {1.0},
      url = {https://huggingface.co/datasets/Linaqruf/bandori-card-dataset}
    }
```