Skip to content

ClassDefinition_step4

RoiArthurB edited this page Jul 30, 2026 · 4 revisions

Virtual Classes

What Is a Virtual Class?

A virtual class cannot be instantiated directly. It acts as a contract — every concrete subclass must implement all declared virtual actions.

class sensor virtual: true {
	
	string id <- "sensor";
	bool active <- true;
	
	// Virtual (abstract) action: every concrete subclass MUST implement
	float read() virtual: true;
	
	// Virtual action: every concrete subclass MUST implement
	string unit() virtual: true;
	
	// Concrete action: implemented once here, calls the virtual actions
	string formatted_reading() {
		if !active { return id + ": [OFF]"; }
		return id + ": " + (read() with_precision 2) + " " + unit();
	}
}

The sensor class:

  • Cannot be instantiated: sensor s <- sensor() yields nil (s is nil).
  • Acts as a contract: every subclass must implement read() and unit().
  • Provides a concrete formatted_reading() that calls the virtual actions polymorphically.

Concrete Subclasses

A concrete class (no virtual: true) must implement every inherited virtual action:

class thermometer parent: sensor {
	
	float temperature <- 20.0;
	float min_temp <- #infinity;
	float max_temp <- -#infinity;
	
	// Implements sensor.read()
	float read() {
		return temperature;
	}
	
	// Implements sensor.unit()
	string unit() {
		return "°C";
	}
	
	action update(float t) {          // new action specific to thermometer
		temperature <- t;
		if t < min_temp { min_temp <- t; }
		if t > max_temp { max_temp <- t; }
	}
}

class barometer parent: sensor {
	
	float pressure <- 1013.25;
	
	// Implements sensor.read()
	float read() {
		return pressure;
	}
	
	// Implements sensor.unit()
	string unit() {
		return "hPa";
	}
	
	// Specific action not part of the sensor contract
	float estimated_altitude() {
		return 44330.0 * (1.0 - (pressure / 1013.25) ^ 0.1903);
	}
}

If a child class does not implement ALL virtual actions from its parent, it becomes virtual itself (and cannot be instantiated).

Partially Abstract Intermediate Class

A class that implements SOME but not all virtual actions from its parent becomes virtual itself:

class calibrated_sensor virtual: true parent: sensor {
	
	float calibration_offset <- 0.0;
	
	// Implements unit() from sensor — concrete
	string unit() {
		return "raw";
	}
	
	// read() is still virtual here — calibrated_sensor is itself abstract
	// You cannot instantiate this class
}

class light_sensor parent: calibrated_sensor {
	
	float raw_lux <- 0.0;
	
	// Finally implements read() from sensor → light_sensor is CONCRETE
	float read() {
		return raw_lux + calibration_offset;
	}
	
	// Override the "raw" unit from calibrated_sensor
	string unit() {
		return "lux";
	}
}

Hierarchy:

sensor (abstract)
├── thermometer (concrete)
├── barometer (concrete)
└── calibrated_sensor (abstract — still needs read())
    └── light_sensor (concrete — implements read + overrides unit)

Polymorphism with Abstract Types

A variable typed as the virtual class can hold any concrete subclass:

list<sensor> sensors <- [
	thermometer(id: "temp01", temperature: 23.5),
	barometer(id: "baro01",   pressure: 1005.0),
	light_sensor(id: "lux01", raw_lux: 850, calibration_offset: 15)
];

loop s over: sensors {
	write s.formatted_reading();    // dispatches to the concrete class's read() and unit()
}

Aggregates Over a Polymorphic List

float max_r <- max(sensors collect (each.active ? each.read() : -#infinity));
write "max raw reading = " + (max_r with_precision 2);

Accessing Concrete-Specific Actions

You can only access concrete-specific methods (not in the abstract class) after narrowing down to the right type:

// barometer-specific: estimated_altitude() is NOT defined on sensor
loop s over: sensors {
	if s is barometer {
		barometer b <- s;  // cast to barometer
		write b.estimated_altitude() with_precision 0 + " m";
	}
}

Type Checking with is

if t1 is sensor {
	// OK — thermometer is a sensor
}

if l1 is calibrated_sensor {
	// OK — light_sensor extends calibrated_sensor which extends sensor
}

if t1 is barometer {
	// false — thermometer and barometer are siblings
}

Example: Full Model

class sensor virtual: true {
	string id <- "sensor";
	bool active <- true;
	
	float read() virtual: true;
	string unit() virtual: true;
	
	string formatted_reading() {
		if !active { return id + ": [OFF]"; }
		return id + ": " + (read() with_precision 2) + " " + unit();
	}
}

class thermometer parent: sensor {
	float temperature <- 20.0;
	float min_temp <- #infinity;
	float max_temp <- -#infinity;
	
	float read() { return temperature; }
	string unit() { return "C"; }
	
	action update(float t) {
		temperature <- t;
		if t < min_temp { min_temp <- t; }
		if t > max_temp { max_temp <- t; }
	}
}

class barometer parent: sensor {
	float pressure <- 1013.25;
	
	float read() { return pressure; }
	string unit() { return "hPa"; }
}

global {
	init {
		list<sensor> sensors <- [
			thermometer(id: "temp01", temperature: 23.5),
			barometer(id: "baro01", pressure: 1005.0)
		];
		
		// Polymorphic dispatch
		loop s over: sensors {
			write s.formatted_reading();
		}
		
		// Toggle off
		sensors[1].active <- false;
		loop s over: sensors {
			write s.formatted_reading();   // barometer now prints [OFF]
		}
	}
}

experiment Virtual_Classes title: "Virtual Classes" type: gui {}

Key Takeaways

Feature Syntax
Abstract class class ClassName virtual: true {
Virtual action return_type action_name() virtual: true;
Implement inherited virtual action Redefine with the same signature (no virtual: true)
Partially abstract intermediate Implements some virtual actions → becomes virtual itself
Polymorphic list list<AbstractClass> items <- [concrete1, concrete2];
Type check obj is ConcreteClass
  1. What's new (Changelog)
  2. Migration Guide (2025-06 → 2026-06)
  1. Installation and Launching
    1. Installation
    2. Launching GAMA
    3. Updating GAMA
    4. Installing Plugins
  2. Workspace, Projects and Models
    1. Navigating in the Workspace
    2. Changing Workspace
    3. Importing Models
  3. Editing Models
    1. GAML Editor (Generalities)
    2. GAML Editor Tools
    3. Validation of Models
  4. Running Experiments
    1. Launching Experiments
    2. Experiments User interface
    3. Controls of experiments
    4. Parameters view
    5. Inspectors and monitors
    6. Displays
    7. Batch Specific UI
    8. Errors View
  5. Running Headless
    1. Getting Started
    2. Headless Legacy
    3. Headless Batch
  6. Preferences
  7. Troubleshooting
  1. Introduction
    1. Start with GAML
    2. Organization of a Model
    3. Basic programming concepts in GAML
  2. Manipulate basic Species
  3. Global Species
    1. Regular Species
    2. Defining Actions and Behaviors
    3. Interaction between Agents
    4. Attaching Skills
    5. Inheritance
  4. Defining Advanced Species
    1. Grid Species
    2. Graph Species
    3. Mirror Species
    4. Multi-Level Architecture
  5. Defining GUI Experiment
    1. Defining Parameters
    2. Defining Displays Generalities
    3. Defining 3D Displays
    4. Defining Charts
    5. Defining Monitors and Inspectors
    6. Defining Export files
    7. Defining User Interaction
  6. Classes and Objects
    1. Class Definition and Instantiation
    2. Attributes and Actions
    3. Inheritance
    4. Virtual Classes
    5. Advanced Features
  7. Exploring Models
    1. Run Several Simulations
    2. Batch Experiments
    3. Exploration Methods
  8. Optimizing Models
    1. Runtime Concepts
    2. Analyzing code performance
    3. Optimizing Models
  9. Multi-Paradigm Modeling
    1. Control Architecture
    2. Defining Differential Equations
  1. Manipulate OSM Data
  2. Cleaning OSM Data
  3. Diffusion
  4. Using Database
  5. Using Dataframes
  6. Using FIPA ACL
  7. Using BDI with BEN
  8. Using Driving Skill
  9. Manipulate dates
  10. Manipulate lights
  11. Using comodel
  12. Save and restore Simulations
  13. Using network
  14. Writing Unit Tests
  15. Ensure model's reproducibility
  16. Going further with extensions
    1. Calling R
    2. Using Graphical Editor
    3. Using Git from GAMA
  1. Built-in Species
  2. Built-in Skills
  3. Built-in Architecture
  4. Statements
  5. Data Type
  6. File Type
  7. Stats Extension
  8. Sound Extension
  9. BDI Extension
  10. FIPA Skill
  11. Expressions
    1. Literals
    2. Units and Constants
    3. Pseudo Variables
    4. Variables And Attributes
    5. Operators (Definition)
    6. Operators [A-A]
    7. Operators [B-C]
    8. Operators [D-H]
    9. Operators [I-M]
    10. Operators [N-R]
    11. Operators [S-Z]
  12. Exhaustive list of GAMA Keywords
  1. Installing the development version
    1. Install GAMA source code with Eclipse plugin
  2. Developing Extensions
    1. Developing Plugins
    2. Developing Skills
    3. Developing Statements
    4. Developing Operators
    5. Developing Types
    6. Developing Species
    7. Developing Control Architectures
    8. Index of annotations
  3. Introduction to GAMA Java API
    1. Architecture of GAMA
    2. IScope
  4. Using GAMA flags
  5. Creating a release of GAMA
  6. Documentation generation

  1. Predator Prey
  2. Road Traffic
  3. Incremental Model
  4. Luneray's flu
  5. BDI Agents
  6. Forager RL
  7. SIR Analysis
  8. 3D Model

  1. Team
  2. Projects using GAMA
  3. Scientific References
  4. Training Sessions

Resources

  1. Videos
  2. Conferences
  3. Pedagogical materials

Clone this wiki locally