Metadata-Version: 2.4
Name: emrass-world-model
Version: 0.1.0
Summary: A lightweight simulation library for wireless sensing and electromagnetic world modeling.
Author-email: RASS <support@rassaidigital.com>
Project-URL: Source, https://github.com/GitAhubI-Lover/emrass-world-model
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20.0
Dynamic: license-file

# emrass-world-model 📡

[![PyPI version](https://img.shields.io/pypi/v/em-world-model.svg)](https://pypi.org/project/emrass-world-model/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

**em-world-model** is a lightweight electromagnetic world modeling and simulation library designed for **Embodied AI** and **6G communications**. It aims to bridge the gap between traditional visual perception and physical-layer EM simulation, providing AI agents with an "Electromagnetic Perspective" for environment understanding.

---

## 🌟 Key Features

* **Physics-Based Simulation Engine**: Built-in models for Free Space Path Loss (FSPL), Two-Ray Ground Reflection, and complex Multipath Fading.
* **Environmental Semantic Modeling**: Supports EM scattering and reflection profiling for common materials such as concrete, glass, and metal.
* **ISAC Integration**: Supports preliminary simulations for **Integrated Sensing and Communication**, enabling joint waveform and perception analysis.
* **Lightweight & Scalable**: Minimal dependencies (NumPy based), making it easy to integrate into Reinforcement Learning (RL) environments or autonomous driving simulators like CARLA or AirSim.



---

## 🚀 Quick Start

### Installation

Install the stable version from PyPI:

```bash
pip install emrass-world-model

Basic Usage: Calculating Path Loss
from em_model.physics import free_space_path_loss

# Parameters: distance (meters), frequency (Hz)
distance = 150 
frequency = 28e9  # 28 GHz mmWave

loss = free_space_path_loss(distance, frequency)
print(f"Path loss at {distance}m: {loss:.2f} dB")
