Upload README.md with huggingface_hub

409b04b verified about 1 month ago

9.91 kB

	# ASCAD V1 Models Repository

	This repository contains all trained models for the ASCAD (ANSSI SCA Database) side-channel attack project.
	Models are organized by desynchronization level and architecture variant.

	## Repository Structure

	```
	desync{N}/
	{variant}/ # Multi-task models (LMIC-TSBN, HPS, MTAN Lite, LMIC)
	model.h5 # Trained Keras model
	results.json # Evaluation results (per-byte ranks)
	rank_curve_byte{X}.npy # Rank convergence curves
	{model_type}/ # Per-byte models (CNN, MLP)
	byte{X}/
	model.h5
	results.json
	rank_curve.npy
	```

	## Model Inventory

	### Multi-Task Models (all 16 bytes simultaneously)

	\| Desync \| Variant \| Rank 0 Count \| Max Rank \| Mean Rank \| Params \| Epochs \| Train Time \|
	\|--------\|---------\|-------------\|----------\|-----------\|--------\|--------\|------------\|
	\| desync0 \| hps \| 2/16 \| 129 \| 49.8 \| 5,250,688 \| 134 \| 193.2m \|
	\| desync0 \| lmic \| 15/16 \| 14 \| 0.9 \| 1,508,224 \| 68 \| 26.0m \|
	\| desync0 \| lmic_tsbn \| 16/16 \| 0 \| 0.0 \| 267,968 \| 170 \| 28.4m \|
	\| desync0 \| lmic_tsbn_no_cosine \| 16/16 \| 0 \| 0.0 \| 1,023,232 \| 400 \| 257.5m \|
	\| desync0 \| lmic_tsbn_no_dtp \| 16/16 \| 0 \| 0.0 \| 1,023,232 \| 170 \| 108.9m \|
	\| desync0 \| lmic_tsbn_no_sd \| 16/16 \| 0 \| 0.0 \| 1,023,232 \| 170 \| 109.2m \|
	\| desync0 \| lmic_tsbn_small \| 16/16 \| 0 \| 0.0 \| 267,968 \| 170 \| 28.4m \|
	\| desync0 \| mtan_lite \| 2/16 \| 246 \| 79.1 \| 7,897,728 \| 75 \| 80.7m \|
	\| desync50 \| lmic_tsbn \| 16/16 \| 0 \| 0.0 \| 1,023,232 \| 170 \| 36.2m \|
	\| desync100 \| lmic_tsbn \| 16/16 \| 0 \| 0.0 \| 1,023,232 \| 170 \| 36.3m \|

	### Per-Byte Models (one model per byte)

	\| Desync \| Model Type \| Bytes Available \| Notes \|
	\|--------\|-----------\|----------------\|-------\|
	\| desync0 \| cnn \| 1/16 \| \|
	\| desync0 \| mlp \| 1/16 \| \|
	\| desync50 \| cnn \| 1/16 \| \|
	\| desync50 \| mlp \| 1/16 \| \|
	\| desync100 \| cnn \| 1/16 \| \|
	\| desync100 \| mlp \| 1/16 \| \|

	## Detailed Per-Byte Results (Multi-Task Models)

	### desync0/hps

	\| Byte \| Final Rank \| Rank@500 \| Rank@1000 \| Pre-Rank \| Min Rank \| Max Rank \|
	\|------\|-----------\|----------\|-----------\|----------\|----------\|----------\|
	\| 0 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 1 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 2 \| 2 \| 14 \| ? \| ? \| 1 \| ? \|
	\| 3 \| 66 \| 211 \| ? \| ? \| 29 \| ? \|
	\| 4 \| 57 \| 66 \| ? \| ? \| 29 \| ? \|
	\| 5 \| 86 \| 194 \| ? \| ? \| 19 \| ? \|
	\| 6 \| 27 \| 40 \| ? \| ? \| 0 \| ? \|
	\| 7 \| 19 \| 33 \| ? \| ? \| 1 \| ? \|
	\| 8 \| 41 \| 161 \| ? \| ? \| 39 \| ? \|
	\| 9 \| 91 \| 61 \| ? \| ? \| 16 \| ? \|
	\| 10 \| 129 \| 71 \| ? \| ? \| 29 \| ? \|
	\| 11 \| 14 \| 3 \| ? \| ? \| 0 \| ? \|
	\| 12 \| 39 \| 26 \| ? \| ? \| 13 \| ? \|
	\| 13 \| 88 \| 194 \| ? \| ? \| 78 \| ? \|
	\| 14 \| 109 \| 198 \| ? \| ? \| 98 \| ? \|
	\| 15 \| 28 \| 5 \| ? \| ? \| 1 \| ? \|

	### desync0/lmic

	\| Byte \| Final Rank \| Rank@500 \| Rank@1000 \| Pre-Rank \| Min Rank \| Max Rank \|
	\|------\|-----------\|----------\|-----------\|----------\|----------\|----------\|
	\| 0 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 1 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 2 \| 0 \| 1 \| ? \| ? \| 0 \| ? \|
	\| 3 \| 0 \| 1 \| ? \| ? \| 0 \| ? \|
	\| 4 \| 14 \| 171 \| ? \| ? \| 10 \| ? \|
	\| 5 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 6 \| 0 \| 20 \| ? \| ? \| 0 \| ? \|
	\| 7 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 8 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 9 \| 0 \| 20 \| ? \| ? \| 0 \| ? \|
	\| 10 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 11 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 12 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 13 \| 0 \| 6 \| ? \| ? \| 0 \| ? \|
	\| 14 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 15 \| 0 \| 4 \| ? \| ? \| 0 \| ? \|

	### desync0/lmic_tsbn

	\| Byte \| Final Rank \| Rank@500 \| Rank@1000 \| Pre-Rank \| Min Rank \| Max Rank \|
	\|------\|-----------\|----------\|-----------\|----------\|----------\|----------\|
	\| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 1 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 2 \| 0 \| 0 \| 0 \| 235 \| 0 \| 235 \|
	\| 3 \| 0 \| 0 \| 0 \| 228 \| 0 \| 228 \|
	\| 4 \| 0 \| 0 \| 0 \| 14 \| 0 \| 14 \|
	\| 5 \| 0 \| 0 \| 0 \| 20 \| 0 \| 57 \|
	\| 6 \| 0 \| 0 \| 0 \| 35 \| 0 \| 44 \|
	\| 7 \| 0 \| 0 \| 0 \| 7 \| 0 \| 7 \|
	\| 8 \| 0 \| 0 \| 0 \| 63 \| 0 \| 63 \|
	\| 9 \| 0 \| 0 \| 0 \| 14 \| 0 \| 14 \|
	\| 10 \| 0 \| 0 \| 0 \| 98 \| 0 \| 98 \|
	\| 11 \| 0 \| 0 \| 0 \| 57 \| 0 \| 89 \|
	\| 12 \| 0 \| 0 \| 0 \| 41 \| 0 \| 53 \|
	\| 13 \| 0 \| 0 \| 0 \| 209 \| 0 \| 209 \|
	\| 14 \| 0 \| 0 \| 0 \| 153 \| 0 \| 153 \|
	\| 15 \| 0 \| 0 \| 0 \| 1 \| 0 \| 1 \|

	### desync0/lmic_tsbn_no_cosine

	\| Byte \| Final Rank \| Rank@500 \| Rank@1000 \| Pre-Rank \| Min Rank \| Max Rank \|
	\|------\|-----------\|----------\|-----------\|----------\|----------\|----------\|
	\| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 1 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 2 \| 0 \| 0 \| 0 \| 193 \| 0 \| 193 \|
	\| 3 \| 0 \| 0 \| 0 \| 247 \| 0 \| 247 \|
	\| 4 \| 0 \| 0 \| 0 \| 32 \| 0 \| 52 \|
	\| 5 \| 0 \| 0 \| 0 \| 36 \| 0 \| 56 \|
	\| 6 \| 0 \| 0 \| 0 \| 35 \| 0 \| 35 \|
	\| 7 \| 0 \| 0 \| 0 \| 10 \| 0 \| 10 \|
	\| 8 \| 0 \| 0 \| 0 \| 76 \| 0 \| 76 \|
	\| 9 \| 0 \| 0 \| 0 \| 23 \| 0 \| 23 \|
	\| 10 \| 0 \| 0 \| 0 \| 146 \| 0 \| 146 \|
	\| 11 \| 0 \| 0 \| 0 \| 93 \| 0 \| 101 \|
	\| 12 \| 0 \| 0 \| 0 \| 47 \| 0 \| 61 \|
	\| 13 \| 0 \| 0 \| 0 \| 196 \| 0 \| 196 \|
	\| 14 \| 0 \| 0 \| 0 \| 131 \| 0 \| 131 \|
	\| 15 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|

	### desync0/lmic_tsbn_no_dtp

	\| Byte \| Final Rank \| Rank@500 \| Rank@1000 \| Pre-Rank \| Min Rank \| Max Rank \|
	\|------\|-----------\|----------\|-----------\|----------\|----------\|----------\|
	\| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 1 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 2 \| 0 \| 0 \| 0 \| 229 \| 0 \| 229 \|
	\| 3 \| 0 \| 0 \| 0 \| 229 \| 0 \| 229 \|
	\| 4 \| 0 \| 0 \| 0 \| 5 \| 0 \| 22 \|
	\| 5 \| 0 \| 0 \| 0 \| 10 \| 0 \| 10 \|
	\| 6 \| 0 \| 0 \| 0 \| 37 \| 0 \| 40 \|
	\| 7 \| 0 \| 0 \| 0 \| 11 \| 0 \| 11 \|
	\| 8 \| 0 \| 0 \| 0 \| 66 \| 0 \| 66 \|
	\| 9 \| 0 \| 0 \| 0 \| 24 \| 0 \| 24 \|
	\| 10 \| 0 \| 0 \| 0 \| 110 \| 0 \| 110 \|
	\| 11 \| 0 \| 0 \| 0 \| 86 \| 0 \| 87 \|
	\| 12 \| 0 \| 0 \| 0 \| 65 \| 0 \| 65 \|
	\| 13 \| 0 \| 0 \| 0 \| 193 \| 0 \| 206 \|
	\| 14 \| 0 \| 0 \| 0 \| 129 \| 0 \| 129 \|
	\| 15 \| 0 \| 0 \| 0 \| 2 \| 0 \| 2 \|

	### desync0/lmic_tsbn_no_sd

	\| Byte \| Final Rank \| Rank@500 \| Rank@1000 \| Pre-Rank \| Min Rank \| Max Rank \|
	\|------\|-----------\|----------\|-----------\|----------\|----------\|----------\|
	\| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 1 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 2 \| 0 \| 0 \| 0 \| 227 \| 0 \| 227 \|
	\| 3 \| 0 \| 0 \| 0 \| 237 \| 0 \| 237 \|
	\| 4 \| 0 \| 0 \| 0 \| 2 \| 0 \| 2 \|
	\| 5 \| 0 \| 0 \| 0 \| 5 \| 0 \| 5 \|
	\| 6 \| 0 \| 0 \| 0 \| 44 \| 0 \| 59 \|
	\| 7 \| 0 \| 0 \| 0 \| 2 \| 0 \| 2 \|
	\| 8 \| 0 \| 0 \| 0 \| 26 \| 0 \| 26 \|
	\| 9 \| 0 \| 0 \| 0 \| 38 \| 0 \| 38 \|
	\| 10 \| 0 \| 0 \| 0 \| 60 \| 0 \| 60 \|
	\| 11 \| 0 \| 0 \| 0 \| 33 \| 0 \| 47 \|
	\| 12 \| 0 \| 0 \| 0 \| 66 \| 0 \| 91 \|
	\| 13 \| 0 \| 0 \| 0 \| 193 \| 0 \| 194 \|
	\| 14 \| 0 \| 0 \| 0 \| 154 \| 0 \| 154 \|
	\| 15 \| 0 \| 0 \| 0 \| 4 \| 0 \| 4 \|

	### desync0/lmic_tsbn_small

	\| Byte \| Final Rank \| Rank@500 \| Rank@1000 \| Pre-Rank \| Min Rank \| Max Rank \|
	\|------\|-----------\|----------\|-----------\|----------\|----------\|----------\|
	\| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 1 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 2 \| 0 \| 0 \| 0 \| 235 \| 0 \| 235 \|
	\| 3 \| 0 \| 0 \| 0 \| 228 \| 0 \| 228 \|
	\| 4 \| 0 \| 0 \| 0 \| 14 \| 0 \| 14 \|
	\| 5 \| 0 \| 0 \| 0 \| 20 \| 0 \| 57 \|
	\| 6 \| 0 \| 0 \| 0 \| 35 \| 0 \| 44 \|
	\| 7 \| 0 \| 0 \| 0 \| 7 \| 0 \| 7 \|
	\| 8 \| 0 \| 0 \| 0 \| 63 \| 0 \| 63 \|
	\| 9 \| 0 \| 0 \| 0 \| 14 \| 0 \| 14 \|
	\| 10 \| 0 \| 0 \| 0 \| 98 \| 0 \| 98 \|
	\| 11 \| 0 \| 0 \| 0 \| 57 \| 0 \| 89 \|
	\| 12 \| 0 \| 0 \| 0 \| 41 \| 0 \| 53 \|
	\| 13 \| 0 \| 0 \| 0 \| 209 \| 0 \| 209 \|
	\| 14 \| 0 \| 0 \| 0 \| 153 \| 0 \| 153 \|
	\| 15 \| 0 \| 0 \| 0 \| 1 \| 0 \| 1 \|

	### desync0/mtan_lite

	\| Byte \| Final Rank \| Rank@500 \| Rank@1000 \| Pre-Rank \| Min Rank \| Max Rank \|
	\|------\|-----------\|----------\|-----------\|----------\|----------\|----------\|
	\| 0 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 1 \| 0 \| 0 \| ? \| ? \| 0 \| ? \|
	\| 2 \| 84 \| 73 \| ? \| ? \| 2 \| ? \|
	\| 3 \| 246 \| 72 \| ? \| ? \| 2 \| ? \|
	\| 4 \| 125 \| 61 \| ? \| ? \| 27 \| ? \|
	\| 5 \| 19 \| 120 \| ? \| ? \| 19 \| ? \|
	\| 6 \| 98 \| 126 \| ? \| ? \| 26 \| ? \|
	\| 7 \| 36 \| 3 \| ? \| ? \| 2 \| ? \|
	\| 8 \| 101 \| 227 \| ? \| ? \| 23 \| ? \|
	\| 9 \| 19 \| 45 \| ? \| ? \| 2 \| ? \|
	\| 10 \| 245 \| 216 \| ? \| ? \| 101 \| ? \|
	\| 11 \| 199 \| 205 \| ? \| ? \| 13 \| ? \|
	\| 12 \| 37 \| 201 \| ? \| ? \| 28 \| ? \|
	\| 13 \| 24 \| 180 \| ? \| ? \| 17 \| ? \|
	\| 14 \| 26 \| 20 \| ? \| ? \| 10 \| ? \|
	\| 15 \| 7 \| 0 \| ? \| ? \| 0 \| ? \|

	### desync50/lmic_tsbn

	\| Byte \| Final Rank \| Rank@500 \| Rank@1000 \| Pre-Rank \| Min Rank \| Max Rank \|
	\|------\|-----------\|----------\|-----------\|----------\|----------\|----------\|
	\| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 1 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 2 \| 0 \| 0 \| 0 \| 179 \| 0 \| 179 \|
	\| 3 \| 0 \| 0 \| 0 \| 238 \| 0 \| 238 \|
	\| 4 \| 0 \| 0 \| 0 \| 5 \| 0 \| 5 \|
	\| 5 \| 0 \| 0 \| 0 \| 16 \| 0 \| 16 \|
	\| 6 \| 0 \| 0 \| 0 \| 31 \| 0 \| 36 \|
	\| 7 \| 0 \| 0 \| 0 \| 8 \| 0 \| 8 \|
	\| 8 \| 0 \| 0 \| 0 \| 72 \| 0 \| 72 \|
	\| 9 \| 0 \| 0 \| 0 \| 23 \| 0 \| 23 \|
	\| 10 \| 0 \| 0 \| 0 \| 86 \| 0 \| 86 \|
	\| 11 \| 0 \| 0 \| 0 \| 80 \| 0 \| 93 \|
	\| 12 \| 0 \| 0 \| 0 \| 42 \| 0 \| 52 \|
	\| 13 \| 0 \| 0 \| 0 \| 201 \| 0 \| 202 \|
	\| 14 \| 0 \| 0 \| 0 \| 151 \| 0 \| 151 \|
	\| 15 \| 0 \| 0 \| 0 \| 1 \| 0 \| 1 \|

	### desync100/lmic_tsbn

	\| Byte \| Final Rank \| Rank@500 \| Rank@1000 \| Pre-Rank \| Min Rank \| Max Rank \|
	\|------\|-----------\|----------\|-----------\|----------\|----------\|----------\|
	\| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 1 \| 0 \| 0 \| 0 \| 0 \| 0 \| 0 \|
	\| 2 \| 0 \| 0 \| 0 \| 224 \| 0 \| 224 \|
	\| 3 \| 0 \| 0 \| 0 \| 241 \| 0 \| 241 \|
	\| 4 \| 0 \| 0 \| 0 \| 2 \| 0 \| 3 \|
	\| 5 \| 0 \| 0 \| 0 \| 14 \| 0 \| 14 \|
	\| 6 \| 0 \| 0 \| 0 \| 36 \| 0 \| 47 \|
	\| 7 \| 0 \| 0 \| 0 \| 10 \| 0 \| 10 \|
	\| 8 \| 0 \| 0 \| 0 \| 61 \| 0 \| 61 \|
	\| 9 \| 0 \| 0 \| 0 \| 54 \| 0 \| 54 \|
	\| 10 \| 0 \| 0 \| 0 \| 94 \| 0 \| 95 \|
	\| 11 \| 0 \| 0 \| 0 \| 80 \| 0 \| 82 \|
	\| 12 \| 0 \| 0 \| 0 \| 45 \| 0 \| 48 \|
	\| 13 \| 0 \| 0 \| 0 \| 188 \| 0 \| 214 \|
	\| 14 \| 0 \| 0 \| 0 \| 129 \| 0 \| 129 \|
	\| 15 \| 0 \| 0 \| 0 \| 2 \| 0 \| 2 \|

	## Additional Content

	\| Directory \| Description \|
	\|-----------\|-------------\|
	\| `analysis/` \| Research analysis: figures, findings, reports, scripts (28 files) \|
	\| `figures/` \| Report figures (14 files) \|
	\| `report_v4.pdf` \| Research report (PDF) \|
	\| `report_v4.tex` \| Research report (LaTeX source) \|

	## Training Coverage Matrix

	This table shows which model/desync combinations have been trained.

	\| Variant \| desync0 \| desync50 \| desync100 \|
	\|---------\|--------\|\|--------\|\|--------\|
	\| cnn \| 1 bytes \| 1 bytes \| 1 bytes \|
	\| hps \| 2/16 \| MISSING \| MISSING \|
	\| lmic \| 15/16 \| MISSING \| MISSING \|
	\| lmic_tsbn \| 16/16 \| 16/16 \| 16/16 \|
	\| lmic_tsbn_no_cosine \| 16/16 \| MISSING \| MISSING \|
	\| lmic_tsbn_no_dtp \| 16/16 \| MISSING \| MISSING \|
	\| lmic_tsbn_no_sd \| 16/16 \| MISSING \| MISSING \|
	\| lmic_tsbn_small \| 16/16 \| MISSING \| MISSING \|
	\| mlp \| 1 bytes \| 1 bytes \| 1 bytes \|
	\| mtan_lite \| 2/16 \| MISSING \| MISSING \|