# randomness00/space-time-prism architecture

> Architecture diagram of the GitHub repository randomness00/space-time-prism, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/randomness00/space-time-prism
- Repository: https://github.com/randomness00/space-time-prism

## Overview

##### File structure
- 3D_space_time_prism.py
- Likely contains the core algorithm to build a 3D space-time prism from origin/destination and time constraints.
- getpoints.py
- Presumably reads or generates point data (e.g., waypoints, POIs) to feed into the prism calculation.
- carpool_feasibility.py
- Builds on the prism results to evaluate if two or more trajectories overlap in space and time for ride-sharing feasibility.
- README.md
- Minimal; confirms project name.

There are no subdirectories, no explicit test folder, and no config or dependency files. This suggests a simple, linear pipeline of scripts.

##### README for additional insights
- The README only gives the project title. No further details on inputs, outputs, or dependencies—so we infer them by script names and domain conventions (likely reading CSV/JSON, using numpy or shapely, etc.).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Sources
    RawData["Raw Data (CSV/JSON)"]:::ingestion
    TimeConstraints["Time Constraints"]:::ingestion

    %% Processing Modules
    getpoints["getpoints.py\n(Extract Points)"]:::ingestion
    PrismBuilder["3D_space_time_prism.py\n(Prism Builder)"]:::computation
    CarpoolAnalyzer["carpool_feasibility.py\n(Carpool Analyzer)"]:::analysis

    %% Outputs
    PrismOutput["Prism Geometry\n(GeoJSON)"]:::computation
    ReportOutput["Feasibility Report\n(Metrics)"]:::analysis

    %% Documentation
    README["README.md\n(Project Documentation)"]:::documentation

    %% Flow
    RawData -->|"CSV/JSON"| getpoints
    TimeConstraints -->|"time params"| getpoints
    getpoints -->|"Points DataFrame"| PrismBuilder
    PrismBuilder -->|"3D GeoJSON"| CarpoolAnalyzer
    CarpoolAnalyzer -->|"Report Metrics"| ReportOutput
    PrismBuilder -->|"Prism Geometry"| PrismOutput

    %% Click Events
    click getpoints "https://github.com/randomness00/space-time-prism/blob/main/getpoints.py"
    click PrismBuilder "https://github.com/randomness00/space-time-prism/blob/main/3D_space_time_prism.py"
    click CarpoolAnalyzer "https://github.com/randomness00/space-time-prism/blob/main/carpool_feasibility.py"
    click README "https://github.com/randomness00/space-time-prism/blob/main/README.md"

    %% Styles
    classDef ingestion fill:#add8e6,stroke:#333,stroke-width:1px
    classDef computation fill:#90ee90,stroke:#333,stroke-width:1px
    classDef analysis fill:#ffa500,stroke:#333,stroke-width:1px
    classDef documentation fill:#d3d3d3,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
```
