# aaryaa-g/ccsdspack architecture

> Architecture diagram of the GitHub repository aaryaa-g/ccsdspack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aaryaa-g/ccsdspack
- Repository: https://github.com/aaryaa-g/ccsdspack

## Overview

CCSDSPack is a C++17 library for building, serializing, parsing, managing, and validating CCSDS Space Packets, including supported PUS-A/PUS-C headers and basic CUC time. The typical application configures a packet and optional secondary header, sets application data, then serializes or parses a bounded packet; Manager extends this to packet streams and reassembly, while Validator reports structural and stream checks. The graph includes the documented CLI tools and raw-buffer API. Edges rely on README statements or indexed source references; unsampled implementation details are not inferred.

Main entry points: [`src/CCSDSPacket.cpp`](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSPacket.cpp) (Packet), [`src/CCSDSDataField.cpp`](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSDataField.cpp) (Packet Data Field), [`src/CCSDSManager.cpp`](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSManager.cpp) (Stream Manager), [`src/PusSecondaryHeaders.cpp`](https://github.com/aaryaa-g/ccsdspack/blob/main/src/PusSecondaryHeaders.cpp) (PUS Headers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_packet_core["Packet Core"]
  node_primary_header["Primary Header<br/>[CCSDSHeader.cpp]"]
  node_data_field["Packet Data Field<br/>[CCSDSDataField.cpp]"]
  node_secondary_interface["Secondary Header API"]
  node_packet["Packet<br/>[CCSDSPacket.cpp]"]
  node_packet_buffer["Raw Buffer API<br/>[CCSDSBuffer.h]"]
  node_result_types["Results and Errors<br/>[CCSDSResult.h]"]
  node_config["Configuration<br/>[CCSDSConfig.cpp]"]
  node_secondary_factory["Header Factories"]
end

subgraph group_pus_time["PUS and Time"]
  node_pus_headers["PUS Headers"]
  node_pus_factory["PUS Factory"]
  node_pus_tailoring["PUS Tailoring<br/>[PusTailoring.cpp]"]
  node_cuc_time["CUC Time<br/>[CCSDSTime.cpp]"]
end

subgraph group_stream_validation["Streams and Validation"]
  node_manager["Stream Manager<br/>[CCSDSManager.cpp]"]
  node_validator["Validator<br/>[CCSDSValidator.cpp]"]
  node_packet_utils["Packet Utilities<br/>[CCSDSUtils.cpp]"]
end

subgraph group_applications["Applications"]
  node_encoder["Encoder CLI<br/>[exec_encoder.cpp]"]
  node_decoder["Decoder CLI<br/>[exec_decoder.cpp]"]
  node_validator_cli["Validator CLI<br/>[exec_validator.cpp]"]
  node_cli_utils["CLI Utilities<br/>[exec_utils.cpp]"]
end

node_application(("Application"))

node_application -->|"builds or parses"| node_packet
node_packet -.->|"owns header"| node_primary_header
node_packet -.->|"owns data field"| node_data_field
node_data_field -->|"manages header"| node_secondary_interface
node_data_field -->|"uses factories"| node_secondary_factory
node_data_field -->|"uses PUS factory"| node_pus_factory
node_pus_factory -->|"creates headers"| node_pus_headers
node_pus_headers -->|"uses tailoring"| node_pus_tailoring
node_pus_headers -->|"encodes timestamps"| node_cuc_time
node_application -->|"manages stream"| node_manager
node_manager -->|"uses packet template"| node_packet
node_manager -->|"configures checks"| node_validator
node_application -->|"validates packet"| node_validator
node_application -->|"parses bounded bytes"| node_packet_buffer
node_packet_buffer -->|"parses packet"| node_packet
node_encoder -->|"uses CLI helpers"| node_cli_utils
node_decoder -->|"uses CLI helpers"| node_cli_utils
node_validator_cli -->|"uses CLI helpers"| node_cli_utils
node_encoder -->|"uses packet API"| node_packet
node_decoder -->|"uses packet API"| node_packet
node_validator_cli -.->|"validates packets"| node_validator
node_packet -->|"returns results"| node_result_types
node_manager -->|"returns results"| node_result_types
node_config -->|"returns results"| node_result_types
node_packet -.->|"loads configuration"| node_config
node_application -.->|"runs tool"| node_encoder
node_application -.->|"runs tool"| node_decoder
node_application -.->|"runs tool"| node_validator_cli

click node_primary_header "https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSHeader.cpp"
click node_data_field "https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSDataField.cpp"
click node_secondary_interface "https://github.com/aaryaa-g/ccsdspack/blob/main/inc/CCSDSSecondaryHeaderAbstract.h"
click node_packet "https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSPacket.cpp"
click node_packet_buffer "https://github.com/aaryaa-g/ccsdspack/blob/main/inc/CCSDSBuffer.h"
click node_result_types "https://github.com/aaryaa-g/ccsdspack/blob/main/inc/CCSDSResult.h"
click node_config "https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSConfig.cpp"
click node_secondary_factory "https://github.com/aaryaa-g/ccsdspack/blob/main/inc/CCSDSSecondaryHeaderFactory.h"
click node_pus_headers "https://github.com/aaryaa-g/ccsdspack/blob/main/src/PusSecondaryHeaders.cpp"
click node_pus_factory "https://github.com/aaryaa-g/ccsdspack/blob/main/src/PusSecondaryHeaderFactory.cpp"
click node_pus_tailoring "https://github.com/aaryaa-g/ccsdspack/blob/main/src/PusTailoring.cpp"
click node_cuc_time "https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSTime.cpp"
click node_manager "https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSManager.cpp"
click node_validator "https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSValidator.cpp"
click node_packet_utils "https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSUtils.cpp"
click node_encoder "https://github.com/aaryaa-g/ccsdspack/blob/main/src/exec_encoder.cpp"
click node_decoder "https://github.com/aaryaa-g/ccsdspack/blob/main/src/exec_decoder.cpp"
click node_validator_cli "https://github.com/aaryaa-g/ccsdspack/blob/main/src/exec_validator.cpp"
click node_cli_utils "https://github.com/aaryaa-g/ccsdspack/blob/main/src/exec_utils.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_primary_header,node_data_field,node_secondary_interface,node_packet,node_packet_buffer,node_result_types,node_config,node_secondary_factory toneBlue
class node_pus_headers,node_pus_factory,node_pus_tailoring,node_cuc_time toneAmber
class node_manager,node_validator,node_packet_utils toneMint
class node_encoder,node_decoder,node_validator_cli,node_cli_utils toneRose
class node_application toneIndigo
```

## Components

### Packet Core

- [Primary Header](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSHeader.cpp): `src/CCSDSHeader.cpp`
- [Packet Data Field](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSDataField.cpp): `src/CCSDSDataField.cpp`
- [Secondary Header API](https://github.com/aaryaa-g/ccsdspack/blob/main/inc/CCSDSSecondaryHeaderAbstract.h): `inc/CCSDSSecondaryHeaderAbstract.h`
- [Packet](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSPacket.cpp): `src/CCSDSPacket.cpp`
- [Raw Buffer API](https://github.com/aaryaa-g/ccsdspack/blob/main/inc/CCSDSBuffer.h): `inc/CCSDSBuffer.h`
- [Results and Errors](https://github.com/aaryaa-g/ccsdspack/blob/main/inc/CCSDSResult.h): `inc/CCSDSResult.h`
- [Configuration](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSConfig.cpp): `src/CCSDSConfig.cpp`
- [Header Factories](https://github.com/aaryaa-g/ccsdspack/blob/main/inc/CCSDSSecondaryHeaderFactory.h): `inc/CCSDSSecondaryHeaderFactory.h`

### PUS and Time

- [PUS Headers](https://github.com/aaryaa-g/ccsdspack/blob/main/src/PusSecondaryHeaders.cpp): `src/PusSecondaryHeaders.cpp`
- [PUS Factory](https://github.com/aaryaa-g/ccsdspack/blob/main/src/PusSecondaryHeaderFactory.cpp): `src/PusSecondaryHeaderFactory.cpp`
- [PUS Tailoring](https://github.com/aaryaa-g/ccsdspack/blob/main/src/PusTailoring.cpp): `src/PusTailoring.cpp`
- [CUC Time](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSTime.cpp): `src/CCSDSTime.cpp`

### Streams and Validation

- [Stream Manager](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSManager.cpp): `src/CCSDSManager.cpp`
- [Validator](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSValidator.cpp): `src/CCSDSValidator.cpp`
- [Packet Utilities](https://github.com/aaryaa-g/ccsdspack/blob/main/src/CCSDSUtils.cpp): `src/CCSDSUtils.cpp`

### Applications

- [Encoder CLI](https://github.com/aaryaa-g/ccsdspack/blob/main/src/exec_encoder.cpp): `src/exec_encoder.cpp`
- [Decoder CLI](https://github.com/aaryaa-g/ccsdspack/blob/main/src/exec_decoder.cpp): `src/exec_decoder.cpp`
- [Validator CLI](https://github.com/aaryaa-g/ccsdspack/blob/main/src/exec_validator.cpp): `src/exec_validator.cpp`
- [CLI Utilities](https://github.com/aaryaa-g/ccsdspack/blob/main/src/exec_utils.cpp): `src/exec_utils.cpp`

### Other components

- **Application**

## Connections

- Application → Packet: builds or parses (evidence: `README.md`)
- Packet → Primary Header: owns header
- Packet → Packet Data Field: owns data field
- Packet Data Field → Secondary Header API: manages header
- Packet Data Field → Header Factories: uses factories
- Packet Data Field → PUS Factory: uses PUS factory
- PUS Factory → PUS Headers: creates headers
- PUS Headers → PUS Tailoring: uses tailoring
- PUS Headers → CUC Time: encodes timestamps
- Application → Stream Manager: manages stream (evidence: `README.md`)
- Stream Manager → Packet: uses packet template
- Stream Manager → Validator: configures checks
- Application → Validator: validates packet (evidence: `README.md`)
- Application → Raw Buffer API: parses bounded bytes (evidence: `README.md`)
- Raw Buffer API → Packet: parses packet (evidence: `inc/CCSDSBuffer.h`)
- Encoder CLI → CLI Utilities: uses CLI helpers (evidence: `src/exec_encoder.cpp`)
- Decoder CLI → CLI Utilities: uses CLI helpers (evidence: `src/exec_decoder.cpp`)
- Validator CLI → CLI Utilities: uses CLI helpers (evidence: `src/exec_validator.cpp`)
- Encoder CLI → Packet: uses packet API (evidence: `src/exec_encoder.cpp`)
- Decoder CLI → Packet: uses packet API (evidence: `src/exec_decoder.cpp`)
- Validator CLI → Validator: validates packets
- Packet → Results and Errors: returns results
- Stream Manager → Results and Errors: returns results
- Configuration → Results and Errors: returns results
- Packet → Configuration: loads configuration
- Application → Encoder CLI: runs tool
- Application → Decoder CLI: runs tool
- Application → Validator CLI: runs tool
