Installation

QuScope can be installed via pip from PyPI or directly from the source code.

📦 From PyPI (Recommended)

pip install quscope

This will install QuScope and all required dependencies.

🔧 Development Installation

For development or to get the latest features:

git clone https://github.com/robertoreis/quantum_algo_microscopy.git
cd quantum_algo_microscopy
pip install -e ".[dev,docs]"

⚙️ Requirements

Python Version - Python >= 3.9

Core Dependencies - qiskit >= 0.45.0 - qiskit-aer >= 0.13.0 - numpy >= 1.21.0 - pillow >= 8.0.0 - scipy >= 1.7.0

Optional Dependencies - matplotlib >= 3.5.0 (for visualization) - jupyter >= 1.0.0 (for notebook examples) - pandas >= 1.3.0 (for data analysis)

🧪 Verify Installation

Test your installation:

import quscope
print(f"QuScope version: {quscope.__version__}")

# Test basic functionality
from quscope import EncodingMethod
print("✅ QuScope installed successfully!")

🐛 Troubleshooting

Common Issues:

1. Qiskit Installation Problems

   If you encounter issues with Qiskit:

   pip install --upgrade qiskit qiskit-aer
   

2. Missing System Dependencies

   On Ubuntu/Debian:

   sudo apt-get update
   sudo apt-get install python3-dev build-essential
   

   On macOS:

   xcode-select --install
   

3. Virtual Environment Issues

   Create a fresh virtual environment:

   python -m venv quscope_env
   source quscope_env/bin/activate  # On Windows: quscope_env\Scripts\activate
   pip install quscope