FLAME GPU 2
Contents:
Quickstart
Prerequisites
CUDA C++
Installation
Creating a new project
Compiling your project
Running your project
Python 3
Installation
Building from source
Creating a new project
Running your project
User Guide
First Steps
FLAMEGPU2 Design Philosophy
Creating a Project
Structure of a FLAMEGPU2 Program
Agent/Host Function Definitions
Model Declaration
Initialisation
Execution
Defining a Model
Creating a Model
What is a Model?
Creating a ModelDescription Object
More Info
Adding Environmental Properties
What is an Environment?
Creating an EnvironmentDescription Object
Defining Environmental Properties
Macro Environmental Properties
Full Example Code From This Page
More Info
Defining Agents
Defining a New Agent Type
Agent Variables
Agent Array Variables
Agent States
Full Example Code From This Page
More Info
Defining Behaviours
Defining Agent Functions
What is an Agent Function?
Defining an Agent Function
FLAMEGPU Device Functions
FLAMEGPU Host Device Functions
Full Example Code From This Page
More Info
Modifying Agent Variables
Interacting with the Environment
Environment Properties
Environment Macro Properties
Agent Communication
Defining Messages
Sending Messages
Reading Messages
Conditional Behaviours
Agent Function Conditions
Host Functions
Defining Host Functions
Adding Host Functions to a Model
Writing Host Functions
Initial Conditions
Agent Populations
Creating an Agent Population
Initialising Agent Variables
Initialising a Population
Accessing a Single Agent
Random Number Generation
Initialisation from Disk
File Format
Running a Simulation
Defining Execution Order
Specifying Dependencies
Accessing the DependencyGraph
Specifying Roots
Generating Layers
Visualising the Dependencies
Manual Layer Specification
Creating a Simulation
Simulation Exit Conditions
Max Steps
Conditional Exit
Collecting Data
Configuring Data to be Collected
Accessing Collected Data
Writing Collected Data to File
Accessing the Complete Agent State
Additional Notes
Configuring Execution
Agent Birth/Death
Agent Birth from Agent Functions
Agent Creation Overview
Enabling Agent Creation
Creating the New Agent
Conditional Agent Creation
Full Example Code From This Page
More Info
Agent Birth from Host Functions
Agent Death
Enabling Agent Death
Agent Death
More Info
Submodels
Defining a Submodel
Submodel Definition
Running Multiple Simulations
Launching Ensembles
Visualisation
Building with Visualisation
Default Visualisation
Configuring a Visualisation
Visualisation Options
Visualising After Simulation Exit
Visualising Agents
Agent Model
Agent Position
Agent Direction
Agent Scale
Agent Color
Agent States
Visualising Additional Details
Lines
Models
Visualisation Controls
Performance Troubleshooting
Performance Troubleshooting
Building or Modifying the FLAMEGPU Source
Building FLAME GPU from Source
Requesting Features
Contributing to FLAMEGPU2
Reporting Bugs
Submitting Pull Requests
License
Library API
Page Hierarchy
Class Hierarchy
File Hierarchy
Full API
Namespaces
Namespace flamegpu
Namespace flamegpu::@154
Namespace flamegpu::exception
Namespace flamegpu::io
Namespace flamegpu::util
Namespace flamegpu::util::nvtx
Namespace flamegpu::visualiser
Namespace flamegpu::visualiser::Stock
Namespace flamegpu::visualiser::Stock::Colors
Namespace flamegpu::visualiser::Stock::Palettes
Classes and Structs
Struct AgentData
Struct AgentFunctionData
Struct AgentLogFrame
Struct AgentVariable
Struct AgentVariableHash
Struct CUDAEnsemble::EnsembleConfig
Struct CUDAFatAgent::AgentState
Struct CUDAFatAgent::AgentState_hash
Struct CUDAFatAgent::NewBuffer
Struct CUDAMacroEnvironment::MacroEnvProp
Struct CUDAScanCompactionConfig
Struct CUDAScanCompactionPtrs
Struct CUDAScatter::InversionIterator
Struct CUDAScatter::ScatterData
Struct CUDAScatter::StreamData
Struct CUDASimulation::Config
Struct CUDASimulation::Singletons
Struct DeviceAgentVector_impl::VariableBufferPair
Struct EnvironmentDescription::MacroPropData
Struct EnvironmentDescription::PropData
Struct EnvironmentManager::DefragProp
Struct EnvironmentManager::EnvProp
Struct EnvironmentManager::EnvUpdateFlags
Struct EnvironmentManager::MappedProp
Struct EnvironmentManager::NamePairHash
Struct EnvironmentManager::RTCEnvPropCache
Struct DeviceExceptionBuffer
Struct HostAPI::key_hash
Struct HostMacroProperty_MetaData
Struct LayerData
Struct LogFrame
Struct LoggingConfig::NameReductionFn
Struct MessageArray2D::Data
Struct MessageArray2D::MetaData
Struct MessageArray3D::Data
Struct MessageArray3D::MetaData
Struct MessageArray::Data
Struct MessageArray::MetaData
Struct MessageBruteForce::Data
Struct MessageBruteForce::MetaData
Struct MessageBucket::Data
Struct MessageBucket::MetaData
Struct MessageSpatial2D::Data
Struct MessageSpatial2D::GridPos2D
Struct MessageSpatial2D::MetaData
Struct MessageSpatial3D::Data
Struct MessageSpatial3D::GridPos3D
Struct MessageSpatial3D::MetaData
Struct ModelData
Struct NewAgentStorage
Struct RunLog
Struct Simulation::Config
Struct SubAgentData
Struct SubEnvironmentData
Struct SubModelData
Template Struct sum_input_t
Template Struct sum_input_t< char >
Template Struct sum_input_t< double >
Template Struct sum_input_t< float >
Template Struct sum_input_t< int16_t >
Template Struct sum_input_t< int32_t >
Template Struct sum_input_t< int64_t >
Template Struct sum_input_t< int8_t >
Template Struct sum_input_t< uint16_t >
Template Struct sum_input_t< uint32_t >
Template Struct sum_input_t< uint64_t >
Template Struct sum_input_t< uint8_t >
Struct Any
Struct StringPairHash
Struct StringUint32PairHash
Struct Variable
Struct VariableBuffer
Struct VarOffsetStruct
Struct VarOffsetStruct::OffsetLen
Struct Color
Struct Palette
Struct Dark2
Struct Greys
Struct Pastel
Struct PiYG
Struct RdYlBu
Struct Set1
Struct Set2
Struct Viridis
Struct YlGn
Struct YlOrRd
Class AgentDescription
Class AgentFunctionDescription
Class AgentInstance
Class AgentInterface
Class AgentLoggingConfig
Class AgentRandom
Class AgentVector
Class AgentVector::const_iterator
Class AgentVector::const_reverse_iterator
Class AgentVector::iterator
Class AgentVector::reverse_iterator
Class AgentVector_Agent
Class AgentVector_CAgent
Class CUDAAgent
Class CUDAAgentStateList
Class CUDAEnsemble
Class CUDAFatAgent
Class CUDAFatAgentStateList
Class CUDAMacroEnvironment
Class CUDAMessage
Class CUDAMessageList
Class CUDAScanCompaction
Class CUDAScatter
Class CUDASimulation
Class DependencyGraph
Class DependencyNode
Class DeviceAgentVector_impl
Template Class DeviceAPI
Class DeviceAPI::AgentOut
Class DeviceEnvironment
Template Class DeviceMacroProperty
Class EnvironmentDescription
Class EnvironmentManager
Class AgentIDCollision
Class ArrayMessageWriteConflict
Class CUDAError
Class CurveException
Class DeviceError
Class DeviceExceptionManager
Class DifferentModel
Class DuplicateEnvProperty
Class EnvDescriptionAlreadyLoaded
Class ExpiredWeakPtr
Class FLAMEGPUException
Class InvalidAgent
Class InvalidAgentFunc
Class InvalidAgentName
Class InvalidAgentState
Class InvalidAgentVar
Class InvalidArgument
Class InvalidCudaAgent
Class InvalidCudaAgentDesc
Class InvalidCudaAgentMapSize
Class InvalidCudaAgentState
Class InvalidCUDAComputeCapability
Class InvalidCUDAdevice
Class InvalidCudaMessage
Class InvalidDependencyGraph
Class InvalidEnvProperty
Class InvalidEnvPropertyType
Class InvalidFilePath
Class InvalidFuncLayerIndx
Class InvalidHostFunc
Class InvalidInputFile
Class InvalidLayerMember
Class InvalidMemoryCapacity
Class InvalidMessage
Class InvalidMessageData
Class InvalidMessageName
Class InvalidMessageType
Class InvalidMessageVar
Class InvalidOperation
Class InvalidParent
Class InvalidStateName
Class InvalidSubAgentName
Class InvalidSubModel
Class InvalidSubModelName
Class InvalidVarArrayLen
Class InvalidVarType
Class OutOfBoundsException
Class OutOfMemory
Class OutOfRangeVarArray
Class RapidJSONError
Class ReadOnlyEnvProperty
Class ReservedName
Class TimerException
Class TinyXMLError
Class UnknownError
Class UnknownInternalError
Class UnsupportedFileType
Class UnsupportedVarType
Class VersionMismatch
Class VisualisationException
Class HostAgentAPI
Class HostAPI
Class HostEnvironment
Class HostFunctionCallback
Class HostFunctionConditionCallback
Class HostFunctionDescription
Template Class HostMacroProperty
Class HostNewAgentAPI
Class HostRandom
Class JSONLogger
Class JSONStateReader
Class JSONStateReader_agentsize_counter
Class JSONStateReader_impl
Class JSONStateWriter
Class Logger
Class LoggerFactory
Class StateReader
Class StateReaderFactory
Class StateWriter
Class StateWriterFactory
Class XMLLogger
Class XMLStateReader
Class XMLStateWriter
Class LayerDescription
Class LoggingConfig
Class MessageArray
Class MessageArray2D
Class MessageArray2D::CUDAModelHandler
Class MessageArray2D::Description
Class MessageArray2D::In
Class In::Filter
Class Filter::iterator
Class Filter::Message
Class In::Message
Class In::WrapFilter
Class WrapFilter::iterator
Class WrapFilter::Message
Class MessageArray2D::Out
Class MessageArray3D
Class MessageArray3D::CUDAModelHandler
Class MessageArray3D::Description
Class MessageArray3D::In
Class In::Filter
Class Filter::iterator
Class Filter::Message
Class In::Message
Class In::WrapFilter
Class WrapFilter::iterator
Class WrapFilter::Message
Class MessageArray3D::Out
Class MessageArray::CUDAModelHandler
Class MessageArray::Description
Class MessageArray::In
Class In::Filter
Class Filter::iterator
Class Filter::Message
Class In::Message
Class In::WrapFilter
Class WrapFilter::iterator
Class WrapFilter::Message
Class MessageArray::Out
Class MessageBruteForce
Class MessageBruteForce::CUDAModelHandler
Class MessageBruteForce::Description
Class MessageBruteForce::In
Class In::iterator
Class In::Message
Class MessageBruteForce::Out
Class MessageBucket
Class MessageBucket::CUDAModelHandler
Class MessageBucket::Description
Class MessageBucket::In
Class In::Filter
Class Filter::iterator
Class Filter::Message
Class MessageBucket::Out
Class MessageNone
Class MessageNone::CUDAModelHandler
Class MessageNone::In
Class MessageNone::Out
Class MessageSpatial2D
Class MessageSpatial2D::CUDAModelHandler
Class MessageSpatial2D::Description
Class MessageSpatial2D::In
Class In::Filter
Class Filter::iterator
Class Filter::Message
Class MessageSpatial2D::Out
Class MessageSpatial3D
Class MessageSpatial3D::CUDAModelHandler
Class MessageSpatial3D::Description
Class MessageSpatial3D::In
Class In::Filter
Class Filter::iterator
Class Filter::Message
Class MessageSpatial3D::Out
Class MessageSpecialisationHandler
Class ModelDescription
Class RandomManager
Class ReadOnlyDeviceAPI
Class ReadOnlyDeviceEnvironment
Template Class ReadOnlyDeviceMacroProperty
Class RunPlan
Class RunPlanVector
Class SimLogger
Class SimRunner
Class Simulation
Class StepLoggingConfig
Class SubAgentDescription
Class SubEnvironmentDescription
Class SubModelDescription
Class NVTXRange
Class AgentStateVis
Class AgentVis
Class AutoPalette
Class ColorFunction
Template Class DiscreteColor
Class HSVInterpolation
Class LineVis
Class ModelVis
Class Palette::const_iterator
Class StaticColor
Class StaticModelVis
Class ViridisInterpolation
Enums
Enum AGENT_STATUS
Enum CONDITION_RESULT
Enum MessageSortingType
Functions
Template Function flamegpu::agent_function_condition_wrapper
Template Function flamegpu::agent_function_wrapper
Function flamegpu::allocateIDs
Function flamegpu::atomicHistogram1D
Function flamegpu::atomicHistogram2D
Function flamegpu::atomicHistogram3D
Function flamegpu::broadcastInitKernel
Function flamegpu::calculateSpatialHash
Function flamegpu::generateCollisionFlags
Template Function flamegpu::getAgentVariableMaxFunc
Template Function flamegpu::getAgentVariableMeanFunc
Template Function flamegpu::getAgentVariableMinFunc
Template Function flamegpu::getAgentVariableStandardDevFunc
Template Function flamegpu::getAgentVariableSumFunc
Function flamegpu::getGridPosition2D
Function flamegpu::getGridPosition3D
Function flamegpu::getHash2D
Function flamegpu::getHash3D
Function flamegpu::init_curand
Function flamegpu::initToThreadIndex
Function flamegpu::pbm_reorder_generic
Function flamegpu::reorder_array_messages
Function flamegpu::scatter_all_generic
Template Function flamegpu::scatter_generic
Function flamegpu::scatter_new_agents
Function flamegpu::scatter_position_generic
Function flamegpu::sortBuffer_kernel
Function flamegpu::spatialSortInitToThreadIndex
Function flamegpu::util::nvtx::pop
Function flamegpu::util::nvtx::push
Variables
Variable flamegpu::ID_NOT_SET
Variable flamegpu::ID_VARIABLE_NAME
Variable flamegpu::util::nvtx::colourCount
Variable flamegpu::util::nvtx::palette
Variable flamegpu::VERSION
Variable flamegpu::VERSION_BUILDMETADATA
Variable flamegpu::VERSION_FULL
Variable flamegpu::VERSION_MAJOR
Variable flamegpu::VERSION_MINOR
Variable flamegpu::VERSION_PATCH
Variable flamegpu::VERSION_PRERELEASE
Variable flamegpu::VERSION_STRING
Variable flamegpu::visualiser::Stock::Colors::BLACK
Variable flamegpu::visualiser::Stock::Colors::BLUE
Variable flamegpu::visualiser::Stock::Colors::GREEN
Variable flamegpu::visualiser::Stock::Colors::RED
Variable flamegpu::visualiser::Stock::Colors::WHITE
Variable flamegpu::visualiser::Stock::Palettes::DARK2
Variable flamegpu::visualiser::Stock::Palettes::GREYS
Variable flamegpu::visualiser::Stock::Palettes::PASTEL
Variable flamegpu::visualiser::Stock::Palettes::PIYG
Variable flamegpu::visualiser::Stock::Palettes::RDYLBU
Variable flamegpu::visualiser::Stock::Palettes::SET1
Variable flamegpu::visualiser::Stock::Palettes::SET2
Variable flamegpu::visualiser::Stock::Palettes::YLGN
Variable flamegpu::visualiser::Stock::Palettes::YLORRD
Defines
Define _SILENCE_EXPERIMENTAL_FILESYSTEM_DEPRECATION_WARNING
Define _SILENCE_EXPERIMENTAL_FILESYSTEM_DEPRECATION_WARNING
Define _SILENCE_EXPERIMENTAL_FILESYSTEM_DEPRECATION_WARNING
Define _SILENCE_EXPERIMENTAL_FILESYSTEM_DEPRECATION_WARNING
Define DERIVED_FLAMEGPUException
Define DTHROW
Define FLAMEGPU_AGENT_FUNCTION
Define FLAMEGPU_AGENT_FUNCTION_CONDITION
Define FLAMEGPU_CUSTOM_REDUCTION
Define FLAMEGPU_CUSTOM_TRANSFORM
Define FLAMEGPU_DEVICE_FUNCTION
Define FLAMEGPU_EXIT_CONDITION
Define FLAMEGPU_EXIT_FUNCTION
Define FLAMEGPU_HOST_CONDITION
Define FLAMEGPU_HOST_DEVICE_FUNCTION
Define FLAMEGPU_HOST_FUNCTION
Define FLAMEGPU_INIT_FUNCTION
Define FLAMEGPU_STEP_FUNCTION
Define FLAMEGPU_VERSION
Define gpuErrchk
Define gpuErrchkDriverAPI
Define gpuErrchkLaunch
Define INCLUDE_FLAMEGPU_EXCEPTION_FLAMEGPUDEVICEEXCEPTION_CUH_
Define INCLUDE_FLAMEGPU_EXCEPTION_FLAMEGPUDEVICEEXCEPTION_DEVICE_CUH_
Define INCLUDE_FLAMEGPU_GPU_CUDASCATTER_CUH_
Define INCLUDE_FLAMEGPU_GPU_DETAIL_CUDAERRORCHECKING_CUH_
Define INCLUDE_FLAMEGPU_MODEL_AGENTFUNCTIONDATA_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_AGENTFUNCTION_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_AGENTFUNCTION_SHIM_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_AGENTFUNCTIONCONDITION_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_AGENTFUNCTIONCONDITION_SHIM_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_DETAIL_CURVE_CURVE_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_DETAIL_CURVE_CURVE_RTC_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_DEVICEAPI_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_HOSTAGENTAPI_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGEARRAY2D_MESSAGEARRAY2DDEVICE_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGEARRAY3D_MESSAGEARRAY3DDEVICE_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGEARRAY_MESSAGEARRAYDEVICE_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGEBRUTEFORCE_MESSAGEBRUTEFORCEDEVICE_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGEBUCKET_MESSAGEBUCKETDEVICE_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGENONE_MESSAGENONEDEVICE_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGESPATIAL2D_MESSAGESPATIAL2DDEVICE_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGESPATIAL3D_MESSAGESPATIAL3DDEVICE_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_UTILITY_AGENTRANDOM_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_UTILITY_DEVICEENVIRONMENT_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_UTILITY_DEVICEMACROPROPERTY_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_UTILITY_ENVIRONMENTMANAGER_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_UTILITY_HOSTENVIRONMENT_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_UTILITY_HOSTMACROPROPERTY_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_UTILITY_HOSTRANDOM_CUH_
Define INCLUDE_FLAMEGPU_RUNTIME_UTILITY_RANDOMMANAGER_CUH_
Define INCLUDE_FLAMEGPU_SIM_AGENTLOGGINGCONFIG_REDUCTIONS_CUH_
Define INCLUDE_FLAMEGPU_UTIL_DETAIL_COMPUTE_CAPABILITY_CUH_
Define INCLUDE_FLAMEGPU_UTIL_DETAIL_CUDAEVENTTIMER_CUH_
Define INCLUDE_FLAMEGPU_UTIL_DETAIL_WDDM_CUH_
Define NVTX_POP
Define NVTX_PUSH
Define NVTX_RANGE
Define THROW
Define XMLCheckResult
Define XMLCheckResult
Define XMLCheckResult
Typedefs
Typedef flamegpu::AgentFunctionConditionWrapper
Typedef flamegpu::AgentFunctionWrapper
Typedef flamegpu::CUDAMessageMap
Typedef flamegpu::CUDAMessageMapPair
Typedef flamegpu::DeviceAgentVector
Typedef flamegpu::FLAMEGPU_EXIT_CONDITION_POINTER
Typedef flamegpu::FLAMEGPU_EXIT_FUNCTION_POINTER
Typedef flamegpu::FLAMEGPU_HOST_CONDITION_POINTER
Typedef flamegpu::FLAMEGPU_HOST_FUNCTION_POINTER
Typedef flamegpu::FLAMEGPU_INIT_FUNCTION_POINTER
Typedef flamegpu::FLAMEGPU_STEP_FUNCTION_POINTER
Typedef flamegpu::id_t
Typedef flamegpu::IntT
Typedef flamegpu::util::StringPair
Typedef flamegpu::util::StringPairMap
Typedef flamegpu::util::StringPairUnorderedMap
Typedef flamegpu::util::StringUint32Pair
Typedef flamegpu::util::StringUint32PairMap
Typedef flamegpu::util::StringUint32PairUnorderedMap
Typedef flamegpu::VariableMap
Typedef flamegpu::visualiser::iDiscreteColor
Typedef flamegpu::visualiser::uDiscreteColor
Forum
FLAME GPU 2
»
Library API
»
Define INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGESPATIAL3D_MESSAGESPATIAL3DDEVICE_CUH_
View page source
Define
INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGESPATIAL3D_MESSAGESPATIAL3DDEVICE_CUH_
Defined in
File MessageSpatial3DDevice.cuh
Define Documentation
INCLUDE_FLAMEGPU_RUNTIME_MESSAGING_MESSAGESPATIAL3D_MESSAGESPATIAL3DDEVICE_CUH_