mosaik-pvgis 1.2.3

Other options

Please pay attention to the input data. If you want to use only Direct Normal Irradiance input data as part of the co-simulation, then mosaik-pv is suitable, if you want to use full weather information (global irradiance, wind speed, air temperature and pressure) then mosaik-pvlib is suitable. If you are satisfied with historical performance estimates for a particular location or have no other input data, then mosaik-pvgis is the best solution which is based on PVGIS performance data.

Installation

pip install mosaik-pvgis

If you don’t want to install this through PyPI, you can use pip to install the requirements.txt file:

pip install -r requirements.txt

• To use this, you have to install at least version 3.2.0 of mosaik.

• It is recommended, to use the mosaik-csv library to export the results.

How to Use

Specify simulators configurations within your scenario script:

SIM_CONFIG = {
    'PVSim': {
        'python': 'mosaik_components.pv.pvgis_simulator:PVGISSimulator'
    },
    'CSV_writer': {
        'python': 'mosaik_csv_writer:CSVWriter',
    },
    ...
}

Initialize the PV-system:

# Create PV system with certain configuration
PVSIM_PARAMS = {
    'start_date' : START,
    'cache_dir' : './', # it caches PVGIS API requests
    'verbose' : True, # print PVGIS parameters and requests
}
pv_sim = world.start(
                "PVSim",
                step_size=STEP_SIZE,
                sim_params=PVSIM_PARAMS,
            )

Instantiate model entities:

PVMODEL_PARAMS = {
    'scale_factor' : 1000, # multiplies power production, 1 is equal to 1 kW peak power installed
    'lat' : 52.373,
    'lon' : 9.738,
    'slope' : 0, # default value,
    'azimuth' : 0, # default value,
    'optimal_angle' : True, # calculate and use an optimal slope
    'optimal_both' : False, # calculate and use an optimal slope and azimuth
    'pvtech' : 'CIS', # default value,
    'system_loss' : 14, # default value,
    'database' : 'PVGIS-SARAH3', # default value,
    'datayear' : 2016, # default value,
}
pv_model = pv_sim.PVSim.create(1, **PVMODEL_PARAMS)

Connect with PV-simulator:

world.connect(
                    pv_model[0],
                    csv_writer,
                    'P[MW]',
                )

world.run(until=END)

Notes

The simulator configuration can be specified with the sim_params parameter in world.start:

• start_date : preferable format is “2020-07-17 12:00:00”

• end_date : slightly optimizes memory by slicing historical time series in the range [start_date : end_date] inclusive, if provided

• cache_dir : ‘./’ - if not False, a local dir and file are used to store PVGIS API requests (may cause some problems in case of lack of space or restrictions on file discriptors)

• verbose : True - output PVGIS API requests to stdout

• gen_neg : False - if True, multiplies output by -1

Changelog

Authors

The adapter was initially developed by Danila Valko.