Appearance
API文档
1. 全年单母线仿真API和字段
- 单母线仿真将所有元件连接在一个母线上,进行优化配比计算。
1.1 API请求参数
json
{
"caseinfo_id": "467",
"caseroom_id": "3",
"name": "test",
"year": 2021,
"tz": "Asia/Shanghai",
"lat": 39.74,
"lon": 105.75,
"storage_power": 10.0,
"storage_hour": 2.0,
"storage_efficiency_store": 1.0,
"storage_efficiency_dispatch": 1.0,
"storage_standing_loss": 0.0,
"gen_cap": 50.0,
"down_grid_cap": 0.0,
"up_grid_cap": 0.0,
"solar_cap": 50.0,
"pv_inv_ratio": 1.3,
"wind_cap": 50.0,
"elec_load_cap": 50.0,
"heat_load_cap": 0.0,
"h2_load_cap": 0.0,
"is_elec_load_ts": false,
"is_h2_load_ts": false,
"is_heat_load_ts": false,
"gen_marginal_cost": 300.0,
"down_grid_marginal_cost": 0.0,
"up_grid_marginal_cost": 0.0,
"wind_marginal_cost": 200.0,
"solar_marginal_cost": 100.0,
"storage_marginal_cost": 10.0,
"gen_cap_extendable": false,
"wind_cap_extendable": false,
"solar_cap_extendable": false,
"storage_cap_extendable": false,
"gen_p_nom_min": 0.0,
"solar_p_nom_min": 0.0,
"wind_p_nom_min": 0.0,
"storage_p_nom_min": 0.0,
"gen_p_nom_max": 1000.0,
"solar_p_nom_max": 1000.0,
"wind_p_nom_max": 1000.0,
"storage_p_nom_max": 1000.0,
"gen_capital_cost": 256544.0,
"wind_capital_cost": 389358.0,
"solar_capital_cost": 1158285.0,
"storage_capital_cost": 366412.0,
"gen_start_up_cost": 0.0,
"gen_shut_down_cost": 0.0,
"correct_solar_hours": 2500.0,
"correct_wind_hours": 3000.0,
"control_load_cap": 0.0,
"control_load_p_min_pu": 0.5,
"control_load_p_max_pu": 1.0,
"control_load_marginal_cost": 3000.0,
"up_grid_max_year_cap": 0.0,
"down_grid_max_year_cap": 0.0,
"sum_grid_max_year_cap": 0.0,
"substract_grid_max_year_cap": 0.0,
"control_load_min_year_cap": 0.0,
"is_wind_power_ts": false,
"is_solar_power_ts": false,
"gen_p_min_pu": 0.45,
"min_re_load_percent": 0.0,
"min_re_available_percent": 0.0,
"gen_committable": false,
"gen_min_up_time": 6.0,
"gen_min_down_time": 6.0,
"control_load_ramp_limit": 0.2,
"solver_name": "cplex",
"freq": "1h",
"wind_build_year": 2020,
"wind_lifetime": 60,
"solar_build_year": 2020,
"solar_lifetime": 60,
"gen_build_year": 2020,
"gen_lifetime": 60,
"down_grid_build_year": 2020,
"down_grid_lifetime": 60,
"up_grid_build_year": 2020,
"up_grid_lifetime": 60,
"control_load_build_year": 2020,
"control_load_lifetime": 60,
"storage_build_year": 2020,
"storage_lifetime": 60,
"solar_decay": 0.008,
"wind_decay": 0.005,
"solar_cap_step": 5,
"wind_cap_step": 5,
"storage_cap_step": 5,
"gen_cap_step": 5,
"rate": 0.05,
"invest_table": [{"name": "风电", "type": "Wind", "init_capital_cost": 5500000, "replace_cost": 3300000, "replace_year": 25, "op_cost": 5000, "residual_value": 275000, "sum_dcf": -5487785, "annual_capital_cost": -389358, "cf": [-5500000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 275000], "dcf": [-5500000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 81208.26221688451]}, {"name": "光伏", "type": "PV", "init_capital_cost": 4200000, "replace_cost": 2520000, "replace_year": 20, "op_cost": 5000, "residual_value": 210000, "sum_dcf": -5156741, "annual_capital_cost": -365871, "cf": [-4200000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -2525000, -5000, -5000, -5000, -5000, 210000], "dcf": [-4200000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -951645.9442543259, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 62013.582056529995]}, {"name": "光热", "type": "PT", "init_capital_cost": 16500000, "replace_cost": 9900000, "replace_year": 30, "op_cost": 5000, "residual_value": 825000, "sum_dcf": -16325368, "annual_capital_cost": -1158285, "cf": [-16500000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 825000], "dcf": [-16500000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 243624.78665065355]}, {"name": "储能", "type": "ElecSto", "init_capital_cost": 4000000, "replace_cost": 2400000, "replace_year": 15, "op_cost": 5000, "residual_value": 200000, "sum_dcf": -5164374, "annual_capital_cost": -366412, "cf": [-4000000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -2405000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 200000], "dcf": [-4000000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -1156846.1209087828, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 59060.55433955237]}, {"name": " 火电", "type": "Thermal", "init_capital_cost": 3600000, "replace_cost": 2160000, "replace_year": 40, "op_cost": 5000, "residual_value": 180000, "sum_dcf": -3615839, "annual_capital_cost": -256544, "cf": [-3600000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 180000], "dcf": [-3600000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 53154.49890559714]}, {"name": "燃煤", "type": "Coal", "init_capital_cost": 3600000, "replace_cost": 2160000, "replace_year": 40, "op_cost": 5000, "residual_value": 180000, "sum_dcf": -3615839, "annual_capital_cost": -256544, "cf": [-3600000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 180000], "dcf": [-3600000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 53154.49890559714]}, {"name": "燃气", "type": "Gas", "init_capital_cost": 4500000, "replace_cost": 2700000, "replace_year": 40, "op_cost": 5000, "residual_value": 225000, "sum_dcf": -4502550, "annual_capital_cost": -319456, "cf": [-4500000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 225000], "dcf": [-4500000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 66443.12363199642]}, {"name": "燃油", "type": "Oil", "init_capital_cost": 4700000, "replace_cost": 2820000, "replace_year": 40, "op_cost": 5000, "residual_value": 235000, "sum_dcf": -4699597, "annual_capital_cost": -333436, "cf": [-4700000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 235000], "dcf": [-4700000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 69396.15134897403]}, {"name": "生物质", "type": "Biomass", "init_capital_cost": 3900000, "replace_cost": 3900000, "replace_year": 40, "op_cost": 5000, "residual_value": 195000, "sum_dcf": -3911409, "annual_capital_cost": -277514, "cf": [-3900000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 195000], "dcf": [-3900000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 57584.04048106357]}, {"name": "水电", "type": "Hydro", "init_capital_cost": 5400000, "replace_cost": 5400000, "replace_year": 60, "op_cost": 5000, "residual_value": 270000, "sum_dcf": -5389261, "annual_capital_cost": -382368, "cf": [-5400000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 270000], "dcf": [-5400000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 79731.74835839571]}, {"name": "抽水蓄能", "type": "HydroSto", "init_capital_cost": 6500000, "replace_cost": 6500000, "replace_year": 60, "op_cost": 5000, "residual_value": 325000, "sum_dcf": -6473020, "annual_capital_cost": -459261, "cf": [-6500000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 325000], "dcf": [-6500000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 95973.4008017726]}], "is_multi": false, "projectLifetime": 25, "grid_ramp_limit": 0.1
}
{
"caseinfo_id": "467",
"caseroom_id": "3",
"name": "test",
"year": 2021,
"tz": "Asia/Shanghai",
"lat": 39.74,
"lon": 105.75,
"storage_power": 10.0,
"storage_hour": 2.0,
"storage_efficiency_store": 1.0,
"storage_efficiency_dispatch": 1.0,
"storage_standing_loss": 0.0,
"gen_cap": 50.0,
"down_grid_cap": 0.0,
"up_grid_cap": 0.0,
"solar_cap": 50.0,
"pv_inv_ratio": 1.3,
"wind_cap": 50.0,
"elec_load_cap": 50.0,
"heat_load_cap": 0.0,
"h2_load_cap": 0.0,
"is_elec_load_ts": false,
"is_h2_load_ts": false,
"is_heat_load_ts": false,
"gen_marginal_cost": 300.0,
"down_grid_marginal_cost": 0.0,
"up_grid_marginal_cost": 0.0,
"wind_marginal_cost": 200.0,
"solar_marginal_cost": 100.0,
"storage_marginal_cost": 10.0,
"gen_cap_extendable": false,
"wind_cap_extendable": false,
"solar_cap_extendable": false,
"storage_cap_extendable": false,
"gen_p_nom_min": 0.0,
"solar_p_nom_min": 0.0,
"wind_p_nom_min": 0.0,
"storage_p_nom_min": 0.0,
"gen_p_nom_max": 1000.0,
"solar_p_nom_max": 1000.0,
"wind_p_nom_max": 1000.0,
"storage_p_nom_max": 1000.0,
"gen_capital_cost": 256544.0,
"wind_capital_cost": 389358.0,
"solar_capital_cost": 1158285.0,
"storage_capital_cost": 366412.0,
"gen_start_up_cost": 0.0,
"gen_shut_down_cost": 0.0,
"correct_solar_hours": 2500.0,
"correct_wind_hours": 3000.0,
"control_load_cap": 0.0,
"control_load_p_min_pu": 0.5,
"control_load_p_max_pu": 1.0,
"control_load_marginal_cost": 3000.0,
"up_grid_max_year_cap": 0.0,
"down_grid_max_year_cap": 0.0,
"sum_grid_max_year_cap": 0.0,
"substract_grid_max_year_cap": 0.0,
"control_load_min_year_cap": 0.0,
"is_wind_power_ts": false,
"is_solar_power_ts": false,
"gen_p_min_pu": 0.45,
"min_re_load_percent": 0.0,
"min_re_available_percent": 0.0,
"gen_committable": false,
"gen_min_up_time": 6.0,
"gen_min_down_time": 6.0,
"control_load_ramp_limit": 0.2,
"solver_name": "cplex",
"freq": "1h",
"wind_build_year": 2020,
"wind_lifetime": 60,
"solar_build_year": 2020,
"solar_lifetime": 60,
"gen_build_year": 2020,
"gen_lifetime": 60,
"down_grid_build_year": 2020,
"down_grid_lifetime": 60,
"up_grid_build_year": 2020,
"up_grid_lifetime": 60,
"control_load_build_year": 2020,
"control_load_lifetime": 60,
"storage_build_year": 2020,
"storage_lifetime": 60,
"solar_decay": 0.008,
"wind_decay": 0.005,
"solar_cap_step": 5,
"wind_cap_step": 5,
"storage_cap_step": 5,
"gen_cap_step": 5,
"rate": 0.05,
"invest_table": [{"name": "风电", "type": "Wind", "init_capital_cost": 5500000, "replace_cost": 3300000, "replace_year": 25, "op_cost": 5000, "residual_value": 275000, "sum_dcf": -5487785, "annual_capital_cost": -389358, "cf": [-5500000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 275000], "dcf": [-5500000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 81208.26221688451]}, {"name": "光伏", "type": "PV", "init_capital_cost": 4200000, "replace_cost": 2520000, "replace_year": 20, "op_cost": 5000, "residual_value": 210000, "sum_dcf": -5156741, "annual_capital_cost": -365871, "cf": [-4200000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -2525000, -5000, -5000, -5000, -5000, 210000], "dcf": [-4200000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -951645.9442543259, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 62013.582056529995]}, {"name": "光热", "type": "PT", "init_capital_cost": 16500000, "replace_cost": 9900000, "replace_year": 30, "op_cost": 5000, "residual_value": 825000, "sum_dcf": -16325368, "annual_capital_cost": -1158285, "cf": [-16500000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 825000], "dcf": [-16500000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 243624.78665065355]}, {"name": "储能", "type": "ElecSto", "init_capital_cost": 4000000, "replace_cost": 2400000, "replace_year": 15, "op_cost": 5000, "residual_value": 200000, "sum_dcf": -5164374, "annual_capital_cost": -366412, "cf": [-4000000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -2405000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 200000], "dcf": [-4000000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -1156846.1209087828, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 59060.55433955237]}, {"name": " 火电", "type": "Thermal", "init_capital_cost": 3600000, "replace_cost": 2160000, "replace_year": 40, "op_cost": 5000, "residual_value": 180000, "sum_dcf": -3615839, "annual_capital_cost": -256544, "cf": [-3600000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 180000], "dcf": [-3600000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 53154.49890559714]}, {"name": "燃煤", "type": "Coal", "init_capital_cost": 3600000, "replace_cost": 2160000, "replace_year": 40, "op_cost": 5000, "residual_value": 180000, "sum_dcf": -3615839, "annual_capital_cost": -256544, "cf": [-3600000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 180000], "dcf": [-3600000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 53154.49890559714]}, {"name": "燃气", "type": "Gas", "init_capital_cost": 4500000, "replace_cost": 2700000, "replace_year": 40, "op_cost": 5000, "residual_value": 225000, "sum_dcf": -4502550, "annual_capital_cost": -319456, "cf": [-4500000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 225000], "dcf": [-4500000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 66443.12363199642]}, {"name": "燃油", "type": "Oil", "init_capital_cost": 4700000, "replace_cost": 2820000, "replace_year": 40, "op_cost": 5000, "residual_value": 235000, "sum_dcf": -4699597, "annual_capital_cost": -333436, "cf": [-4700000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 235000], "dcf": [-4700000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 69396.15134897403]}, {"name": "生物质", "type": "Biomass", "init_capital_cost": 3900000, "replace_cost": 3900000, "replace_year": 40, "op_cost": 5000, "residual_value": 195000, "sum_dcf": -3911409, "annual_capital_cost": -277514, "cf": [-3900000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 195000], "dcf": [-3900000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 57584.04048106357]}, {"name": "水电", "type": "Hydro", "init_capital_cost": 5400000, "replace_cost": 5400000, "replace_year": 60, "op_cost": 5000, "residual_value": 270000, "sum_dcf": -5389261, "annual_capital_cost": -382368, "cf": [-5400000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 270000], "dcf": [-5400000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 79731.74835839571]}, {"name": "抽水蓄能", "type": "HydroSto", "init_capital_cost": 6500000, "replace_cost": 6500000, "replace_year": 60, "op_cost": 5000, "residual_value": 325000, "sum_dcf": -6473020, "annual_capital_cost": -459261, "cf": [-6500000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, -5000, 325000], "dcf": [-6500000, -4761.9047619047615, -4535.147392290249, -4319.18799265738, -4113.512373959409, -3917.630832342294, -3731.076983183137, -3553.406650650607, -3384.196810143435, -3223.0445810889855, -3069.5662677037953, -2923.3964454321863, -2784.1870908877963, -2651.6067532264724, -2525.3397649775925, -2405.08549045485, -2290.5576099570003, -2181.4834380542857, -2077.6032743374144, -1978.6697850832522, -1884.447414365002, -1794.7118232047637, -1709.2493554331081, -1627.8565289839125, -1550.33955141325, 95973.4008017726]}], "is_multi": false, "projectLifetime": 25, "grid_ramp_limit": 0.1
}
1.2 参数说明
参数名称 | 说明 | 备注 |
---|---|---|
caseinfo_id/caseroom_id/name | 案例信息id/案例所属房间id/案例名称 | 计算完成后,通过这三个参数,将结果数据存储到后端对应位置 |
year/tz/lat/lon | 年份/时区/纬度/经度 | 用于获取风光数据 |
storage_power | 储能功率 | |
storage_hour | 储能时间 | |
storage_efficiency_store | 充电效率 | |
storage_efficiency_dispatch | 放电效率 | |
storage_standing_loss | ||
gen_cap | 常规发电容量 | |
down_grid_cap | 下网容量 | |
up_grid_cap | 上网容量 | |
solar_cap | 光伏容量 | |
pv_inv_ratio | 光伏容配比 | |
wind_cap | 风电容量 | |
elec_load_cap | 电负荷 | 固定值 |
heat_load_cap | 热负荷 | 固定值 |
h2_load_cap | 氢负荷 | 固定值 |
is_elec_load_ts | 是否使用时序电负荷 | 设置为True时,需要设置elec_load_ts;设置为False时,需要设置elec_load_cap |
is_h2_load_ts | 是否使用时序氢负荷 | 设置为True时,需要设置h2_load_ts;设置为False时,需要设置h2_load_cap |
is_heat_load_ts | 是否使用时序热负荷 | 设置为True时,需要设置heat_load_ts;设置为False时,需要设置heat_load_cap |
gen_marginal_cost | 发电边际成本 | |
down_grid_marginal_cost | 下网边际成本 | |
up_grid_marginal_cost | 上网边际成本 | |
wind_marginal_cost | 风电边际成本 | |
solar_marginal_cost | 光伏边际成本 | |
storage_marginal_cost | 储能边际成本 | |
gen_cap_extendable | 是否常规发电扩容 | 设置为True时,需要设置gen_p_nom_min和gen_p_nom_max |
wind_cap_extendable | 是否风电扩容 | 设置为True时,需要设置wind_p_nom_min和wind_p_nom_max |
solar_cap_extendable | 是否光伏扩容 | 设置为True时,需要设置solar_p_nom_min和solar_p_nom_max |
storage_cap_extendable | 是否储能扩容 | 设置为True时,需要设置storage_p_nom_min和storage_p_nom_max |
gen_p_nom_min | 最小发电容量 | |
solar_p_nom_min | 最小光伏容量 | |
wind_p_nom_min | 最小风电容量 | |
storage_p_nom_min | 最小储能容量 | |
gen_p_nom_max | 最大发电容量 | |
solar_p_nom_max | 最大光伏容量 | |
wind_p_nom_max | 最大风电容量 | |
storage_p_nom_max | 最大储能容量 | |
gen_capital_cost | 常规发电建造成本 | |
wind_capital_cost | 风电建造成本 | |
solar_capital_cost | 光伏建造成本 | |
storage_capital_cost | 储能建造成本 | |
gen_start_up_cost | 发电启动成本 | |
gen_shut_down_cost | 发电停机成本 | |
correct_solar_hours | 光伏利用小时 | |
correct_wind_hours | 风电利用小时 | |
control_load_cap | 可调负荷容量 | |
control_load_p_min_pu | 可调最小比例 | |
control_load_p_max_pu | 可调最大比例 | |
control_load_marginal_cost | 可调负荷电价 | |
up_grid_max_year_cap | 年上网最大电量 | |
down_grid_max_year_cap | 年下网最大电量 | |
sum_grid_max_year_cap | 年上下网总额电量 | |
substract_grid_max_year_cap | 年上下网差额电量 | |
control_load_min_year_cap | 可调年最少用电量 | |
is_wind_power_ts | 是否使用时序风电出力 | 设置为True时,需要设置wind_power_ts |
is_solar_power_ts | 是否使用时序光伏出力 | 设置为True时,需要设置solar_power_ts |
gen_p_min_pu | 发电最小比例 | |
min_re_load_percent | 新能源渗透率约束(新能源实发/总负荷) | |
min_re_available_percent | 新能源利用率约束(新能源实发/新能源可发) | |
gen_committable | 常规发电是否考虑启停 | |
gen_min_up_time | 常规发电最小开机时间 | |
gen_min_down_time | 常规发电最小停机时间 | |
control_load_ramp_limit | 可调负荷爬坡率 | |
freq | 时间分辨率 | |
solar_decay | 光伏衰减率 | |
wind_decay | 风电衰减率 | |
solar_cap_step | 光伏容量步长 | |
wind_cap_step | 风电容量步长 | |
storage_cap_step | 储能容量步长 | |
gen_cap_step | 常规发电容量步长 | |
rate | 利率 | |
invest_table | 投资信息表 | |
is_multi | 是否多年仿真 | |
projectLifetime | 项目生命周期 | |
grid_ramp_limit | 电网爬坡率 |
1.3 API请求结果
json
{
"year_result": "snapshot,风电:有功,光伏:有功,发电:有功,下网:有功,储能:有功,电负荷:有功,热负荷:有功,氢负荷:有功\r\n2021-01-01 00:00,7.5,0.0,62.5,0.0,0.0,50.0,10.0,10.0\r\n2021-01-01 01:00,6.5,0.0,63.5,0.0,0.0,50.0,10.0,10.0\r\n2021-01-01 02:00,6.0,0.0,64.0,0.0,0.0,50.0,10.0,10.0\r\n后续省略8760行",
"month_result": "snapshot,风电:有功,光伏:有功,发电:有功,下网:有功,储能:有功,电负荷:有功,热负荷:有功,氢负荷:有功\r\n1,17.25,8.72,44.07,0.0,-0.04,50.0,10.0,10.0\r\n2,21.42,9.99,38.59,0.0,0.01,50.0,10.0,10.0\r\n3,16.3,10.58,43.13,0.0,-0.01,50.0,10.0,10.0\r\n4,15.62,11.4,43.03,0.0,-0.06,50.0,10.0,10.0\r\n5,14.85,11.7,43.42,0.0,0.04,50.0,10.0,10.0\r\n6,12.13,11.3,46.51,0.0,0.06,50.0,10.0,10.0\r\n7,19.61,11.58,38.97,0.0,-0.16,50.0,10.0,10.0\r\n8,9.0,11.15,49.76,0.0,0.09,50.0,10.0,10.0\r\n9,14.75,10.62,44.65,0.0,-0.02,50.0,10.0,10.0\r\n10,13.71,9.81,46.43,0.0,0.04,50.0,10.0,10.0\r\n11,17.93,8.76,43.38,0.0,-0.06,50.0,10.0,10.0\r\n12,14.46,8.23,47.2,0.0,0.11,50.0,10.0,10.0\r\n",
"week_result": "snapshot,风电:有功,光伏:有功,发电:有功,下网:有功,储能:有功,电负荷:有功,热负荷:有功,氢负荷:有功\r\n1,17.95,8.94,43.24,0.0,-0.12,50.0,10.0,10.0\r\n2,22.68,8.9,38.58,0.0,-0.16,50.0,10.0,10.0\r\n3,15.49,8.05,46.18,0.0,0.29,50.0,10.0,10.0\r\n4,14.88,8.97,46.31,0.0,-0.16,50.0,10.0,10.0\r\n5,16.52,9.08,44.39,0.0,0.0,50.0,10.0,10.0\r\n6,17.34,10.02,42.48,0.0,0.16,50.0,10.0,10.0\r\n7,24.06,10.61,35.36,0.0,-0.02,50.0,10.0,10.0\r\n8,27.74,10.23,32.12,0.0,-0.09,50.0,10.0,10.0\r\n9,17.98,10.36,41.79,0.0,-0.12,50.0,10.0,10.0\r\n10,10.32,10.51,49.17,0.0,0.0,50.0,10.0,10.0\r\n11,19.18,10.36,40.37,0.0,0.1,50.0,10.0,10.0\r\n12,13.41,11.19,45.4,0.0,0.0,50.0,10.0,10.0\r\n13,22.51,10.62,36.97,0.0,-0.1,50.0,10.0,10.0\r\n14,13.06,11.67,45.27,0.0,0.0,50.0,10.0,10.0\r\n15,13.79,11.65,44.56,0.0,0.0,50.0,10.0,10.0\r\n16,17.79,11.53,40.44,0.0,0.25,50.0,10.0,10.0\r\n17,17.31,11.36,41.75,0.0,-0.42,50.0,10.0,10.0\r\n18,17.81,11.59,40.84,0.0,-0.24,50.0,10.0,10.0\r\n19,16.23,11.11,42.6,0.0,0.07,50.0,10.0,10.0\r\n20,10.07,12.13,47.47,0.0,0.34,50.0,10.0,10.0\r\n21,13.02,11.83,45.15,0.0,0.0,50.0,10.0,10.0\r\n22,19.03,11.65,39.33,0.0,0.0,50.0,10.0,10.0\r\n23,11.34,11.3,47.36,0.0,0.0,50.0,10.0,10.0\r\n24,9.28,11.23,49.58,0.0,-0.1,50.0,10.0,10.0\r\n25,10.78,10.97,47.9,0.0,0.35,50.0,10.0,10.0\r\n26,11.74,11.55,46.84,0.0,-0.13,50.0,10.0,10.0\r\n27,9.79,11.23,48.99,0.0,0.0,50.0,10.0,10.0\r\n28,19.39,11.54,38.94,0.0,0.13,50.0,10.0,10.0\r\n29,24.98,12.07,33.3,0.0,-0.35,50.0,10.0,10.0\r\n30,25.58,11.46,33.32,0.0,-0.36,50.0,10.0,10.0\r\n31,11.45,11.75,46.56,0.0,0.24,50.0,10.0,10.0\r\n32,11.09,11.17,47.74,0.0,0.0,50.0,10.0,10.0\r\n33,7.48,11.22,51.3,0.0,0.0,50.0,10.0,10.0\r\n34,7.61,10.54,51.69,0.0,0.16,50.0,10.0,10.0\r\n35,8.97,10.38,50.65,0.0,0.0,50.0,10.0,10.0\r\n36,10.56,10.92,48.56,0.0,-0.03,50.0,10.0,10.0\r\n37,21.3,10.9,37.84,0.0,-0.04,50.0,10.0,10.0\r\n38,20.43,10.68,38.89,0.0,0.0,50.0,10.0,10.0\r\n39,9.62,10.1,50.28,0.0,0.0,50.0,10.0,10.0\r\n40,12.88,10.05,46.71,0.0,0.36,50.0,10.0,10.0\r\n41,27.62,10.32,32.44,0.0,-0.38,50.0,10.0,10.0\r\n42,9.91,10.14,49.94,0.0,0.0,50.0,10.0,10.0\r\n43,4.22,8.55,57.01,0.0,0.21,50.0,10.0,10.0\r\n44,15.74,8.02,46.04,0.0,0.2,50.0,10.0,10.0\r\n45,21.47,10.01,38.69,0.0,-0.16,50.0,10.0,10.0\r\n46,12.89,7.88,49.23,0.0,0.0,50.0,10.0,10.0\r\n47,19.23,9.21,41.58,0.0,-0.02,50.0,10.0,10.0\r\n48,16.15,9.0,44.78,0.0,0.07,50.0,10.0,10.0\r\n49,13.38,7.1,49.53,0.0,0.0,50.0,10.0,10.0\r\n50,13.49,7.94,48.65,0.0,-0.08,50.0,10.0,10.0\r\n51,21.27,8.52,40.27,0.0,-0.06,50.0,10.0,10.0\r\n52,10.17,8.82,50.66,0.0,0.35,50.0,10.0,10.0\r\n53,12.62,8.74,48.63,0.0,0.0,50.0,10.0,10.0\r\n",
"day_result": "snapshot,风电:有功,光伏:有功,发电:有功,下网:有功,储能:有功,电负荷:有功,热负荷:有功,氢负荷:有功\r\n1,10.38,9.46,50.17,0.0,0.0,50.0,10.0,10.0\r\n2,8.25,8.44,53.31,0.0,0.0,50.0,10.0,10.0\r\n3,19.25,8.33,42.42,0.0,0.0,50.0,10.0,10.0\r\n后续省略365天",
"opt_result": {
"总风电": 50,
"总光伏": 50,
"总常规发电": 50,
"下网": 0,
"上网": 0,
"可调负荷": 0,
"总储能": 10
},
"stat_result": {
"总常规机组装机": 50,
"总风电装机": 50,
"总光伏装机": 50,
"总储能功率": 10,
"总储能容量": 20,
"上网电价": 0,
"下网电价": 0,
"储能时长": 2,
"储能充电效率": 1,
"储能放电效率": 1,
"新能源本地渗透率": 0.4247,
"新能源限电率": 0.4047,
"新能源利用率": 0.5953,
"全年负荷电量": 438000,
"全年电负荷电量": 438000,
"全年氢负荷电量": 0,
"全年热负荷电量": 0,
"全年氨负荷电量": 0,
"全年最大负荷": 50,
"全年最小负荷": 50,
"全年光伏总发电量": 101669.21,
"全年风电总发电量": 84370.43,
"全年新能源总发电量": 186039.64,
"全年新能源总限电量": 126453.16,
"全年新能源总可发量": 312492.8,
"全年光伏扩容成本": 57914250,
"全年风电扩容成本": 19467900,
"全年常规机组总发电量": 251960.36,
"全年常规机组发电成本": 75588108,
"全年常规机组扩容成本": 12827200,
"全年上网总电量": 0,
"全年下网总电量": 0,
"全年上网电费": 0,
"全年下网电费": 0,
"全年储能总充电量": 7680.94,
"全年储能总放电量": 7680.94,
"全年储能总损失电量": 0,
"全年储能扩容成本": 7328240
}
}
{
"year_result": "snapshot,风电:有功,光伏:有功,发电:有功,下网:有功,储能:有功,电负荷:有功,热负荷:有功,氢负荷:有功\r\n2021-01-01 00:00,7.5,0.0,62.5,0.0,0.0,50.0,10.0,10.0\r\n2021-01-01 01:00,6.5,0.0,63.5,0.0,0.0,50.0,10.0,10.0\r\n2021-01-01 02:00,6.0,0.0,64.0,0.0,0.0,50.0,10.0,10.0\r\n后续省略8760行",
"month_result": "snapshot,风电:有功,光伏:有功,发电:有功,下网:有功,储能:有功,电负荷:有功,热负荷:有功,氢负荷:有功\r\n1,17.25,8.72,44.07,0.0,-0.04,50.0,10.0,10.0\r\n2,21.42,9.99,38.59,0.0,0.01,50.0,10.0,10.0\r\n3,16.3,10.58,43.13,0.0,-0.01,50.0,10.0,10.0\r\n4,15.62,11.4,43.03,0.0,-0.06,50.0,10.0,10.0\r\n5,14.85,11.7,43.42,0.0,0.04,50.0,10.0,10.0\r\n6,12.13,11.3,46.51,0.0,0.06,50.0,10.0,10.0\r\n7,19.61,11.58,38.97,0.0,-0.16,50.0,10.0,10.0\r\n8,9.0,11.15,49.76,0.0,0.09,50.0,10.0,10.0\r\n9,14.75,10.62,44.65,0.0,-0.02,50.0,10.0,10.0\r\n10,13.71,9.81,46.43,0.0,0.04,50.0,10.0,10.0\r\n11,17.93,8.76,43.38,0.0,-0.06,50.0,10.0,10.0\r\n12,14.46,8.23,47.2,0.0,0.11,50.0,10.0,10.0\r\n",
"week_result": "snapshot,风电:有功,光伏:有功,发电:有功,下网:有功,储能:有功,电负荷:有功,热负荷:有功,氢负荷:有功\r\n1,17.95,8.94,43.24,0.0,-0.12,50.0,10.0,10.0\r\n2,22.68,8.9,38.58,0.0,-0.16,50.0,10.0,10.0\r\n3,15.49,8.05,46.18,0.0,0.29,50.0,10.0,10.0\r\n4,14.88,8.97,46.31,0.0,-0.16,50.0,10.0,10.0\r\n5,16.52,9.08,44.39,0.0,0.0,50.0,10.0,10.0\r\n6,17.34,10.02,42.48,0.0,0.16,50.0,10.0,10.0\r\n7,24.06,10.61,35.36,0.0,-0.02,50.0,10.0,10.0\r\n8,27.74,10.23,32.12,0.0,-0.09,50.0,10.0,10.0\r\n9,17.98,10.36,41.79,0.0,-0.12,50.0,10.0,10.0\r\n10,10.32,10.51,49.17,0.0,0.0,50.0,10.0,10.0\r\n11,19.18,10.36,40.37,0.0,0.1,50.0,10.0,10.0\r\n12,13.41,11.19,45.4,0.0,0.0,50.0,10.0,10.0\r\n13,22.51,10.62,36.97,0.0,-0.1,50.0,10.0,10.0\r\n14,13.06,11.67,45.27,0.0,0.0,50.0,10.0,10.0\r\n15,13.79,11.65,44.56,0.0,0.0,50.0,10.0,10.0\r\n16,17.79,11.53,40.44,0.0,0.25,50.0,10.0,10.0\r\n17,17.31,11.36,41.75,0.0,-0.42,50.0,10.0,10.0\r\n18,17.81,11.59,40.84,0.0,-0.24,50.0,10.0,10.0\r\n19,16.23,11.11,42.6,0.0,0.07,50.0,10.0,10.0\r\n20,10.07,12.13,47.47,0.0,0.34,50.0,10.0,10.0\r\n21,13.02,11.83,45.15,0.0,0.0,50.0,10.0,10.0\r\n22,19.03,11.65,39.33,0.0,0.0,50.0,10.0,10.0\r\n23,11.34,11.3,47.36,0.0,0.0,50.0,10.0,10.0\r\n24,9.28,11.23,49.58,0.0,-0.1,50.0,10.0,10.0\r\n25,10.78,10.97,47.9,0.0,0.35,50.0,10.0,10.0\r\n26,11.74,11.55,46.84,0.0,-0.13,50.0,10.0,10.0\r\n27,9.79,11.23,48.99,0.0,0.0,50.0,10.0,10.0\r\n28,19.39,11.54,38.94,0.0,0.13,50.0,10.0,10.0\r\n29,24.98,12.07,33.3,0.0,-0.35,50.0,10.0,10.0\r\n30,25.58,11.46,33.32,0.0,-0.36,50.0,10.0,10.0\r\n31,11.45,11.75,46.56,0.0,0.24,50.0,10.0,10.0\r\n32,11.09,11.17,47.74,0.0,0.0,50.0,10.0,10.0\r\n33,7.48,11.22,51.3,0.0,0.0,50.0,10.0,10.0\r\n34,7.61,10.54,51.69,0.0,0.16,50.0,10.0,10.0\r\n35,8.97,10.38,50.65,0.0,0.0,50.0,10.0,10.0\r\n36,10.56,10.92,48.56,0.0,-0.03,50.0,10.0,10.0\r\n37,21.3,10.9,37.84,0.0,-0.04,50.0,10.0,10.0\r\n38,20.43,10.68,38.89,0.0,0.0,50.0,10.0,10.0\r\n39,9.62,10.1,50.28,0.0,0.0,50.0,10.0,10.0\r\n40,12.88,10.05,46.71,0.0,0.36,50.0,10.0,10.0\r\n41,27.62,10.32,32.44,0.0,-0.38,50.0,10.0,10.0\r\n42,9.91,10.14,49.94,0.0,0.0,50.0,10.0,10.0\r\n43,4.22,8.55,57.01,0.0,0.21,50.0,10.0,10.0\r\n44,15.74,8.02,46.04,0.0,0.2,50.0,10.0,10.0\r\n45,21.47,10.01,38.69,0.0,-0.16,50.0,10.0,10.0\r\n46,12.89,7.88,49.23,0.0,0.0,50.0,10.0,10.0\r\n47,19.23,9.21,41.58,0.0,-0.02,50.0,10.0,10.0\r\n48,16.15,9.0,44.78,0.0,0.07,50.0,10.0,10.0\r\n49,13.38,7.1,49.53,0.0,0.0,50.0,10.0,10.0\r\n50,13.49,7.94,48.65,0.0,-0.08,50.0,10.0,10.0\r\n51,21.27,8.52,40.27,0.0,-0.06,50.0,10.0,10.0\r\n52,10.17,8.82,50.66,0.0,0.35,50.0,10.0,10.0\r\n53,12.62,8.74,48.63,0.0,0.0,50.0,10.0,10.0\r\n",
"day_result": "snapshot,风电:有功,光伏:有功,发电:有功,下网:有功,储能:有功,电负荷:有功,热负荷:有功,氢负荷:有功\r\n1,10.38,9.46,50.17,0.0,0.0,50.0,10.0,10.0\r\n2,8.25,8.44,53.31,0.0,0.0,50.0,10.0,10.0\r\n3,19.25,8.33,42.42,0.0,0.0,50.0,10.0,10.0\r\n后续省略365天",
"opt_result": {
"总风电": 50,
"总光伏": 50,
"总常规发电": 50,
"下网": 0,
"上网": 0,
"可调负荷": 0,
"总储能": 10
},
"stat_result": {
"总常规机组装机": 50,
"总风电装机": 50,
"总光伏装机": 50,
"总储能功率": 10,
"总储能容量": 20,
"上网电价": 0,
"下网电价": 0,
"储能时长": 2,
"储能充电效率": 1,
"储能放电效率": 1,
"新能源本地渗透率": 0.4247,
"新能源限电率": 0.4047,
"新能源利用率": 0.5953,
"全年负荷电量": 438000,
"全年电负荷电量": 438000,
"全年氢负荷电量": 0,
"全年热负荷电量": 0,
"全年氨负荷电量": 0,
"全年最大负荷": 50,
"全年最小负荷": 50,
"全年光伏总发电量": 101669.21,
"全年风电总发电量": 84370.43,
"全年新能源总发电量": 186039.64,
"全年新能源总限电量": 126453.16,
"全年新能源总可发量": 312492.8,
"全年光伏扩容成本": 57914250,
"全年风电扩容成本": 19467900,
"全年常规机组总发电量": 251960.36,
"全年常规机组发电成本": 75588108,
"全年常规机组扩容成本": 12827200,
"全年上网总电量": 0,
"全年下网总电量": 0,
"全年上网电费": 0,
"全年下网电费": 0,
"全年储能总充电量": 7680.94,
"全年储能总放电量": 7680.94,
"全年储能总损失电量": 0,
"全年储能扩容成本": 7328240
}
}
1.4 结果字段说明
字段 | 说明 | 备注 |
---|---|---|
year_result | 一年里每小时的结果 | 包含常规发电有功、风电有功、光伏有功、上网有功、下网有功、储能有功、可调负荷有功、电负荷有功、氢负荷有功、热负荷有功等 |
month_result | 一年里每月的结果 | 包含常规发电有功、风电有功、光伏有功、上网有功、下网有功、储能有功、可调负荷有功、电负荷有功、氢负荷有功、热负荷有功等 |
week_result | 一年里每周的结果 | 包含常规发电有功、风电有功、光伏有功、上网有功、下网有功、储能有功、可调负荷有功、电负荷有功、氢负荷有功、热负荷有功等 |
day_result | 一年里每天的结果 | 包含常规发电有功、风电有功、光伏有功、上网有功、下网有功、储能有功、可调负荷有功、电负荷有功、氢负荷有功、热负荷有功等 |
opt_result | 优化后的常规发电、光伏、风电、储能容量 | |
stat_result | 统计后的全年结果 | 包含各组件的发电量、发电成本,各负荷的用电量等 |
2. 全年多母线仿真API和字段
2.1 母线Bus
属性 | 类型 | 单位 | 默认 | 描述 | 状态 |
---|---|---|---|---|---|
name | string | 无 | 无 | 唯一名称 | 输入(必填) |
v_nom | float | kV | 1 | 标称电压 | 输入(可选) |
type | string | 无 | 无 | 母线类型的占位符 | 输入(可选) |
x | float | 无 | 0 | 位置(例如经度) | 输入(可选) |
y | float | 无 | 0 | 位置(例如纬度) | 输入(可选) |
carrier | string | 无 | AC | 能源载体:可以是电母线的“AC”或“DC”,或是“热”或“气”。 | 输入(可选) |
p | series | MW | 0 | 母线有功功率(母线净发电时为正) | 输出 |
q | series | MVar | 0 | 无功功率(如果在母线上净发电,则为正) | 输出 |
v_mag_pu | series | pu | 1 | 电压幅度,每单位 v_nom | 输出 |
v_ang | series | degree | 0 | 电压角 | 输出 |
marginal_price | series | ¥/MWh | 0 | 来自功率平衡约束的 LOPF 的位置边际价格 | 输出 |
2.2 能量载体 Carrier
属性 | 类型 | 单位 | 默认 | 描述 | 状态 |
---|---|---|---|---|---|
name | string | n/a | n/a | 唯一名称 | 输入(必填) |
co2_emissions | float | 吨/MWh | 0 | 每 MWh 一次能源的 CO2 吨当量排放量(例如甲烷有 0.2 吨 CO2/MWh_热能)。 | 输入(可选) |
2.3 发电 Generator(包括光伏、风电、燃机、其他能源发电等)
属性 | 类型 | 单位 | 默认 | 描述 | 状态 |
---|---|---|---|---|---|
name | string | n/a | n/a | 唯一名称 | 输入(必填) |
bus | string | n/a | n/a | 连接发电机的母线名称 | 输入(必填) |
type | string | n/a | n/a | 发电类型的占位符。 | 输入(可选) |
p_nom | float | MW | 0 | OPF限制的标称功率。 | 输入(可选) |
p_nom_extendable | boolean | n/a | False | 切换以允许在 OPF 中扩展容量 p_nom。 | 输入(可选) |
p_nom_min | float | MW | 0 | 如果 p_nom 在 OPF 中是可扩展的,则设置其最小值。 | 输入(可选) |
p_nom_max | float | MW | inf | 如果 p_nom 在 OPF 中是可扩展的,则设置其最大值(例如受技术潜力限制)。 | 输入(可选) |
p_min_pu | static or series | per unit | 0 | OPF 的每单位 p_nom 的每个时刻的最小输出。请注意,如果 committable 为 False 且 p_min_pu > 0,则表示必须运行条件。 | 输入(可选) |
p_max_pu | static or series | per unit | 1 | OPF 每单位 p_nom 的每个时刻的最大输出。 | 输入(可选) |
p_set | static or series | MW | 0 | 有功功率设定点(PF) | 输入(可选) |
q_set | static or series | MVar | 0 | 无功功率设定点(PF) | 输入(可选) |
sign | float | n/a | 1 | 电源标志 | 输入(可选) |
carrier | string | n/a | n/a | 原动机能源载体(例如煤炭、天然气、风能、太阳能);OPF 中一次能源的全球约束要求 | 输入(可选) |
marginal_cost | static or series | ¥/MWh | 0 | 边际生产成本为 1 MWh。 | 输入(可选) |
build_year | int | year | 0 | 建造年份 | 输入(可选) |
lifetime | float | years | inf | 寿命 | 输入(可选) |
capital_cost | float | ¥/MW | 0 | 将 p_nom 扩展 1 MW 的资本成本。 | 输入(可选) |
efficiency | float | per unit | 1 | 一次能源和电能之间的比率,例如,对于气体,取值为 0.4 MWh_elec/MWh_thermal。这是对 OPF 中一次能源的全球限制所必需的。 | 输入(可选) |
committable | boolean | n/a | False | 使用机组组合(仅当 p_nom 不可扩展时才可能)。 | 输入(可选) |
start_up_cost | float | currency | 0 | 启动发电机的成本。仅当可提交为 True 时才读取。 | 输入(可选) |
shut_down_cost | float | currency | 0 | 关闭发电机的成本。仅当可提交为 True 时才读取。 | 输入(可选) |
min_up_time | int | snapshots | 0 | 状态为 1 的最小时刻数。仅当可提交为 True 时才读取。 | 输入(可选) |
min_down_time | int | snapshots | 0 | 状态为 0 的最小时刻数。仅当 committable 为 True 时才读取。 | 输入(可选) |
up_time_before | int | snapshots | 1 | 在 network.snapshots 开始之前发电机在线的时刻数。仅当 committable 为 True 且 min_up_time 非零时才读取。 | 输入(可选) |
down_time_before | int | snapshots | 0 | 在 network.snapshots 开始之前生成器在线的时刻数。仅当 committable 为 True 且 min_down_time 非零时才读取。 | 输入(可选) |
ramp_limit_up | float | per unit | NaN | 每单位标称功率,从一个时刻到下一个时刻的最大有功功率增加。如果为 NaN,则忽略。 | 输入(可选) |
ramp_limit_down | float | per unit | NaN | 每单位标称功率,从一个时刻到下一个时刻的最大有功功率减少。如果为 NaN,则忽略。 | 输入(可选) |
p | series | MW | 0 | 母线有功功率(净发电时为正) | 输出 |
q | series | MVar | 0 | 无功功率(净发电时为正) | 输出 |
p_nom_opt | float | MW | 0 | 优化的标称功率。 | 输出 |
status | series | n/a | 1 | 状态(1 开启,0 关闭)。仅当可提交为 True 时才输出。 | 输出 |
2.4 电储能 StorageUnit
属性 | 类型 | 单位 | 默认 | 描述 | 状态 |
---|---|---|---|---|---|
name | string | n/a | n/a | 唯一名称 | 输入(必填) |
bus | string | n/a | n/a | 储能单元连接到的母线的名称。 | 输入(必填) |
p_nom | float | MW | 0 | OPF 限制的标称功率。 | 输入(可选) |
p_nom_extendable | boolean | n/a | False | 切换以允许在 OPF 中扩展容量 p_nom。 | 输入(可选) |
p_nom_min | float | MW | 0 | 如果 p_nom 在 OPF 中是可扩展的,则设置其最小值。 | 输入(可选) |
p_nom_max | float | MW | inf | 如果 p_nom 在 OPF 中是可扩展的,则设置其最大值(例如受电位限制)。 | 输入(可选) |
p_min_pu | static or series | per unit | -1 | OPF 每单位 p_nom 的每个时刻的最小输出。 | 输入(可选) |
p_max_pu | static or series | per unit | 1 | OPF 每单位 p_nom 的每个时刻的最大输出。 | 输入(可选) |
p_set | static or series | MW | 0 | 有功功率设定点(PF) | 输入(可选) |
q_set | static or series | MVar | 0 | 无功功率设定点(PF) | 输入(可选) |
sign | float | n/a | 1 | 电源标志 | 输入(可选) |
carrier | string | n/a | n/a | 原动机能源载体(例如煤炭、天然气、风能、太阳能);OPF 中一次能源的全球约束要求 | 输入(可选) |
marginal_cost | static or series | ¥/MWh | 0 | 边际生产成本为 1 MWh。 | 输入(可选) |
capital_cost | float | ¥/MW | 0 | 将 p_nom 扩展 1 MW 的资本成本。 | 输入(可选) |
build_year | int | year | 0 | 建造年份 | 输入(可选) |
lifetime | float | years | inf | 寿命 | 输入(可选) |
state_of_charge_initial | float | MWh | 0 | OPF 中时刻之前的充电状态。 | 输入(可选) |
state_of_charge_initial_per_period | boolean | n/a | False | 开关:如果为 True,则投资期开始时的充电状态设置为 state_of_charge_initial | 输入(可选) |
state_of_charge_set | static or series | MWh | NaN | OPF 中时刻的充电状态设置点。 | 输入(可选) |
max_hours | float | hours | 1 | 以小时计的最大充电容量状态在满输出容量 p_nom | 输入(可选) |
efficiency_store | float | per unit | 1 | 入库途中的入库效率。 | 输入(可选) |
efficiency_dispatch | float | per unit | 1 | 出库途中的存储效率。 | 输入(可选) |
standing_loss | float | per unit | 0 | 每小时到充电状态的损失。 | 输入(可选) |
p | series | MW | 0 | 母线有功功率(净发电时为正) | 输出 |
p_dispatch | series | MW | 0 | 公交有功功率调度 | 输出 |
p_store | series | MW | 0 | 公交车有功充电 | 输出 |
q | series | MVar | 0 | 无功功率(净发电时为正) | 输出 |
state_of_charge | series | MWh | NaN | 由 OPF 计算的充电状态。 | 输出 |
p_nom_opt | float | MW | 0 | 优化的标称功率。 | 输出 |
2.5 负荷 Load
属性 | 类型 | 单位 | 默认 | 描述 | 状态 |
---|---|---|---|---|---|
name | string | n/a | n/a | 唯一名称 | 输入(必填) |
bus | string | n/a | n/a | 连接负载的母线名称。 | 输入(必填) |
carrier | string | n/a | n/a | 能源载体:可以是电动公交车的“AC”或“DC”,也可以是“热”或“气”。 | 输入(可选) |
type | string | n/a | n/a | 负载类型的占位符。尚未实现。 | 输入(可选) |
p_set | static or series | MW | 0 | 有功功耗(如果负载正在消耗功率,则为正)。 | 输入(可选) |
q_set | static or series | MVar | 0 | 无功功耗(如果负载为感性,则为正)。 | 输入(可选) |
sign | float | n/a | -1 | 电源标志(与发电机相反的标志) | 输入(可选) |
p | series | MW | 0 | 母线上的有功功率(净负载为正) | 输出 |
q | series | MVar | 0 | 无功功率(净负载为正) | 输出 |
2.6 线路 Line
属性 | 类型 | 单位 | 默认 | 描述 | 状态 |
---|---|---|---|---|---|
name | string | n/a | n/a | 唯一名称 | 输入(必填) |
bus0 | string | n/a | n/a | 分支连接到的第一条母线的名称。 | 输入(必填) |
bus1 | string | n/a | n/a | 分支连接到的第二条母线的名称。 | 输入(必填) |
type | string | n/a | n/a | 线标准类型的名称。 | 输入(可选) |
x | float | Ohm | 0 | 对于线性潮流中的交流支路,串联电抗必须非零。如果线路有串联电感L那时在亨利x=2πfL。此处f是以赫兹为单位的频率。串联阻抗z=r+jx对于非线性潮流,它必须是非零的。 | 输入(必填) |
r | float | Ohm | 0 | 串联电阻,对于线性潮流中的直流支路,必须非零。串联阻抗z=r+jx对于非线性潮流,它必须是非零的。如果定义了类型,则忽略。 | 输入(必填) |
g | float | Siemens | 0 | 分流电导率。分流导纳是y=g+jb. | 输入(可选) |
b | float | Siemens | 0 | 分流电纳。如果线路有并联电容C然后在法拉b=2πfC在哪里f是以赫兹为单位的频率。分流导纳是y=g+jb. 如果定义了类型,则忽略。 | 输入(可选) |
s_nom | float | MVA | 0 | 可通过支路的视在功率极限。 | 输入(可选) |
s_nom_extendable | boolean | n/a | False | 切换以允许在 OPF 中扩展容量 s_nom。 | 输入(可选) |
s_nom_min | float | MVA | 0 | 如果 s_nom 在 OPF 中是可扩展的,则设置其最小值。 | 输入(可选) |
s_nom_max | float | MVA | inf | 如果 s_nom 在 OPF 中是可扩展的,则设置其最大值(例如受电位限制)。 | 输入(可选) |
s_max_pu | static or series | per unit | 1 | OPF 的每单位 s_nom 允许的最大绝对流量(例如,可以设置为 <1 以接近 n-1 因子,或者可以随时间变化以表示架空线路的与天气相关的动态线路额定值)。 | 输入(可选) |
capital_cost | float | currency/MVA | 0 | 将 s_nom 扩展 1 MVA 的资本成本。 | 输入(可选) |
build_year | int | year | 0 | 建造年份 | 输入(可选) |
lifetime | float | years | inf | 寿命 | 输入(可选) |
length | float | km | 0 | 设置“类型”时使用的行的长度,对于计算资本成本也很有用。 | 输入(可选) |
carrier | string | n/a | 电流类型,“AC”是唯一有效值 | 输入(可选) | |
p0 | series | MW | 0 | 母线 0 的有功功率(如果分支正在从母线 0 撤出电源,则为正)。 | 输出 |
q0 | series | MVar | 0 | 母线 0 的无功功率(如果分支正在从母线 0 撤出功率,则为正)。 | 输出 |
p1 | series | MW | 0 | 母线 1 的有功功率(如果分支正在从母线 1 撤出电源,则为正)。 | 输出 |
q1 | series | MVar | 0 | 母线 1 的无功功率(如果支路从母线 1 撤出功率,则为正)。 | 输出 |
x_pu | float | per unit | 0 | 从 x 和 bus.v_nom 计算的每单位串联电抗。 | 输出 |
r_pu | float | per unit | 0 | 从 r 和 bus.v_nom 计算的每单位串联电阻 | 输出 |
g_pu | float | per unit | 0 | 从 g 和 bus.v_nom 计算的每单位分流电导率 | 输出 |
b_pu | float | per unit | 0 | 从 b 和 bus.v_nom 计算的每单位分流电纳 | 输出 |
s_nom_opt | float | MVA | 0 | 优化视在功率容量。 | 输出 |
2.7 直流线路 Link
属性 | 类型 | 单位 | 默认 | 描述 | 状态 |
---|---|---|---|---|---|
name | string | n/a | n/a | 唯一名称 | 输入(必填) |
bus0 | string | n/a | n/a | 连接链路的第一条母线的名称。 | 输入(必填) |
bus1 | string | n/a | n/a | 连接链路的第二条母线的名称。 | 输入(必填) |
type | string | n/a | n/a | 链接类型的占位符。尚未实现。 | 输入(可选) |
carrier | string | n/a | 链路传输的能量载体:可以是电气 HVDC 链路的“DC”,也可以是“热”或“气”等。 | 输入(可选) | |
efficiency | static or series | per unit | 1 | 从 bus0 到 bus1 的电力传输效率。(可以是时间相关的,以表示从电动到热母线的热泵的温度相关性能系数。) | 输入(可选) |
build_year | int | year | 0 | 建造年份 | 输入(可选) |
lifetime | float | years | inf | 寿命 | 输入(可选) |
p_nom | float | MVA | 0 | 可以通过链路的有功功率限制。 | 输入(可选) |
p_nom_extendable | boolean | n/a | False | 切换以允许在 OPF 中扩展容量 p_nom。 | 输入(可选) |
p_nom_min | float | MVA | 0 | 如果 p_nom 在 OPF 中是可扩展的,则设置其最小值。 | 输入(可选) |
p_nom_max | float | MVA | inf | 如果 p_nom 在 OPF 中是可扩展的,则设置其最大值(例如受电位限制)。 | 输入(可选) |
p_set | static or series | MW | 0 | PF 中链路 p0 的调度设定点。 | 输入(可选) |
p_min_pu | static or series | per unit of p_nom | 0 | OPF 中链接的每单位 p_nom 的最小调度(也可以是负数)。 | 输入(可选) |
p_max_pu | static or series | per unit of p_nom | 1 | OPF 中链接的每单位 p_nom 的最大调度(也可以是负数)。 | 输入(可选) |
capital_cost | float | currency/MW | 0 | 将 p_nom 扩展 1 MW 的资本成本。 | 输入(可选) |
marginal_cost | static or series | currency/MWh | 0 | 将 1 MWh(在效率损失之前)从母线 0 转移到母线 1 的边际成本。注意:仅当 p_max_pu >= 0 时,边际成本在 OPF 中才有意义。 | 输入(可选) |
length | float | km | 0 | 线的长度,用于计算资本成本。 | 输入(可选) |
p0 | series | MW | 0 | 母线 0 的有功功率(如果分支正在从母线 0 撤出电源,则为正)。 | 输出 |
p1 | series | MW | 0 | 母线 1 的有功功率(如果分支正在从母线 1 撤出电源,则为正)。 | 输出 |
p_nom_opt | float | MVA | 0 | 优化的有功功率容量。 | 输出 |
2.8 变换器 Converter
属性 | 类型 | 单位 | 默认 | 描述 | 状态 |
---|---|---|---|---|---|
name | string | n/a | n/a | 变换器名称 | 输入(必填) |
bus0 | string | n/a | n/a | 变换器的第一个母线的名称 | 输入(必填) |
bus1 | string | n/a | n/a | 变换器的第二个母线的名称 | 输入(必填) |
bus2 | string | n/a | n/a | 变换器的第三个母线的名称 | 输入(必填) |
bus3 | string | n/a | n/a | 变换器的第四个母线的名称 | 输入(必填) |
carrier | string | n/a | 链路传输的能量载体:可以是电气 HVDC 链路的“DC”,也可以是“热”或“气”等。 | 输入(可选) | |
efficiency | static or series | per unit | 1 | 从 bus0 到 bus1 的转换效率。 | 输入(可选) |
efficiency2 | static or series | per unit | 1 | 从 bus0 到 bus2 的转换效率。 | 输入(可选) |
efficiency3 | static or series | per unit | 1 | 从 bus0 到 bus3 的转换效率 | 输入(可选) |
build_year | int | year | 0 | 建造年份 | 输入(可选) |
lifetime | float | years | inf | 寿命 | 输入(可选) |
p_nom | float | MVA | 0 | 可以通过链路的有功功率限制。 | 输入(可选) |
p_nom_extendable | boolean | n/a | False | 切换以允许在 OPF 中扩展容量 p_nom。 | 输入(可选) |
p_nom_min | float | MVA | 0 | 如果 p_nom 在 OPF 中是可扩展的,则设置其最小值。 | 输入(可选) |
p_nom_max | float | MVA | inf | 如果 p_nom 在 OPF 中是可扩展的,则设置其最大值(例如受电位限制)。 | 输入(可选) |
p_set | static or series | MW | 0 | PF 中链路 p0 的调度设定点。 | 输入(可选) |
p_min_pu | static or series | per unit of p_nom | 0 | OPF 中链接的每单位 p_nom 的最小调度(也可以是负数)。 | 输入(可选) |
p_max_pu | static or series | per unit of p_nom | 1 | OPF 中链接的每单位 p_nom 的最大调度(也可以是负数)。 | 输入(可选) |
capital_cost | float | currency/MW | 0 | 将 p_nom 扩展 1 MW 的资本成本。 | 输入(可选) |
marginal_cost | static or series | currency/MWh | 0 | 将 1 MWh(在效率损失之前)从母线 0 转移到母线 1 的边际成本。注意:仅当 p_max_pu >= 0 时,边际成本在 OPF 中才有意义。 | 输入(可选) |
length | float | km | 0 | 线的长度,用于计算资本成本。 | 输入(可选) |
p0 | series | MW | 0 | 母线0的有功功率。 | 输出 |
p1 | series | MW | 0 | 母线1的有功功率。 | 输出 |
p2 | series | MW | 0 | 母线2的有功功率。 | 输出 |
p3 | series | MW | 0 | 母线3的有功功率。 | 输出 |
p_nom_opt | float | MVA | 0 | 优化的有功功率容量。 | 输出 |
3. 气象数据API
3.1 气候历史数据
- GET /weather/nasaClimatology?parameters=T2M&lon=119.5&lat=32.5
返回值:
json
{
"type":"Feature",
"geometry":{
"type":"Point",
"coordinates":[
119.5,
32.5,
12.19
]
},
"properties":{
"parameter":{
"T2M":{
"JAN":1.8,
"FEB":4.38,
"MAR":9.29,
"APR":15.58,
"MAY":21.42,
"JUN":25.4,
"JUL":28.07,
"AUG":27.45,
"SEP":23.02,
"OCT":17.28,
"NOV":10.66,
"DEC":3.65,
"ANN":15.72
}
}
},
"header":{
"title":"NASA/POWER CERES/MERRA2 Native Resolution Climatology Climatologies",
"api":{
"version":"v2.3.10",
"name":"POWER Climatology API"
},
"sources":[
"merra2"
],
"fill_value":-999,
"range":"20-year Meteorological and Solar Monthly & Annual Climatologies (January 2001 - December 2020)"
},
"messages":[
],
"parameters":{
"T2M":{
"units":"C",
"longname":"Temperature at 2 Meters"
}
},
"times":{
"data":6.191,
"process":0.47
}
}
{
"type":"Feature",
"geometry":{
"type":"Point",
"coordinates":[
119.5,
32.5,
12.19
]
},
"properties":{
"parameter":{
"T2M":{
"JAN":1.8,
"FEB":4.38,
"MAR":9.29,
"APR":15.58,
"MAY":21.42,
"JUN":25.4,
"JUL":28.07,
"AUG":27.45,
"SEP":23.02,
"OCT":17.28,
"NOV":10.66,
"DEC":3.65,
"ANN":15.72
}
}
},
"header":{
"title":"NASA/POWER CERES/MERRA2 Native Resolution Climatology Climatologies",
"api":{
"version":"v2.3.10",
"name":"POWER Climatology API"
},
"sources":[
"merra2"
],
"fill_value":-999,
"range":"20-year Meteorological and Solar Monthly & Annual Climatologies (January 2001 - December 2020)"
},
"messages":[
],
"parameters":{
"T2M":{
"units":"C",
"longname":"Temperature at 2 Meters"
}
},
"times":{
"data":6.191,
"process":0.47
}
}
3.2 月度数据
- GET /weather/nasaDaily?parameters=T2M&lon=119.5&lat=32.5&start=20190101&end=20190201
返回值:
json
{
"type":"Feature",
"geometry":{
"type":"Point",
"coordinates":[
119.5,
32.5,
12.19
]
},
"properties":{
"parameter":{
"T2M":{
"201901":2.31,
"201902":3.5,
"201903":10.12,
"201904":16.03,
"201905":21.76,
"201906":25.84,
"201907":28.65,
"201908":28.17,
"201909":23.8,
"201910":18.51,
"201911":12.19,
"201912":5.93,
"201913":16.48
}
}
},
"header":{
"title":"NASA/POWER CERES/MERRA2 Native Resolution Monthly and Annual",
"api":{
"version":"v2.3.5",
"name":"POWER Monthly and Annual API"
},
"sources":[
"merra2"
],
"fill_value":-999,
"start":"20190101",
"end":"20191231"
},
"messages":[
],
"parameters":{
"T2M":{
"units":"C",
"longname":"Temperature at 2 Meters"
}
},
"times":{
"data":5.801,
"process":1.7
}
}
{
"type":"Feature",
"geometry":{
"type":"Point",
"coordinates":[
119.5,
32.5,
12.19
]
},
"properties":{
"parameter":{
"T2M":{
"201901":2.31,
"201902":3.5,
"201903":10.12,
"201904":16.03,
"201905":21.76,
"201906":25.84,
"201907":28.65,
"201908":28.17,
"201909":23.8,
"201910":18.51,
"201911":12.19,
"201912":5.93,
"201913":16.48
}
}
},
"header":{
"title":"NASA/POWER CERES/MERRA2 Native Resolution Monthly and Annual",
"api":{
"version":"v2.3.5",
"name":"POWER Monthly and Annual API"
},
"sources":[
"merra2"
],
"fill_value":-999,
"start":"20190101",
"end":"20191231"
},
"messages":[
],
"parameters":{
"T2M":{
"units":"C",
"longname":"Temperature at 2 Meters"
}
},
"times":{
"data":5.801,
"process":1.7
}
}
3.3 每日数据
- GET /weather/nasaDaily?parameters=T2M&lon=119.5&lat=32.5&start=20190101&end=20190201
返回值:
json
{
"type":"Feature",
"geometry":{
"type":"Point",
"coordinates":[
119.5,
32.5,
12.19
]
},
"properties":{
"parameter":{
"T2M":{
"20190101":-0.98,
"20190102":-0.49,
"20190103":1.92,
"20190104":3.69,
"20190105":3.46,
"20190106":2.86,
"20190107":3.71,
"20190108":2.31,
"20190109":1.13,
"20190110":2.26,
"20190111":3.62,
"20190112":2.58,
"20190113":1.83,
"20190114":2.85,
"20190115":2.22,
"20190116":-1.06,
"20190117":1.27,
"20190118":2.01,
"20190119":3.91,
"20190120":1.76,
"20190121":1.39,
"20190122":2.02,
"20190123":3.54,
"20190124":3.48,
"20190125":3.11,
"20190126":0.4,
"20190127":2.23,
"20190128":4.58,
"20190129":3.89,
"20190130":5.29,
"20190131":1.12,
"20190201":0.44
}
}
},
"header":{
"title":"NASA/POWER CERES/MERRA2 Native Resolution Daily Data",
"api":{
"version":"v2.3.5",
"name":"POWER Daily API"
},
"sources":[
"merra2"
],
"fill_value":-999,
"start":"20190101",
"end":"20190201"
},
"messages":[
],
"parameters":{
"T2M":{
"units":"C",
"longname":"Temperature at 2 Meters"
}
},
"times":{
"data":1.083,
"process":0.2
}
}
{
"type":"Feature",
"geometry":{
"type":"Point",
"coordinates":[
119.5,
32.5,
12.19
]
},
"properties":{
"parameter":{
"T2M":{
"20190101":-0.98,
"20190102":-0.49,
"20190103":1.92,
"20190104":3.69,
"20190105":3.46,
"20190106":2.86,
"20190107":3.71,
"20190108":2.31,
"20190109":1.13,
"20190110":2.26,
"20190111":3.62,
"20190112":2.58,
"20190113":1.83,
"20190114":2.85,
"20190115":2.22,
"20190116":-1.06,
"20190117":1.27,
"20190118":2.01,
"20190119":3.91,
"20190120":1.76,
"20190121":1.39,
"20190122":2.02,
"20190123":3.54,
"20190124":3.48,
"20190125":3.11,
"20190126":0.4,
"20190127":2.23,
"20190128":4.58,
"20190129":3.89,
"20190130":5.29,
"20190131":1.12,
"20190201":0.44
}
}
},
"header":{
"title":"NASA/POWER CERES/MERRA2 Native Resolution Daily Data",
"api":{
"version":"v2.3.5",
"name":"POWER Daily API"
},
"sources":[
"merra2"
],
"fill_value":-999,
"start":"20190101",
"end":"20190201"
},
"messages":[
],
"parameters":{
"T2M":{
"units":"C",
"longname":"Temperature at 2 Meters"
}
},
"times":{
"data":1.083,
"process":0.2
}
}
3.4 小时数据
- GET /weather/nasaHourly?parameters=T2M&lon=119.5&lat=32.5&start=20190101&end=20190201
返回值:
json
{
"type":"Feature",
"geometry":{
"type":"Point",
"coordinates":[
119.5,
32.5,
12.19
]
},
"properties":{
"parameter":{
"T2M":{
"2019010108":-1.2,
"2019010109":1.12,
"2019010110":2.33,
"2019010111":3.01,
"2019010112":3.52,
"2019010113":3.8,
"2019010114":3.69,
"2019010115":3.01,
"2019010116":0.17,
"2019010117":-1.72,
"2019010118":-2.06,
"2019010119":-2.37,
"2019010120":-2.67,
"2019010121":-2.93,
"2019010122":-2.88,
"2019010123":-2.46,
"2019010200":-2.47,
"2019010201":-2.72,
"2019010202":-2.74,
"2019010203":-2.77,
"2019010204":-3.04,
"2019010205":-3.48,
"2019010206":-3.7,
"2019010207":-3.49
}
}
},
"header":{
"title":"NASA/POWER CERES/MERRA2 Native Resolution Hourly Data",
"api":{
"version":"v2.3.5",
"name":"POWER Hourly API"
},
"sources":[
"merra2"
],
"fill_value":-999,
"start":"20190101",
"end":"20190101"
},
"messages":[
],
"parameters":{
"T2M":{
"units":"C",
"longname":"Temperature at 2 Meters"
}
},
"times":{
"data":1.041,
"process":1.39
}
}
{
"type":"Feature",
"geometry":{
"type":"Point",
"coordinates":[
119.5,
32.5,
12.19
]
},
"properties":{
"parameter":{
"T2M":{
"2019010108":-1.2,
"2019010109":1.12,
"2019010110":2.33,
"2019010111":3.01,
"2019010112":3.52,
"2019010113":3.8,
"2019010114":3.69,
"2019010115":3.01,
"2019010116":0.17,
"2019010117":-1.72,
"2019010118":-2.06,
"2019010119":-2.37,
"2019010120":-2.67,
"2019010121":-2.93,
"2019010122":-2.88,
"2019010123":-2.46,
"2019010200":-2.47,
"2019010201":-2.72,
"2019010202":-2.74,
"2019010203":-2.77,
"2019010204":-3.04,
"2019010205":-3.48,
"2019010206":-3.7,
"2019010207":-3.49
}
}
},
"header":{
"title":"NASA/POWER CERES/MERRA2 Native Resolution Hourly Data",
"api":{
"version":"v2.3.5",
"name":"POWER Hourly API"
},
"sources":[
"merra2"
],
"fill_value":-999,
"start":"20190101",
"end":"20190101"
},
"messages":[
],
"parameters":{
"T2M":{
"units":"C",
"longname":"Temperature at 2 Meters"
}
},
"times":{
"data":1.041,
"process":1.39
}
}