### Example with multiple timestamps and verbosity Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/basics.md The same as the previous example but with added verbosity. ```bash pvgis irradiance global inclined 8 45 214 170 44 '2010-01-27 12:00:00, 2010-01-27 13:30:00, 2010-01-27 17:45:00' -v ``` -------------------------------- ### Example command Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/basics.md An example of a command with its arguments. ```bash pvgis power broadband 8 45 214 170 44 ``` -------------------------------- ### Example command with sub-sub-command and parameters Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/basics.md An example of a command with a sub-sub-command and parameters. ```bash pvgis \ irradiance \ global \ inclined \ 8 45 214 170 44 \ '2010-01-27 12:00:00' ``` -------------------------------- ### A day Source: https://github.com/pvgis/pvgis/blob/main/docs/web_api/examples.md Example API call to retrieve performance data for a single day. ```bash curl -X 'GET' \ 'https://photovoltaic-geographic-information-system.ec.europa.eu/api/v6/performance/broadband?longitude=8.628&latitude=45.812&installation_height=0&surface_orientation=180&surface_tilt=45&start_time=2014-01-01T00%3A00%3A00&end_time=2014-01-01T23%3A59%3A59&frequency=Hourly&timezone=UTC&irradiance_source=SARAH-3&linke_turbidity_factor_series=2&albedo=0.2&horizon_profile=PVGIS&shading_model=PVGIS&photovoltaic_module=cSi%3AFree%20standing%202025&photovoltaic_module_type=Mono-Facial&bifacialy_factor=0.7&module_height=1&module_length=2&system_efficiency=0.86&power_model=Huld%202011&peak-power=1&angle_output_units=Radians&analysis=Simple&statistics=false&groupby=None&verbose=0&quiet=false&fingerprint=false&quick_response_code=None&metadata=false&surface_position_optimisation_mode=None&surface_position_optimisation_method=L-BFGS-B&sampling_method_shgo=sobol&number_of_sampling_points=100&iterations=20' \ -H 'accept: application/json' ``` -------------------------------- ### A month Source: https://github.com/pvgis/pvgis/blob/main/docs/web_api/examples.md Example API call to retrieve performance data for a single month. ```bash curl -X 'GET' \ 'https://photovoltaic-geographic-information-system.ec.europa.eu/api/v6/performance/broadband?longitude=8.628&latitude=45.812&installation_height=0&surface_orientation=180&surface_tilt=45&start_time=2014-01-01T00%3A00%3A00&end_time=2014-01-31T23%3A59%3A59&frequency=Hourly&timezone=UTC&irradiance_source=SARAH-3&linke_turbidity_factor_series=2&albedo=0.2&horizon_profile=PVGIS&shading_model=PVGIS&photovoltaic_module=cSi%3AFree%20standing%202025&photovoltaic_module_type=Mono-Facial&bifacialy_factor=0.7&module_height=1&module_length=2&system_efficiency=0.86&power_model=Huld%202011&peak-power=1&angle_output_units=Radians&analysis=Simple&statistics=false&groupby=None&verbose=0&quiet=false&fingerprint=false&quick_response_code=None&metadata=false&surface_position_optimisation_mode=None&surface_position_optimisation_method=L-BFGS-B&sampling_method_shgo=sobol&number_of_sampling_points=100&iterations=20' \ -H 'accept: application/json' ``` -------------------------------- ### Example command with sub-sub-command Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/basics.md An example of a command with a sub-sub-command. ```bash pvgis \ irradiance \ global \ horizontal \ 8 45 214 \ '2010-01-27 12:00:00' ``` -------------------------------- ### A year Source: https://github.com/pvgis/pvgis/blob/main/docs/web_api/examples.md Example API call to retrieve performance data for a single year. ```bash curl -X 'GET' \ 'https://photovoltaic-geographic-information-system.ec.europa.eu/api/v6/performance/broadband?longitude=8.628&latitude=45.812&installation_height=0&surface_orientation=180&surface_tilt=45&start_time=2014-01-01T00%3A00%3A00&end_time=2014-12-31T23%3A59%3A59&frequency=Hourly&timezone=UTC&irradiance_source=SARAH-3&linke_turbidity_factor_series=2&albedo=0.2&horizon_profile=PVGIS&shading_model=PVGIS&photovoltaic_module=cSi%3AFree%20standing%202025&photovoltaic_module_type=Mono-Facial&bifacialy_factor=0.7&module_height=1&module_length=2&system_efficiency=0.86&power_model=Huld%202011&peak-power=1&angle_output_units=Radians&analysis=Simple&statistics=false&groupby=None&verbose=0&quiet=false&fingerprint=false&quick_response_code=None&metadata=false&surface_position_optimisation_mode=None&surface_position_optimisation_method=L-BFGS-B&sampling_method_shgo=sobol&number_of_sampling_points=100&iterations=20' \ -H 'accept: application/json' ``` -------------------------------- ### A month Source: https://github.com/pvgis/pvgis/blob/main/docs/web_api/examples.md Example API call to retrieve performance data for a single month. ```html https://photovoltaic-geographic-information-system.ec.europa.eu/api/v6/performance/broadband?longitude=8.628&latitude=45.812&installation_height=0&surface_orientation=180&surface_tilt=45&start_time=2014-01-01T00%3A00%3A00&end_time=2014-01-31T23%3A59%3A59&frequency=Hourly&timezone=UTC&irradiance_source=SARAH-3&linke_turbidity_factor_series=2&albedo=0.2&horizon_profile=PVGIS&shading_model=PVGIS&photovoltaic_module=cSi%3AFree%20standing%202025&photovoltaic_module_type=Mono-Facial&bifacialy_factor=0.7&module_height=1&module_length=2&system_efficiency=0.86&power_model=Huld%202011&peak-power=1&angle_output_units=Radians&analysis=Simple&statistics=false&groupby=None&verbose=0&quiet=false&fingerprint=false&quick_response_code=None&metadata=false&surface_position_optimisation_mode=None&surface_position_optimisation_method=L-BFGS-B&sampling_method_shgo=sobol&number_of_sampling_points=100&iterations=20 ``` -------------------------------- ### Example with physically possible limits Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/irradiance/others.md Example with physically possible limits. ```bash pvgis irradiance limits physical 0.8 ``` -------------------------------- ### Index example Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/verbosity.md Example demonstrating the use of the --index flag for output. ```bash pvgis power broadband \ 8.628 45.812 214 180 35 \ --start-time '2010-01-27' \ --end-time '2010-01-28' \ -vv \ --index ``` -------------------------------- ### Start and end date-times Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/timestamps.md Example specifying start and end date-times for the time series. ```bash pvgis power broadband 8 45 214 180 45 --start-time '2010-01-27 06:00:00' --end-time '2010-01-28 17:30:00' -v ``` -------------------------------- ### One more failing example: Missing surface orientation and tilt angles Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/basics.md This example fails because both the surface orientation and tilt angles are missing, and the command line arguments are positional. ```bash pvgis irradiance global inclined 8 45 214 '2010-01-27 12:00:00' ``` ```bash pvgis irradiance global inclined 8 45 214 '2010-01-27 12:00:00' ``` -------------------------------- ### Start and end dates Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/timestamps.md Example specifying start and end dates for the time series. ```bash pvgis power broadband 8 45 214 180 45 --start-time '2010-01-27' --end-time '2010-01-28' ``` -------------------------------- ### Solar Position - Get overview Source: https://github.com/pvgis/pvgis/blob/main/README.md Example command to get the solar position overview for a day over ESTI. ```bash pvgis position overview 8.628 45.812 180 35 \ --start-time "2014-01-01 00:00:00" --end-time "2014-01-01 23:00:00" \ --horizon-profile data/sample_horizon_profile_reference_north_over_esti.nc \ --event all \ -aou degrees ``` -------------------------------- ### Example command with multiple surfaces Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/power/broadband-multi.md An example demonstrating how to provide comma-separated lists for surface orientation and tilt when calculating power for multiple surfaces. ```bash pvgis power broadband-multi \ 8.627626 45.81223 200 \ --start-time '2000-01-01' \ --end-time '2000-01-02' \ --surface-orientation '0, 180' \ --surface-tilt '35, 35' ``` -------------------------------- ### Interactive Program Notice Source: https://github.com/pvgis/pvgis/blob/main/third_party/licenses/pylint.txt An example notice for interactive programs when they start. ```text Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. ``` -------------------------------- ### Clone the software repository (Conda) Source: https://github.com/pvgis/pvgis/blob/main/README.md Clones the PVGIS repository to get the latest changes for Conda installation. ```bash $ git clone https://code.europa.eu/pvgis/pvgis.git ``` -------------------------------- ### Introduction to meteo tools Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/meteo/introduction.md This command displays an introduction to the PVGIS meteo tools. ```bash pvgis meteo introduction ``` -------------------------------- ### Using the -l flag for logging details Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/logging.md This example demonstrates how to use the `-l` flag to get logging details for the operation. ```bash pvgis series select \ data/sample_era5landplus_t2m_over_esti.nc \ 8.628 45.812 \ --neighbor-lookup nearest \ '2014-12-31 12:00:00, 2015-12-31 12:00:00,2016-12-31 12:00:00,2017-12-31 12:00:00,2018-12-31 12:00:00' \ -l ``` -------------------------------- ### Photovoltaic Power & Solar Irradiance Analysis Source: https://github.com/pvgis/pvgis/blob/main/README.md Example command to get photovoltaic power and irradiance series over ESTI for a day. ```bash pvgis power broadband 8.628 45.812 214 180 0 --start-time '2014-01-01 00:00:00' --end-time '2014-01-01 23:00:00' \ --global-horizontal-irradiance data/sample_sarah3_sis_over_esti.nc \ --direct-horizontal-irradiance data/sample_sarah3_sid_over_esti.nc \ --temperature-series data/sample_era5landplus_t2m_over_esti.nc \ --wind-speed-series data/sample_era5landplus_wind_speed_2m_over_esti.nc -aou degrees -vvvvvvvv ``` -------------------------------- ### Mixing optional parameters example 2 (equivalent) Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/basics.md Shows an equivalent command to the previous one, demonstrating that the order of optional flags does not matter. ```bash pvgis irradiance global inclined \ 8 45 214 170 44 \ '2010-01-27 12:00:00, 2010-01-27 13:30:00, 2010-01-27 17:45:00' \ --quiet \ --verbose ``` -------------------------------- ### Set PIP_REQUIRE_VIRTUALENV environment variable Source: https://github.com/pvgis/pvgis/blob/main/README.md Example of setting the PIP_REQUIRE_VIRTUALENV environment variable in .bashrc or .zshrc to prevent pip from installing packages outside a virtual environment. ```bash export PIP_REQUIRE_VIRTUALENV=true ``` -------------------------------- ### Time-series Solar Position Parameters Source: https://github.com/pvgis/pvgis/blob/main/docs/cli/position/overview.md Example of how to get a time series of solar position parameters using the `pvgis position overview` command. ```bash pvgis position overview 8.627626 45.812233 --start-time '2020-01-01' --end-time '2020-01-02' -r2 -aou degrees ``` -------------------------------- ### A complete day Source: https://github.com/pvgis/pvgis/blob/main/docs/web_api/examples.md Example API call to retrieve performance data for a single day. ```html https://photovoltaic-geographic-information-system.ec.europa.eu/api/v6/performance/broadband?longitude=8.628&latitude=45.812&installation_height=0&surface_orientation=180&surface_tilt=45&start_time=2014-01-01T00%3A00%3A00&end_time=2014-01-01T23%3A59%3A59&frequency=Hourly&timezone=UTC&irradiance_source=SARAH-3&linke_turbidity_factor_series=2&albedo=0.2&horizon_profile=PVGIS&shading_model=PVGIS&photovoltaic_module=cSi%3AFree%20standing%202025&photovoltaic_module_type=Mono-Facial&bifacialy_factor=0.7&module_height=1&module_length=2&system_efficiency=0.86&power_model=Huld%202011&peak-power=1&angle_output_units=Radians&analysis=Simple&statistics=false&groupby=None&verbose=0&quiet=false&fingerprint=false&quick_response_code=None&metadata=false&surface_position_optimisation_mode=None&surface_position_optimisation_method=L-BFGS-B&sampling_method_shgo=sobol&number_of_sampling_points=100&iterations=20 ``` -------------------------------- ### Install PVGIS using uv Source: https://github.com/pvgis/pvgis/blob/main/docs/install/index.md Installs the 'uv' package manager and then uses it to install PVGIS from its Git repository. ```bash pip install uv ``` ```bash uv pip install git+https://code.europa.eu/pvgis/pvgis.git ```