Contents

• 1 Overview

• 2 Basic Usage

• 3 Environment Description

• 4 Materials and Slabs

• 5 Description of Antennas

• 6 Coverage Simulation

• 7 Ray Tracing Simulation

• 8 Handling Agent Mobility

• 9 Other Simulation Examples

• 10 Localization Algorithms

• 11 Measurements Tools

• 12 PyLayers Tools

1 Overview

PyLayers is a site-specific radio propagation channel simulator, curently developed at IETR laboratory in Rennes. It aims at providing a very flexible tool to investigate radio propagation channel for education and research in the field of communications and localization. The current work is mostly focused on investigating 5G cellular concepts.

If you find some interest in this tool and decide to start to use it. You are welcome to contribute your feedback, suggestions and even improvements back to the project. The best place to do it first it in the issues page of the project (https://github.com/pylayers/pylayers/issues)

2 Basic Usage

The basic usage is first to build a description of the radio propagation scene. This means :

1. Describing a propagation environment

2. Setting a Link in specifying a transmitter and a receiver position with ther antennas type and orientation

3. Producing channel outputs

3 Environment Description

• Description of the propagation environment
  • Getting the list of all available Layouts : the ls() method
  • Structure of the .lay file
  • Layout vizualisation
  • Layout bounding box
  • Layout graphs build
  • A more realistic example
  • The useful numpy arrays of the Layout
  • tgs : trancodage from graph indexing to numpy array indexing
• Modifying the segment nature
• Geographical Information and the Earth Zone class : Ezone
  • Zooming in
  • Ground Height Profile Extraction
• Outdoor Coverage Knife-Edge Model

4 Materials and Slabs

• Slabs and Materials
  • Defining a new Slab and a new Material
  • Information necessary to define a Slab
  • Evaluation of a Slab
  • Transmission and Reflexion coefficients
  • Adding new slab and materials
  • Evaluation without phase compensation
  • References

5 Description of Antennas

• Description of antennas
  • Synthesis of the radiation pattern
  • Defining Antenna gain from analytic formulas
• Scalar Spherical Harmonics
• Vector Spherical Harmonics Representation of Antennas
  • Display of the radiation pattern for all frequencies
• Evaluation of Vector Spherical Harmonics Coefficients

6 Coverage Simulation

• Indoor Coverage with the PyLayers Multi Wall model
• Example of Utilisation of Coverage
• Multi-wall model
  • Defining a radio link
  • Ploting the scene
• Coverage class
• Motley Keenan Method Applied on TC1 METIS environment
  • AP1
  • AP2
  • AP3
  • AP4
  • AP5

7 Ray Tracing Simulation

• Ray Signatures
• The transmission channel
  • The Friis factor
  • The tap method
• Sorting and Cutting
• Ray visuzalization

8 Handling Agent Mobility

• Network Simulation Configuration
  • Simulnet.ini
  • Mechanics
• Trajectory and Network simulation
  • Trajectory
• Handling Body Description and Mobility
  • BodyCylinder data structure
  • Description of a body file
  • Example of a Body file
  • Loading a Motion Capture File
  • Defining a trajectory
  • Centering the motion
  • Defining a large scale trajectory
  • Trajectory
  • posvel()
  • Definition of Several Coordinates systems
  • Placing a dcs (Device Coordinate System ) on the cylinder
• Table Of Content
  • CORMORAN Measurement Campaign
• Motivation for creating a specific tool
• Prerequisite Installations
  • The CorSer Class
• Using Pylayers Ray-tracing with CorSer data

9 Other Simulation Examples

• TC1 METIS Scenario
  • ??Introduction
• Test Case 1: Virtual reality office
• Deployment considerations
  • Parameters of AP files
• Scenario of TC 1
• Propagation model (Environment and Link Topology)
• Material Validation
• Path Gain Simulation
• Saving the Grid File
• Simulation
• Reading TC1_METIS layout
• Vizualisation of the Layout
• Displaying Subsegments of the Layout
• Building associated graphs
  • Graph of structure
  • Topological graph
  • Visibility Graph
  • Graph of interactions
• Defining AP and UEs
• Plotting the LOS
• Multi-wall Model: Motley Kennan Model
• Antenna Description
  • Polar Representation

10 Localization Algorithms

11 Measurements Tools

12 PyLayers Tools

• Handling time and frequency domain signals : Bsignal Class
  • FHsignal in CIR mode
• Modelisation of the Thermal Noise