Features - jjaroztegi/BuildingSignalSimulator GitHub Wiki

Features

🇪🇸 Ver en español

Main Features

1. Signal Level Calculation

Overview

The core functionality of the Building Signal Simulator is calculating signal levels across multiple floors in a building. The system considers various components and their technical properties to ensure accurate calculations.

Components

  1. Cable Coaxial

    • Attenuation at 470 MHz and 694 MHz
    • Signal loss over distance
    • Cost considerations

  2. Base de Toma (Outlets)

    • Attenuation properties
    • Decoupling characteristics
    • Final connection point

  3. Derivador (Taps)

    • Tap attenuation
    • Through attenuation
    • Directivity and decoupling
    • Return loss

  4. Distribuidor (Splitters)

    • Number of outputs
    • Distribution attenuation
    • Decoupling
    • Return loss

Calculation Process

  1. Start with head-end level (nivel_cabecera)
  2. Calculate signal loss through each component
  3. Consider floor-specific components
  4. Validate against quality margins
  5. Generate floor-by-floor results

Configuration Management

Building Setup

  • Configure number of floors
  • Set head-end signal level
  • Name and describe configurations
  • Track creation and modification

Component Selection

  • Choose from available components
  • Add components to specific floors
  • Configure component properties
  • Calculate total cost

Configuration Storage

  • Save configurations for later use
  • Update existing configurations
  • Delete unused configurations
  • Track configuration history

Component Management

Component Types

  1. Cable Coaxial

    • Model selection
    • Length configuration
    • Attenuation properties

  2. Base de Toma

    • Model selection
    • Attenuation settings
    • Decoupling configuration

  3. Derivador

    • Model selection
    • Tap settings
    • Through path configuration

  4. Distribuidor

    • Model selection
    • Output configuration
    • Distribution settings

Management Features

  • Add new components
  • Update existing components
  • Remove components
  • Configure properties
  • Set costs

Signal Simulation

Real-time Calculation

  • Instant signal level updates
  • Component property changes
  • Floor-specific calculations
  • Quality validation

Visual Feedback

  • Color-coded signal levels
  • Quality margin indicators
  • Component status
  • Cost tracking

Validation

  • Signal level checks
  • Component compatibility
  • Configuration completeness
  • Quality margin compliance

Optimization (TODO)

Cost Optimization

  • Component selection
  • Configuration alternatives
  • Cost-effectiveness analysis
  • Quality maintenance

Signal Quality

  • Level optimization
  • Component placement
  • Distribution efficiency
  • Margin compliance

Future Enhancements

  • Automatic configuration
  • Smart component selection
  • Cost reduction strategies
  • Quality improvement suggestions

User Interface

Main Tabs

  1. Configuration

    • Building setup
    • General settings
    • Configuration management

  2. Components

    • Component selection
    • Property configuration
    • Cost management

  3. Simulation

    • Real-time calculation
    • Component arrangement
    • Signal level display

  4. Results

    • Detailed analysis
    • Quality validation
    • Cost breakdown
    • Optimization suggestions

Theme Support

  • Light mode
  • Dark mode
  • System preference detection
  • Persistent settings

Quality Assurance

Signal Quality

  • Minimum level validation
  • Maximum level validation
  • Component compatibility
  • Distribution efficiency

Component Quality

  • Technical specifications
  • Performance validation
  • Compatibility checks
  • Cost-effectiveness

Configuration Quality

  • Completeness checks
  • Validity verification
  • Performance analysis
  • Cost analysis

Reporting

Signal Levels

  • Floor-by-floor breakdown
  • Component contribution
  • Quality margin status
  • Problem identification

Cost Analysis

  • Component costs
  • Total configuration cost
  • Cost optimization
  • Budget tracking

Technical Reports

  • Component details
  • Signal distribution
  • Quality validation
  • Optimization suggestions

Future Enhancements

Planned Features

  1. Optimization Algorithm

    • Automatic component selection
    • Cost optimization
    • Quality improvement
    • Efficiency enhancement

  2. Advanced Simulation

    • 3D visualization
    • Real-time updates
    • Interactive modeling
    • Performance analysis

  3. Extended Reporting

    • Detailed analytics
    • Custom reports
    • Export options
    • Data visualization

  4. Integration Options

    • External systems
    • Data import/export
    • API extensions
    • Third-party tools