Ag Data Commons

File(s) stored somewhere else

Please note: Linked content is NOT stored on Ag Data Commons and we can't guarantee its availability, quality, security or accept any liability.

SolarCalQ - Version 1

posted on 2024-02-13, 13:40 authored by USDA Agricultural Research Service

SolarCalQ • Version 1.0 - Java model to simulate spectral quality at any location on the globe.

The purpose of this JAVA model is to simulate the spectral quality of incident solar radiation for any location on the globe, down to one minute time steps. This JAVA model is an adaptation of existing NREL (National Renewable Energy Laboratory) solar spectral quality (Bird and Riordan 1984, 1986) and solar position models (Reda and Andreas, 2003), with significant modifications that are outlined below. The solar position model of Reda and Andreas (2003) has been shown to be accurate within the time period from the year -2000 to 6000, with uncertainties of +/- 0.0003 degrees in the solar zenith and azimuth angles based on the date, time, and location on the Earth. Additional modifications that were added into the SolarCalQ model are:

  1. Simulation of daily maximum and minimum temperatures (from Global TempSIM),
  2. Minutely temperature estimates were extracted utilizing the algorithms of Cesaraccio et al. (2001),
  3. Original SolarCalc (Spokas and Forcella, 2006) model to produce an improved prediction in the overall intensity of the solar radiation,
  4. Zip Code Search to allow easier user input of latitude and longitude in the U.S.
  5. Empirical model for total precipitable water vapor based upon Liebe (1989) model for estimating percipitable water from surface relative humidity and surface temperatures (both of these are estimated from Global TempSIM), and
  6. Empirical models for ozone concentration and atmospheric optical depth (or aerosol optical depth) predictions.

The atmospheric optical depth has been linked to 3 components: Clear sky + clouds + aerosols

Spectral intensity is predicted either in integrated units (W m-2) or raw intensity units (W m-2um-1). The wavelength spacing is irregular, covering 122 wavelengths from 305 nm to 4000 nm.

User Input:

User input is handled through tabbed entry windows. An example of one of these windows is shown below. There are help screens included in the program to guide the user through the necessary input parameters.

The time step is set under the •Program Options• tab. (Number of minutes per time step)

SolarCalQ "Program Options" Tab

In the advanced tab (enabled under PREFERENCES) the geometry of the receiving surface (or incident surface) is described. Default is a solar tracking surface (e.g. plant leaf or flower), but any geometric arrangement can be handled by the model.

"Advanced tab" (enabled under PREFERENCES)

After settings have been edited select Update Options button and then Run Model from the File menu.

The output file generated (if selected under FILE) is the instantaneous output at the interval set in the program options tab.

Output file generated (if selected under FILE)

This model was developed in JAVA, is simple to use, and runs on multiple platforms (e.g. Mac, PC, Sun).

Resources in this dataset:




Data contact name

Johnson, Jane

Data contact email


United States Department of Agriculture


  • Not specified

ISO Topic Category

  • environment
  • farming

National Agricultural Library Thesaurus terms

computer software; models; simulation models; solar radiation; renewable energy sources; uncertainty; algorithms; prediction; latitude; longitude; United States; empirical models; water vapor; relative humidity; surface temperature; ozone; aerosols; wavelengths; geometry; leaves; flowers

OMB Bureau Code

  • 005:18 - Agricultural Research Service

OMB Program Code

  • 005:040 - National Research

ARS National Program Number

  • 305

Pending citation

  • No

Public Access Level

  • Public

Preferred dataset citation

USDA Agricultural Research Service (2019). SolarCalQ - Version 1. United States Department of Agriculture.

Usage metrics



    Ref. manager