How saashajoshi/piqture works
piQture is a Python quantum machine-learning toolkit for image processing. Its documented user workflow loads and transforms MNIST images, encodes an image into a Qiskit circuit, and lets users compose QCNN layers into a model circuit. Other major branches provide several image encodings, tensor-network circuits, and variational classifiers. The graph keeps those capabilities distinct; unsampled implementations are represented only at paths supported by the repository tree, and edges are limited to documented workflow steps or references shown in the source index.
Main entry points: qcnn.py QCNN composer · two_qubit_unitary.py Two-qubit unitaries · base_layer.py Layer base · image_embeddings Image encodings
Components 23
Image data
- MNIST loader
piqture/data_loader/mnist_data_loader.py - Image transforms
piqture/transforms/transforms.py
Image encoding
- Embedding base
piqture/embeddings/image_embedding.py - Angle encoding
piqture/embeddings/angle_encoding.py - Amplitude encoding
piqture/embeddings/amplitude_encoder.py - Image encodings
piqture/embeddings/image_embeddings - Image embedding mixin
piqture/mixin/image_embedding_mixin.py
Quantum models
- QCNN composer
piqture/neural_networks/qcnn.py - QNN base
piqture/neural_networks/quantum_neural_network.py - Layer base
piqture/neural_networks/layers/base_layer.py - Convolution layer
piqture/neural_networks/layers/convolutional_layer.py - Pooling layers
piqture/neural_networks/layers/pooling_layer.py - Fully connected layer
piqture/neural_networks/layers/fully_connected_layer.py - Quantum autoencoder
piqture/neural_networks/quantum_autoencoder.py - Variational classifiers
piqture/variational_classifiers
Tensor networks
- Tensor network base
piqture/tensor_networks/base_tensor_network.py - MERA
piqture/tensor_networks/mera.py - MPS
piqture/tensor_networks/mps.py - PEPS
piqture/tensor_networks/peps.py - TTN
piqture/tensor_networks/ttn.py
Circuit foundations
- Two-qubit unitaries
piqture/gates/two_qubit_unitary.py - Unitary block interface
piqture/gates/unitary_block.py
Other components
- User
Connections 25
- User → MNIST loader: loads images
README.md - MNIST loader → Image transforms: uses transforms
piqture/data_loader/mnist_data_loader.py - User → Image encodings: encodes image
README.md - Image encodings → Embedding base: extends base
piqture/embeddings/image_embeddings/neqr.py - Image encodings → Image embedding mixin: uses mixin
piqture/embeddings/image_embeddings/neqr.py - Angle encoding → Embedding base: uses base
piqture/embeddings/angle_encoding.py - User → QCNN composer: composes model
README.md - QCNN composer → QNN base: initializes
piqture/neural_networks/qcnn.py - QCNN composer → Layer base: validates layers
piqture/neural_networks/qcnn.py - QCNN composer → Convolution layer: builds layer
- QCNN composer → Pooling layers: builds layer
- QCNN composer → Fully connected layer: builds layer
- Convolution layer → Layer base: inherits from
piqture/neural_networks/layers/convolutional_layer.py - Pooling layers → Layer base: inherits from
piqture/neural_networks/layers/pooling_layer.py - Fully connected layer → Layer base: inherits from
piqture/neural_networks/layers/fully_connected_layer.py - Convolution layer → MERA: uses MERA
piqture/neural_networks/layers/convolutional_layer.py - User → Variational classifiers: selects classifier
- User → Quantum autoencoder: selects model
- MERA → Tensor network base: initializes base
piqture/tensor_networks/mera.py - MPS → Tensor network base: uses base
piqture/tensor_networks/mps.py - TTN → Tensor network base: initializes base
piqture/tensor_networks/ttn.py - MERA → Two-qubit unitaries: uses gates
piqture/tensor_networks/mera.py - MPS → Two-qubit unitaries: uses gates
piqture/tensor_networks/mps.py - TTN → Two-qubit unitaries: uses gates
piqture/tensor_networks/ttn.py - Two-qubit unitaries → Unitary block interface: implements interface
piqture/gates/two_qubit_unitary.py