• Documentation
  • Core API
  • SmartOpenHamburg API
  • Model Components API
  • Common API

    Show / Hide Table of Contents
    • MARS DSL Language
    • MARS Runtime System
      • Getting started with MARS
      • Basic Concepts
        • Multi-Agent-Simulation
        • Agents
        • Layers
        • Entities
        • Environments
          • SpatialHashEnvironment
          • GeoHashEnvironment
          • SpatialGraphEnvironment
          • CollisionEnvironment
        • Model Setup
      • Model Configuration
        • Agent and Entity Configuration
        • Layer Configuration
        • Output Filter
        • Simulation Configuration Options
        • Simulation Output Formats
      • Data Sources
        • Geospatial Data Sources
        • Geospatial Data Types
        • ASCII grid (.asc)
        • CSV
        • Time-series Data
      • Analysis and Visualization
        • Visualizing Agent Movement Trajectories
        • Simple Live Visualization
        • Analyzing Output Data
      • Tutorials
        • Creating a new MARS C# project
        • Creating a starting point for your model
        • Creating vector and raster layer files
        • Building your first model (wolf-sheep-grass)
        • Common problems and solutions
        • Acquire geo data for layers
        • Build and start your model in Kubernetes cluster
    • SmartOpenHamburg
      • Quick Start
      • Ready to use scenarios (boxes)
        • Ferry Transfer
        • Green4Bikes
        • Results
        • Result Schemas
      • Layer
        • Multimodal Layer
        • Modal Layer
        • Scheduling Layer
        • Vector Layer
      • Agents
        • Behaviour Model
        • Multimodal
        • Multi-Capable
        • Multi-Modality
        • Citizen
        • Traveler
      • Entities
        • Referencing
        • Street Vehicles
        • Bicycle Vehicles
        • Ferry

    Referencing

    SmartOpenHamburg distinguishes between agents (acting individuals) and entities (usable objects) within the simulation. Both can be initialized using files (see Agent Configuration). Entities are initialized by an EntityManagerthat has a data source (e.g. a csv-file like car.csv). While every agent is unique, there may be multiple entities with the same initialization.

    The following example displays a car.csv. It defines values for relevant attributes of the Car. Every instance of a car is initialized by referencing the type column. All cars of type Golf have for instance a maxSpeed of 13.89 m/s.

    type maxAcceleration maxDeceleration maxSpeed length height width trafficCode passengerCapacity velocity mass
    Golf 0.73 1.67 13.89 4.5 2 2 german 4 0 1500

    The properties are further described below.

    property description
    type Identification column
    maxAcceleration Acceleration module parameter in meter/second²
    maxDeceleration Acceleration module parameter in meter/second²
    maxSpeed Acceleration module parameter in meter/second
    length Dimension parameter for occupancy on the road in meter
    height Dimension parameter for occupancy on the road in meter
    width Dimension parameter for occupancy on the road in meter
    trafficCode Identifies the behavior on intersections without traffic lights
    passengerCapacity The amount of passenger that can be driven by the car beside the driver
    velocity The starting velocity in meter/second
    mass Might be used by the acceleration module but is not right now. Unit in kilogram

    As by now the model includes the following entity types:

    • Car
    • Bicycle
    • Ferry
    Back to top Copyright © MARS GROUP.
    HAW Hamburg