How hazardsnow/deepcore-ai works
DeepCore is a student-facing AI search assignment about rescuing miners in a mine. The main workflow is to choose a built-in or custom map and algorithm, construct the search environment, run a search, and inspect its solution and metrics in the CLI or graphical workbench. The runtime also supports heuristic comparisons and benchmark tables. The source excerpts establish the main dispatch and search/environment responsibilities; detailed wiring inside unsampled portions of the GUI and algorithms is not expanded.
Main entry points: __main__.py CLI and GUI dispatcher · environment.py Mine environment · state.py State and metrics · solver.py Heuristic searches
Components 13
Entry and orchestration
- Root launcher
main.py - CLI and GUI dispatcher
src/deepcore/__main__.py
Search problem model
- Mine environment
src/deepcore/environment.py - State and metrics
src/deepcore/state.py
Search and presentation
- Uninformed searches
src/deepcore/solver.py - Bidirectional search
src/deepcore/solver.py - Cost-based searches
src/deepcore/solver.py - Heuristic searches
src/deepcore/solver.py - Heuristic functions
src/deepcore/heuristics.py - Solution verification
src/deepcore/__main__.py - Benchmark runner
src/deepcore/__main__.py - Graphical workbench
src/deepcore/visualizer.py
Other components
- Student
Connections 26
- Student → Root launcher: starts app
README.md - Root launcher → CLI and GUI dispatcher: forwards CLI
main.py - Root launcher → Mine environment: loads demo map
main.py - CLI and GUI dispatcher → Mine environment: loads map
src/deepcore/__main__.py - CLI and GUI dispatcher → Uninformed searches: dispatches search
src/deepcore/__main__.py - CLI and GUI dispatcher → Bidirectional search: dispatches search
src/deepcore/__main__.py - CLI and GUI dispatcher → Cost-based searches: dispatches search
src/deepcore/__main__.py - CLI and GUI dispatcher → Heuristic searches: dispatches search
src/deepcore/__main__.py - CLI and GUI dispatcher → Heuristic functions: registers functions
src/deepcore/__main__.py - CLI and GUI dispatcher → Solution verification: verifies solution
src/deepcore/__main__.py - CLI and GUI dispatcher → Benchmark runner: runs suite
src/deepcore/__main__.py - CLI and GUI dispatcher → Graphical workbench: opens GUI
src/deepcore/__main__.py - Uninformed searches → Mine environment: requests successors
src/deepcore/solver.py - Bidirectional search → Mine environment: requests predecessors
src/deepcore/solver.py - Cost-based searches → Mine environment: requests successors
src/deepcore/solver.py - Heuristic searches → Mine environment: requests successors
src/deepcore/solver.py - Heuristic searches → Heuristic functions: evaluates states
src/deepcore/__main__.py - Mine environment → State and metrics: creates states
src/deepcore/environment.py - Uninformed searches → State and metrics: returns metrics
src/deepcore/solver.py - Bidirectional search → State and metrics: returns metrics
src/deepcore/solver.py - Cost-based searches → State and metrics: returns metrics
src/deepcore/solver.py - Heuristic searches → State and metrics: returns metrics
src/deepcore/solver.py - Solution verification → Mine environment: replays actions
src/deepcore/__main__.py - Graphical workbench → Mine environment: renders map
src/deepcore/visualizer.py - Graphical workbench → CLI and GUI dispatcher: invokes runner
src/deepcore/visualizer.py - Graphical workbench → State and metrics: displays metrics
src/deepcore/visualizer.py