# labsir-un/frm_lab_0_intro_software architecture

> Architecture diagram of the GitHub repository labsir-un/frm_lab_0_intro_software, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/labsir-un/frm_lab_0_intro_software
- Repository: https://github.com/labsir-un/frm_lab_0_intro_software

## Overview

##### Project type and purpose
- This is not a standard “app” or microservice ecosystem, but an educational documentation repository (“Guía 0”) for a Mobile Robotics Fundamentals course.
- It bundles installation guides, resource files, and example scripts for key tools: Ubuntu, MATLAB (with Peter Corke’s Toolbox), CoppeliaSim, ROS, plus auxiliary developer tools (Git, VS Code, Markdown, LeoCAD, Terminal).

##### File structure
- Top‑level:
- README.md – central course overview and ToC
- LICENSE
- Archivos/… – contains subfolders per tool:
– Ubuntu (installation methods)
– Matlab (install guide + “Simulation Robot Móviles” scripts)
– Toolbox_RCV (Peter Corke Toolbox installation + example .m/.mlx scripts)
– CoppeliaSim (install guide + MATLAB–CoppeliaSim integration guides + helper scripts)
– ROS (install guide)
– Herramientas (Git, Terminal, Markdown, VS Code, LeoCAD recommendations)

##### README for additional insights
- The README describes the learning objectives: install/configure tools, simulate, develop robotics algorithms.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User and Repository
    subgraph "User & Repository"
        User["User (Student/Developer)"]:::external
        Repo["GitHub Repository"]:::external
    end
    User -->|"clones via Git/Terminal"| Repo
    Repo -->|"opens in VS Code"| VSCode

    %% Layer 1: OS Foundation
    subgraph "Layer 1: OS Foundation"
        OS["Ubuntu 20.04"]:::os
    end

    %% Layer 2: Core Software
    subgraph "Layer 2: Core Software"
        MATLAB["MATLAB"]:::core
        Toolbox["Toolbox_RCV (Peter Corke)"]:::core
        Simulator["CoppeliaSim"]:::core
        ROS["ROS Noetic"]:::core
    end

    %% Layer 3: Educational Resources
    subgraph "Layer 3: Educational Resources"
        MATLABScripts["MATLAB scripts"]:::resource
        CoppeliaScripts["MATLAB-CoppeliaSim integration scripts"]:::resource
        Guides["Installation guides & manuals"]:::resource
    end

    %% Cross-Cutting Developer Tools
    subgraph "Cross-Cutting Developer Tools"
        Git["Git"]:::tools
        Terminal["Terminal"]:::tools
        Markdown["Markdown"]:::tools
        VSCode["Visual Studio Code"]:::tools
        LeoCAD["LeoCAD"]:::tools
    end

    %% Dependencies and Integrations
    OS -->|"requires"| MATLAB
    OS -->|"requires"| ROS
    OS -->|"requires"| Simulator
    MATLAB -->|"augmented by"| Toolbox
    MATLAB -->|"uses scripts"| MATLABScripts
    MATLAB -->|"integrates with"| CoppeliaScripts
    Simulator -->|"runs integration scripts"| CoppeliaScripts
    ROS -->|"can integrate with"| Simulator
    Repo -->|"contains"| Guides

    %% Developer Tools Support
    Git -.->|"version control for"| Repo
    Terminal -.->|"cli access for"| Repo
    VSCode -.->|"edit and view"| Guides
    VSCode -.->|"edit and debug"| MATLABScripts
    VSCode -.->|"edit and debug"| CoppeliaScripts
    Markdown -.->|"write docs in"| Guides
    LeoCAD -.->|"design models for"| Guides

    %% Click Events
    click OS "https://github.com/labsir-un/frm_lab_0_intro_software/tree/main/Archivos/Ubuntu"
    click MATLAB "https://github.com/labsir-un/frm_lab_0_intro_software/tree/main/Archivos/Matlab"
    click Toolbox "https://github.com/labsir-un/frm_lab_0_intro_software/tree/main/Archivos/Toolbox_RCV"
    click Simulator "https://github.com/labsir-un/frm_lab_0_intro_software/tree/main/Archivos/CoppeliaSim"
    click ROS "https://github.com/labsir-un/frm_lab_0_intro_software/tree/main/Archivos/ROS"
    click Git "https://github.com/labsir-un/frm_lab_0_intro_software/tree/main/Archivos/Herramientas/Git"
    click Terminal "https://github.com/labsir-un/frm_lab_0_intro_software/tree/main/Archivos/Herramientas/Terminal"
    click Markdown "https://github.com/labsir-un/frm_lab_0_intro_software/tree/main/Archivos/Herramientas/Markdown"
    click VSCode "https://github.com/labsir-un/frm_lab_0_intro_software/tree/main/Archivos/Herramientas/Visual Studio Code"
    click LeoCAD "https://github.com/labsir-un/frm_lab_0_intro_software/tree/main/Archivos/Herramientas/LeoCAD"

    %% Styles
    classDef os fill:#d3d3d3,stroke:#333,stroke-width:2px;
    classDef core fill:#add8e6,stroke:#333,stroke-width:2px;
    classDef resource fill:#90ee90,stroke:#333,stroke-width:2px;
    classDef tools fill:#ffa500,stroke:#333,stroke-width:2px;
    classDef external fill:#eeeeee,stroke:#333,stroke-width:2px;
```
