Skip to content

Conventions

This document details the key conventions used in DeepMIMO.

Cartesian Coordinate System

The coordinate system follows:

  • Origin (0,0,0) is typically at the center of the ground plane
  • X and Y axes lie in the ground plane
  • Z axis points upward
  • Ground plane is at z=0
  • Buildings and structures have positive z coordinates
  • Ground plane is modeled as infinitesimally thin

Angle Conventions

Angles follow the spherical system conventions, see Spherical Coordinate System.

Additionally, all angles are in degrees (not radians)

  • Azimuth angle (φ):
  • 0° points along positive x-axis
  • Increases counter-clockwise (looking from above, right-hand rule) in x-y plane
  • Range: [0°, 360°)

  • Elevation angle (θ):

  • 0° points along positive z-axis
  • 90° is in x-y plane
  • Range: [0°, 180°)

Array Elements and Channel Indexing

When specifying array dimensions, elements are indexed and grow as follows:

  • For 2D arrays, elements grow first along X (horizontal) then Y (vertical)
  • Channel matrices use a flattened representation of the array elements
  • For an MxN array, element (i,j) maps to index i*N + j in the flattened channel

Array element indexing convention