Skip to content

Conversation

@aarontrowbridge
Copy link
Member

This pull request reorganizes and refactors the module structure of the codebase to improve clarity and maintainability. The main changes include renaming and restructuring several submodules and files, consolidating visualization code, and updating include paths to reflect the new organization.

Module and File Structure Refactoring:

  • Refactored file and module names in src/control/_control.jl for improved clarity and consistency (e.g., piccolo_options.jloptions.jl, quantum_control_problem.jlproblems.jl, problem_templates/_problem_templates.jltemplates/_problem_templates.jl, etc.).
  • Updated includes and module usage in src/quantum/_quantum.jl to group related functionality (e.g., primitives, operators, systems, dynamics, templates) into dedicated subfolders, improving logical separation and dependency management.

Visualization Code Consolidation:

  • Removed the PPlots module and consolidated all visualization-related code under a new Visualizations module, updating includes and usage accordingly in src/Piccolo.jl. [1] [2]

These changes should make the codebase easier to navigate and maintain, with clearer boundaries between different functional areas.

aarontrowbridge and others added 2 commits January 27, 2026 00:45
Major structural changes:
- Grouped quantum primitives (gates, pulses, isomorphisms) into primitives/
- Grouped operators (embedded, lifted, direct_sums) into operators/
- Removed redundant "quantum_" prefixes throughout
- Simplified directory names:
  - quantum_systems/ → systems/
  - quantum_trajectories/ → trajectories/
  - quantum_system_templates/ → templates/
  - problem_templates/ → templates/
- Renamed files for clarity:
  - rollouts.jl → dynamics.jl
  - quantum_control_problem.jl → problems.jl
  - piccolo_options.jl → options.jl
  - animated_plots.jl → animations.jl
  - quantum_toolbox_plots.jl → quantum_toolbox.jl
- Renamed visualizations directories:
  - pplots/ → visualizations/
  - quantum_object_plots/ → quantum_objects/

All module dependencies and loading order have been updated and verified.
Package compiles successfully with new structure.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Introduced `SamplingProblem` for robust optimization over multiple system variants.
- Added `SmoothPulseProblem` for piecewise constant control pulses with smooth transitions.
- Created `SplinePulseProblem` for spline-based control pulses, supporting warm-starting.
- Expanded the Control module documentation to include new problem templates and their usage.
- Enhanced the Quantum module documentation with details on systems, trajectories, and pulses.
- Updated the Visualizations module with plotting utilities for analyzing quantum control solutions.
- Added tutorials for beginners and experienced users to facilitate learning Piccolo.jl.
@jack-champagne
Copy link
Member

Looking good, please use docs template to avoid the boilerplate though. ./get_docs_utils.sh and match the file with the right options before it got clobbered @aarontrowbridge

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants