Arcadia · Schema

StorageOptimizationSchedulesResponse

EnergyUtilitiesClean EnergyBilling DataInterval DataCarbonSolarTariff

Properties

Name Type Description
from_date_time string Start time corresponding to the beginning of the hour when the consumption and solar curves start. Echoed back from request parameters.
grid_to_site_kwh_ac array Amount of electricity flowing to site load from the grid (kWh AC).
grid_to_battery_kwh_ac array Amount of electricity flowing to the battery from the grid, before conversion with `battery_ac_to_dc_efficiency` (kWh AC).
solar_to_battery_kwh_dc array Amount of electricity flowing to the battery from PV solar generation, either without any conversion if `battery_dc_coupled` or after double-conversion with `solar_dc_to_ac_efficiency` * `battery_ac_t
solar_to_site_kwh_ac array Amount of electricity flowing to site load from PV solar generation, after conversion with `solar_dc_to_ac_efficiency` (kWh AC).
solar_to_grid_kwh_ac array Amount of electricity flowing to the grid from PV solar generation, after conversion with `solar_dc_to_ac_efficiency` (kWh AC).
solar_curtailed_kwh_dc array Amount of electricity from solar that goes unused (kWh DC).
battery_to_site_kwh_ac array Amount of electricity flowing to site load from the battery, after conversion with `battery_dc_to_ac_efficiency` (kWh AC).
battery_to_grid_kwh_ac array Amount of electricity flowing to the grid from battery, after conversion with `battery_dc_to_ac_efficiency` (kWh AC).
net_load_kwh_ac array Amount of electricity flowing from the grid if positive or to the grid if negative (kWh AC). Equals `grid_to_site_kwh_ac` + `grid_to_battery_kwh_ac` - `battery_to_grid_kwh_ac` - `solar_to_grid_kwh_ac`
battery_soc array Hourly battery state of charge (`0.0` - `1.0`, though in practice, all values will be between `battery_min_soc` and `battery_max_soc`). Multiply by `battery_nameplate_capacity` to get a timeseries of
View JSON Schema on GitHub

JSON Schema

arcadia-storage-optimization-schedules.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://api.arcadia.com/schemas/StorageOptimizationSchedulesResponse",
  "title": "StorageOptimizationSchedulesResponse",
  "type": "object",
  "properties": {
    "from_date_time": {
      "description": "Start time corresponding to the beginning of the hour when the consumption and solar curves start. Echoed back from request parameters.",
      "example": "2021-03-18T00:00:00-07:00",
      "type": "string",
      "format": "date-time"
    },
    "grid_to_site_kwh_ac": {
      "description": "Amount of electricity flowing to site load from the grid (kWh AC).",
      "example": [
        1.3,
        1.1,
        0,
        0
      ],
      "type": "array",
      "items": {
        "type": "number",
        "minimum": 0
      }
    },
    "grid_to_battery_kwh_ac": {
      "description": "Amount of electricity flowing to the battery from the grid, before conversion with `battery_ac_to_dc_efficiency` (kWh AC).",
      "example": [
        1.56,
        0,
        0,
        0
      ],
      "type": "array",
      "items": {
        "type": "number",
        "minimum": 0
      }
    },
    "solar_to_battery_kwh_dc": {
      "description": "Amount of electricity flowing to the battery from PV solar generation, either without any conversion if `battery_dc_coupled` or after double-conversion with `solar_dc_to_ac_efficiency` * `battery_ac_to_dc_efficiency` if not (kWh DC).",
      "example": [
        0,
        1.5,
        0,
        0
      ],
      "type": "array",
      "items": {
        "type": "number",
        "minimum": 0
      }
    },
    "solar_to_site_kwh_ac": {
      "description": "Amount of electricity flowing to site load from PV solar generation, after conversion with `solar_dc_to_ac_efficiency` (kWh AC).",
      "example": [
        0,
        0.1,
        1.3,
        1.5
      ],
      "type": "array",
      "items": {
        "type": "number",
        "minimum": 0
      }
    },
    "solar_to_grid_kwh_ac": {
      "description": "Amount of electricity flowing to the grid from PV solar generation, after conversion with `solar_dc_to_ac_efficiency` (kWh AC).",
      "example": [
        0,
        0,
        0.4,
        1.4
      ],
      "type": "array",
      "items": {
        "type": "number",
        "minimum": 0
      }
    },
    "solar_curtailed_kwh_dc": {
      "description": "Amount of electricity from solar that goes unused (kWh DC).",
      "example": [
        0,
        0,
        0,
        0
      ],
      "type": "array",
      "items": {
        "type": "number",
        "minimum": 0
      }
    },
    "battery_to_site_kwh_ac": {
      "description": "Amount of electricity flowing to site load from the battery, after conversion with `battery_dc_to_ac_efficiency` (kWh AC).",
      "example": [
        0,
        0,
        0.1,
        0.2
      ],
      "type": "array",
      "items": {
        "type": "number",
        "minimum": 0
      }
    },
    "battery_to_grid_kwh_ac": {
      "description": "Amount of electricity flowing to the grid from battery, after conversion with `battery_dc_to_ac_efficiency` (kWh AC).",
      "example": [
        0,
        0,
        0.1,
        0.2
      ],
      "type": "array",
      "items": {
        "type": "number",
        "minimum": 0
      }
    },
    "net_load_kwh_ac": {
      "description": "Amount of electricity flowing from the grid if positive or to the grid if negative (kWh AC). Equals `grid_to_site_kwh_ac` + `grid_to_battery_kwh_ac` - `battery_to_grid_kwh_ac` - `solar_to_grid_kwh_ac`.",
      "example": [
        1.86,
        1.1,
        -0.5,
        -1.6
      ],
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "battery_soc": {
      "description": "Hourly battery state of charge (`0.0` - `1.0`, though in practice, all values will be between `battery_min_soc` and `battery_max_soc`). Multiply by `battery_nameplate_capacity` to get a timeseries of kWh DC stored.",
      "example": [
        0.75,
        1,
        0.8,
        0.4
      ],
      "type": "array",
      "items": {
        "type": "number",
        "minimum": 0,
        "maximum": 1
      }
    }
  },
  "required": [
    "from_date_time",
    "grid_to_site_kwh_ac",
    "grid_to_battery_kwh_ac",
    "solar_to_battery_kwh_dc",
    "solar_to_site_kwh_ac",
    "solar_to_grid_kwh_ac",
    "solar_curtailed_kwh_dc",
    "battery_to_site_kwh_ac",
    "battery_to_grid_kwh_ac",
    "battery_soc"
  ],
  "additionalProperties": false
}