How ando-khachatryan/hidden works
Project type and purpose
• This is a deep‑learning research codebase (“HiDDeN”), implemented in Python/PyTorch.
• Its goal is to train and evaluate an encoder–noise–decoder pipeline that hides and recovers data in images under various distortions.
File structure
• Top‑level scripts:
• main.py (entry point; CLI for “new” or “continue” experiments)
• train.py / validate‑trained‑models.py / test_model.py (training, validation, testing)
• noise_argparser.py / options.py (argument parsing and experiment configuration)
• Core logic:
• model/ (encoder, decoder, discriminator submodules, conv_bn_relu layers)
• noise_layers/ (crop, cropout, dropout, jpeg_compression, resize, quantization, identity, noiser)
• vgg_loss.py (perceptual loss)
• Utilities:
• utils.py, average_meter.py (metrics aggregation), tensorboard_logger.py
• Experiments & outputs:
• experiments/ (per‑experiment checkpoints, CSV logs, images, tensorboard events)
• runfiles/ (.sh scripts to launch runs)
• Configuration & environment:
• requirements via README (PyTorch, TorchVision, TensorboardX)
README for additional insights
• Describes the high‑level pipeline: watermark image via encoder → apply stochastic noise layer(s) → decode hidden bits
• Experiment management: runs in ./runs/<name‑timestamp> and summaries under ./experiments
Detail without over‑splitting
• Noise layer category as a single “Noise Layer” module with an annotation “select one at random per batch”