:orphan:

Data Center Configuration
=========================

The data-center repository contains configuration files for the CCAT data center,
including instrument definitions, observation modes, users, roles, and data transfer routes.

Configuration Structure
-----------------------

The data-center repository is organized into the following directories:

**Instruments & Observations**
  * ``instruments/`` - Instrument definitions (TOML format)
  * ``obs_modes/`` - Observation modes for different instruments
  * ``lines/`` - Spectral line definitions
  * ``obs_units/`` - Observation unit configurations

**Data Transfer**
  * ``data_transfer_routes/`` - Data transfer route configurations for development, staging, and production
  * ``files/`` - File type definitions and test files

**Observatory**
  * ``observatory/`` - Observatory configuration (CCAT.toml)
  * ``telescope/`` - Telescope parameters
  * ``sites/`` - Site definitions

**Users & Access**
  * ``users/`` - User definitions
  * ``roles/`` - Role-based access control definitions
  * ``observing_programs/`` - Observing program definitions

**Workflows**
  * ``workflows/`` - Documentation of data center workflows

Configuration File Format
-------------------------

Most configuration files in this repository use TOML format, which provides a
human-readable and easy-to-edit structure for defining hierarchical data.

Example instrument definition:

.. code-block:: toml

   [instrument]
   name = "FYST"
   description = "First Year Survey Telescope"
   type = "bolometer_array"

For detailed information about specific configurations, refer to the README.md
files in each subdirectory.