Platform

class ixmp4.core.platform.Platform(name_or_connection: str | Transport | Backend, settings: Settings | None = None)

A modeling platform instance as a connection to a data backend. Enables the manipulation of data via the Facade instances.

To instantiate a new platform, provide a name which will be used to first search the local ‘platforms.toml’ file and then the ECE Manager API.

import ixmp4

platform = ixmp4.Platform("<name>")

You may override the settings the platform uses …

from ixmp4.conf.settings import Settings

platform = ixmp4.Platform("<name>", settings=Settings(manager_url="https://.../"))

…and provide a Backend or Transport class directly.

from ixmp4.transport import DirectTransport
from ixmp4.data.backend import Backend

platform = ixmp4.Platform(Backend(...))
# or
platform = ixmp4.Platform(DirectTransport.from_dsn(...))

Once created, the platform’s Facade attributes can be used to manipulate data:

Attribute	Service Facade Class	Object Facade Class
`runs`	`RunServiceFacade`	`Run`
`meta`	`PlatformRunMetaFacade`	`RunMetaDescriptor`/ `RunMetaDictFacade`
`iamc`	`PlatformIamcData`	`RunIamcData`
`models`	`ModelServiceFacade`	`Model`
`scenarios`	`ScenarioServiceFacade`	`Scenario`
`regions`	`RegionServiceFacade`	`Region`
`units`	`UnitServiceFacade`	`Unit`

NotFound: alias of PlatformNotFound

NotUnique: alias of PlatformNotUnique

settings: Settings: The settings object the platform is using.

backend: Backend: Central data layer object that is composed of services.

runs: RunServiceFacade: Facade instance to manage Run instances for a platform.

iamc: PlatformIamcData: Facade instance to query IAMC data globally for a platform.

models: ModelServiceFacade: Facade instance to manage Model instances for a platform.

regions: RegionServiceFacade: Facade instance to manage Region instances for a platform.

scenarios: ScenarioServiceFacade: Facade instance to manage Scenario instances for a platform.

units: UnitServiceFacade: Facade instance to manage Unit instances for a platform.

meta: PlatformRunMetaFacade: Facade instance to query run meta indicators globally for a platform.