Upload 5 files
Browse files- README.md +37 -0
- analysis.md +54 -0
- config.json +16 -0
- model.safetensors +3 -0
- training_args.json +9 -0
README.md
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: cc-by-4.0
|
| 3 |
+
tags:
|
| 4 |
+
- research-notes
|
| 5 |
+
- image-captioning
|
| 6 |
+
---
|
| 7 |
+
|
| 8 |
+
# Notes on Image Captioning
|
| 9 |
+
|
| 10 |
+
## Repository summary
|
| 11 |
+
|
| 12 |
+
Reading notes and an experiment sketch for **Image Captioning**. The repository emphasizes what still needs to be tested instead of manufacturing scores or release claims.
|
| 13 |
+
|
| 14 |
+
## What is covered
|
| 15 |
+
|
| 16 |
+
- the scope of the research question and likely confounders
|
| 17 |
+
- a proposed comparison with matched baselines
|
| 18 |
+
- concrete evaluation context such as MS COCO Captions, NoCaps, and TextCaps
|
| 19 |
+
- reproducibility checks, failure modes, and open questions
|
| 20 |
+
- topic-relevant references
|
| 21 |
+
|
| 22 |
+
## How to read this repository
|
| 23 |
+
|
| 24 |
+
Start with `analysis.md` for the full note. Sections labeled as plans or hypotheses should not be interpreted as experimental results. If results are added later, they should include dataset versions, commands, seeds, hardware, and raw logs.
|
| 25 |
+
|
| 26 |
+
## Scope and limitations
|
| 27 |
+
|
| 28 |
+
The note is intentionally exploratory. It does not claim benchmark improvements, completed ablations, released code, or a trained checkpoint. References and proposed datasets provide a starting point for verification rather than evidence that the study has already been run.
|
| 29 |
+
|
| 30 |
+
## Files
|
| 31 |
+
|
| 32 |
+
- `analysis.md` — primary artifact
|
| 33 |
+
- `README.md` — this documentation
|
| 34 |
+
|
| 35 |
+
## License
|
| 36 |
+
|
| 37 |
+
Released under **cc-by-4.0**. Review the source-data terms separately when this repository is used with external datasets.
|
analysis.md
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Image Captioning: Research Notes
|
| 2 |
+
|
| 3 |
+
## Status
|
| 4 |
+
|
| 5 |
+
Working note / experiment plan. No completed benchmark results are claimed here.
|
| 6 |
+
|
| 7 |
+
## 1. Scope and motivation
|
| 8 |
+
|
| 9 |
+
The goal of this note is to turn a broad idea into a falsifiable study of faithful generation that mentions visible evidence without hallucinating objects. The central question is whether the proposed change improves the target behavior under a matched training and evaluation budget. The note deliberately separates hypotheses from observations so that future results can be added without rewriting the rationale.
|
| 10 |
+
|
| 11 |
+
## 2. Context
|
| 12 |
+
|
| 13 |
+
Research on image captioning often mixes improvements from architecture, data scale, preprocessing, and compute. A useful comparison therefore needs controlled baselines and explicit reporting of resource use. For this topic, the main confound is that n-gram metrics only partially reflect factuality and usefulness.
|
| 14 |
+
|
| 15 |
+
## 3. Working hypothesis
|
| 16 |
+
|
| 17 |
+
A focused change to the representation or interaction mechanism may improve CIDEr without increasing deployment cost disproportionately. The hypothesis should be rejected if gains disappear after matching parameter count, data exposure, or tuning budget.
|
| 18 |
+
|
| 19 |
+
## 4. Proposed approach
|
| 20 |
+
|
| 21 |
+
The first implementation should keep modality-specific preprocessing simple, project inputs into a shared representation space, and isolate the new component behind a small interface. Baselines should include a comparable model without the component and a stronger off-the-shelf reference. Any optimization should be applied to all systems, not only the proposed one.
|
| 22 |
+
|
| 23 |
+
## 5. Evaluation plan
|
| 24 |
+
|
| 25 |
+
| Dataset | Role | Primary measure |
|
| 26 |
+
|---|---|---|
|
| 27 |
+
| MS COCO Captions | primary evaluation | CIDEr |
|
| 28 |
+
| NoCaps | transfer / robustness | SPICE |
|
| 29 |
+
| TextCaps | transfer / robustness | human preference |
|
| 30 |
+
|
| 31 |
+
Planned comparisons include a matched-capacity baseline, an ablation that removes the proposed component, and an out-of-domain transfer check. Default training values for the first controlled run are learning rate `0.0003`, batch size `16`, and `3` independent seeds. These are planning values, not claims about a finished experiment.
|
| 32 |
+
|
| 33 |
+
## 6. Reproducibility checklist
|
| 34 |
+
|
| 35 |
+
- Fix preprocessing before tuning.
|
| 36 |
+
- Report mean and standard deviation across seeds.
|
| 37 |
+
- Keep a held-out error-analysis split.
|
| 38 |
+
- Record wall-clock time and peak memory.
|
| 39 |
+
|
| 40 |
+
## 7. Failure modes and responsible use
|
| 41 |
+
|
| 42 |
+
The analysis should report subgroup and category-level failures instead of relying only on a single aggregate score. Particular attention is needed because n-gram metrics only partially reflect factuality and usefulness. No production use is recommended without task-specific validation, data review, and an assessment of privacy and bias.
|
| 43 |
+
|
| 44 |
+
## 8. Open questions
|
| 45 |
+
|
| 46 |
+
- Does the proposed component improve calibration as well as the primary metric?
|
| 47 |
+
- How sensitive is the conclusion to preprocessing and random seed?
|
| 48 |
+
- Can a simpler baseline recover the same gain with more careful tuning?
|
| 49 |
+
|
| 50 |
+
## References
|
| 51 |
+
|
| 52 |
+
[1] Chen et al., COCO Captions, 2015.
|
| 53 |
+
[2] Agrawal et al., NoCaps, 2019.
|
| 54 |
+
[3] Sidorov et al., TextCaps, 2020.
|
config.json
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"architectures": [
|
| 3 |
+
"CustomResearchModel"
|
| 4 |
+
],
|
| 5 |
+
"architecture": "transformer",
|
| 6 |
+
"model_type": "transformer",
|
| 7 |
+
"hidden_size": 256,
|
| 8 |
+
"num_hidden_layers": 6,
|
| 9 |
+
"num_attention_heads": 4,
|
| 10 |
+
"intermediate_size": 1024,
|
| 11 |
+
"hidden_act": "gelu",
|
| 12 |
+
"max_position_embeddings": 512,
|
| 13 |
+
"layer_norm_eps": 1e-12,
|
| 14 |
+
"checkpoint_status": "initialization-only",
|
| 15 |
+
"notes": "Untrained checkpoint for smoke tests; no benchmark claim."
|
| 16 |
+
}
|
model.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:fce82238203c1dd954c3c2566b9161bbb3d124921e7de7ad51bec678307ab7c2
|
| 3 |
+
size 132832
|
training_args.json
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"optimizer": "adamw",
|
| 3 |
+
"scheduler": "cosine",
|
| 4 |
+
"learning_rate": 5e-05,
|
| 5 |
+
"batch_size": 16,
|
| 6 |
+
"epochs": 10,
|
| 7 |
+
"seed": 3407,
|
| 8 |
+
"status": "default recipe; not a completed run"
|
| 9 |
+
}
|