Skip to main content

Python Library for Multipath Ray Tracing

Project description

MURT

Multipath Radio Tracer (MURT) is a ray-tracing engine for multipath propagation of radio waves. MURT is a Python package with the ray-tracing core engine implemented in Python C++ Extension. The package also includes utility tools such as the visualizer, path loss calculator, and the scene generator.


Installations

MURT can be installed by pip, however, numpy is required before the installation.

! The pip installation only works with Linux and MacOS for the moment.

pip install murt

the development version can be built via the github repository and Make.

git clone https:/github.com/tamsri/murt
cd murt
make all

Examples

1. Call tracing engine.

The core engine reads the triangulated obj files and process the triangles into the engine.

from murt import Tracer

# Scene File Path in obj
SCENE_FILE_PATH = "scene_file_path.obj"

# Initialize Tracer
my_tracer = Tracer(SCENE_FILE_PATH)
# Set transmitting position
tx_pos = [ 0, 15, 0]
# Set receiving position
rx_pos = [-30, 1.5, 45]

# Return the traced paths
result = my_tracer.trace(tx_pos, rx_pos)
# [(2, [(-19.24, 8.56, 28.86)]),
#  (3, (-28.94, 4.22, 62.39)),
#  (3, (-70.80, 7.04, 15.22))]

The result is the list of traced paths. The first position of the tuple indicates types of the paths (1 - direct path, 2 - diffracted path, 3 - reflected path). The second position of the tuple is the detail of the traced paths.

2. Calculate Path Loss.

As the possible paths are traced from the engine. the results from the tracer can be used to

tx_freq = 2.4e9 # 2.4 GHz

scene_permittivity = 5.3 # Concrete's

result = [(2, [(-19.24, 8.56, 28.86)]),
 (3, (-28.94, 4.22, 62.39)),
 (3, (-70.80, 7.04, 15.22))]

losses = my_tracer.get_total_loss(
 tx_pos, rx_pos, result, tx_freq, scene_permittivity)
# {'total_dB': 84.3, 'signals': [[95.50, 1.86e-07], [86.63, 2.91e-07], [89.27, 4.12e-07]]}

The tracer calculates the total path loss according to the theoretical propagation models. In this example, the scene material is considered to be concrete.

3. Visualizing traced paths.

To visualize the traced path, MURT package provides a window to display the scene and the paths by filling the information of the paths into the window's lines_set.

from murt import Tracer
from murt.window import Window
SCENE_FILE_PATH = "scene_file_path.obj"

# load window and scene
my_window = Window()
my_window.load_scene(SCENE_FILE_PATH)

# result from the previous example.
tx_pos = [ 0, 15, 0]
rx_pos = [-30, 1.5, 45]
result = [(2, [(-19.24, 8.56, 28.86)]),
 (3, (-28.94, 4.22, 62.39)),
 (3, (-70.80, 7.04, 15.22))]

# convert results to visualised paths
my_window.lines_set += Tracer.result_to_lines(result, tx_pos, rx_pos)

# run
my_window.run()

The scene can be rotated by click and drag. the result can be shown below.

Example Image

3. Randomly Generate the Scene

MURT also provides an example of application to procedurally generate the scenes for testing the traced paths from the engine. The application can be directly called from murt.apps.

from murt.apps import randomer

RANDOM_SEED = 5555
a = randomer(RANDOM_SEED)
a.run()

The scene can be regenerated by pressing the G button.

Example Image


License

© Supawat Tamsri MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

murt-0.0.5.tar.gz (9.9 MB view details)

Uploaded Source

Built Distribution

murt-0.0.5-cp38-cp38-macosx_10_9_x86_64.whl (66.3 kB view details)

Uploaded CPython 3.8 macOS 10.9+ x86-64

File details

Details for the file murt-0.0.5.tar.gz.

File metadata

  • Download URL: murt-0.0.5.tar.gz
  • Upload date:
  • Size: 9.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.8.8

File hashes

Hashes for murt-0.0.5.tar.gz
Algorithm Hash digest
SHA256 09d4d547f08fb3bb54fb949e151b34ea02cec63e5b8693044af9320db1aa4da2
MD5 9f29272ad30368ae616921dc995cc088
BLAKE2b-256 5d17c2d2b056f165dc2bb5582f4d28f5223a89de833f06f042004f553a80a7ea

See more details on using hashes here.

File details

Details for the file murt-0.0.5-cp38-cp38-macosx_10_9_x86_64.whl.

File metadata

  • Download URL: murt-0.0.5-cp38-cp38-macosx_10_9_x86_64.whl
  • Upload date:
  • Size: 66.3 kB
  • Tags: CPython 3.8, macOS 10.9+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.8.8

File hashes

Hashes for murt-0.0.5-cp38-cp38-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 0bd6db8f9b2911349544fdedad4255df071d09f42e59eca6f03d82cdb3bf1fff
MD5 be44c14275e972f2cc8bf1d3d8c9dc6f
BLAKE2b-256 aaa265b14388e97ca94d24690af4ff49903cc002adc4c46e81571ecbc476a89b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page