dobble card images

### The Math behind the Card Game

Martin Whitworth gave an excellent overview of the mathematics behind the Dobble card game at the MathsJam conference in 2012.

https://www.mathsjam.com/gathering/uk/archive/2012/

He describes the French card game with an interesting combinatoric property : each card has eight symbols on it, and every pair of cards has exactly one symbol in common.

Mathematically, the card game exploits a finite projective plane of order n=7
- n*n + n + 1 = 57 cards
- n*n + n + 1 = 57 symbols
- (n + 1) cards / symbol
- (n + 1) symbols / card
- 1 matching symbols for any 2 cards

The symbols are various images, such as the following:
- lock
- key
- spider

Each card contains 8 symbols.

Each two card, has 1 (and only 1) common symbol:

NOTE : actual card decks only have 55 cards, for reasons unknown

### Different Card Games

The card deck illustrated in Martin Whitworth's presentation, and the Dobble card deck that I purchased, have some differences.

More specifically, some of the symbols are different between the two card decks.

For the purpose of this project, I will consider the decks to be the same, and attempt to create a solution that supports both.
The symbol descriptions have been chosen to represent both variants :
- Bird(OK)
- Hammer(STOP)
- Turtle(ART).

### The Data Set

We have captured images of the Dobble card deck with different lighting conditions.

The data set includes the following content:

- 10 card decks, for training
- 2 sets of random cards, for testing
- 1 csv file describing which symbols are on each card
- 1 csv file containing the description of each symbol

The first card deck was taken from Martin Whitworth's presentation, and is the only card deck with 57 cards.

Deck 02 and 04 were created by Mario Bergeron with a web cam on a black desk.

The third card deck was created by Mario Bergeron with a flat bed scanner.

Decks 5, 6, 7, 8, and 9 were taken by Kevin Keryk with different lighting conditions.

Deck 10 was taken by Monica Houston with variable nanoleaf lighting source.

This collection of decks provides a limited dataset, but under different lighting sources.

### Acknowledgements

A huge thank you to Kevin Keryk and Monica Houston for their help in creating this data set.

### Inspiration

Although this data set has been set up as a classification problem,
addition data may be added in the fugure to create a detection problem.
Please share your thoughts on how this data set can be improved.
If you want to contribute to the data set, in any way, please reach out to me.

### 数学奥秘中的卡牌游戏

马丁·惠特沃斯于2012年在MathsJam会议上，对Dobble卡牌游戏的数学原理进行了精彩的概述。

https://www.mathsjam.com/gathering/uk/archive/2012/

他描述了一种具有有趣组合特性的法国卡牌游戏：每张卡片上都有八个符号，且每两张卡片恰好有一个共同符号。

从数学的角度来看，该卡牌游戏利用了有限射影平面（order n=7）。
- n*n + n + 1 = 57 张卡片
- n*n + n + 1 = 57 个符号
- 每个符号对应 (n + 1) 张卡片
- 每张卡片对应 (n + 1) 个符号
- 任意两张卡片恰好有一个共同符号

符号包括以下各种图像，例如以下所示：
- 锁
- 钥匙
- 蜘蛛

每张卡片包含8个符号。

每两张卡片恰好有一个（且仅有一个）共同符号：

注：实际卡牌套装只有55张，原因不明。

### 不同的卡牌游戏

马丁·惠特沃斯展示中的卡牌套装以及我所购买的Dobble卡牌套装之间存在一些差异。

具体来说，两个卡牌套装中的某些符号不同。

为了本项目的目的，我将考虑这两个套装相同，并尝试创建一个支持两者的解决方案。
符号描述被选用来代表两种变体：
- 鸟（OK）
- 锤子（STOP）
- 海龟（ART）。

### 数据集

我们捕捉了Dobble卡牌套装在不同光照条件下的图像。

该数据集包括以下内容：
- 用于训练的10套卡牌
- 2套随机卡牌，用于测试
- 1个csv文件，描述每张卡牌上的符号
- 1个csv文件，包含每个符号的描述

第一套卡牌来自马丁·惠特沃斯的展示，是唯一一套包含57张卡牌的套装。
套装02和04是由马里奥·贝热龙使用黑色桌面的网络摄像头创建的。
第三套卡牌是由马里奥·贝热龙使用平板扫描仪创建的。
套装5、6、7、8和9是由凯文·凯里克在不同光照条件下拍摄的。
套装10是由莫妮卡·休斯顿使用可变nanoleaf照明光源拍摄的。
这一系列套装提供了有限的样本集，但涵盖了不同的光照条件。

### 致谢

衷心感谢凯文·凯里克和莫妮卡·休斯顿在创建此数据集中的帮助。

### 灵感

尽管这个数据集已被设定为分类问题，但未来可能会添加更多数据以创建检测问题。
请分享您对如何改进此数据集的看法。
如果您想以任何方式为此数据集做出贡献，请与我联系。