• 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

    Environments

    An environment is a spatial data structure. Its main purpose is to enable performant access to resources and networks for agents. To facilitate agent movement and interactions, an environment features a number of methods and functionalities that can be called by the agents that interacts with it. Multiple environments can be associated with each other, and one or more environment(s) are generally held by a layer.

    There are different types of environments:

    • SpatialHashEnvironment
    • GeoHashEnvironment
    • SpatialGraphEnvironment
    • CollisionEnvironment

    Environment support the following methods:

    • Insert/Remove to position/remove agents or entities in/from the environment
    • Move to enable agents or entities to move within the environment
    • Explore to enable an agent to search for and query other agents, entities, and objects of interest within the environment.

    The exact functionality of these methods is different for each environment type and is described in the corresponding sections (see below) and articles.

    SpatialHashEnvironment

    A SpatialHashEnvironment is an environment in which the world is divided into cells of equal size, like on a chessboard. For more information, please click here.

    GeoHashEnvironment

    A GeoHashEnvironment is an environment that consists of geospatial point objects. A geospatial point objects is a georeferenced location that consists of a longitude and latitude, in this case based on the coordinate reference system WGS84 EPSG:4326 CRS. For more information, please click here.

    SpatialGraphEnvironment

    A SpatialGraphEnvironment is defined by nodes with spatial locations and edges that connect these nodes. Such an environment limits movement and exploration of its agents to the available nodes and edges. For more information, please click here.

    CollisionEnvironment

    A CollisionEnvironment is a game environment that manages characters and obstacles. A character is an agent that participates in the game that is played in the environment. An obstacles is a physical object with a given geometric shape that is positioned in the environment. The environment can handle different collision types. For more information, please click here.

    Back to top Copyright © MARS GROUP.
    HAW Hamburg