• User Guide
  • Calculation
  • Automation
  • Web API
  • Validation
  • Contact Us
Search Results for

    Show / Hide Table of Contents
    • Introduction
      • Installation
      • Licensing
      • Desktop licensing
      • General UI principles
    • –––––––––––––––––––
    • Set up site
      • Site location
      • Map backgrounds and terrain
      • Horizon line
    • Climate
      • Solar resources
      • Albedo
    • Shading objects
      • Shading objects
    • Components
      • PV modules
      • Inverters
      • String length
      • Fixed-tilt racks
      • Trackers
      • Inverter blocks
      • Transformers
    • Lay out plant
      • Design layout
        • Site layouts
        • Layout regions
        • Exclusion regions
        • Adding transformers
        • Adding central inverters
        • Assigning strings to central inverters
        • Adding string inverters
        • Formatting inverter blocks
        • Adding inverter blocks to a layout regions
        • Site statistics dialog
        • Specify site layout tool
        • Specify site layout tool (legacy)
        • Tracker Placement
      • Electrical configuration
      • Review trackers
      • Review shading
    • Calculate energy
      • Setup yield calculation
      • Yield results
      • Effects diagram
    • Create report
      • Create report
    • –––––––––––––––––––
    • Video tutorials
    • Step-by-step tutorials
      • Meadowbrook
    • –––––––––––––––––––
    • Useful hints and tips
      • Working with the map
      • Importing and exporting data
      • Import from API JSON
      • Export to PVsyst
      • Calculation feature comparison
      • Run from the command line
      • Using Remote Desktop
    • Automation
    • Glossary
    • Release notes
      • 1.1 (7 September 2023)
      • 1.0.240.0 (11 April 2023)
      • 1.0.234.0 (22 November 2022)
      • 1.0.229.0 (28 July 2022)
      • 1.0.225.0 (23 May 2022)
      • 1.0.223.0 (30 March 2022)
      • 1.0.222.0 (3 March 2022)

    Installation of the desktop application

    The installer contains everything you need to install and run the SolarFarmer desktop application on your machine.

    Download the latest SolarFarmer installer from the DNV portal web site:
    1. Go to the DNV Renewable Energy Software portal page (if you need to request access, email solarfarmer@dnv.com).
    2. Click on the SolarFarmer icon on the portal’s home page to take you to the SolarFarmer page.
    3. Download the installer and double-click to install (Administrator permissions will be needed).

    Follow the instructions in Desktop licensing to set up your software license.

    Recommended System Requirements

    SolarFarmer is designed to run on a PC with the following specifications:

    OS Windows 10
    Processor 3GHz processor or above. The more cores the better.
    RAM 16GB (or more)
    Graphics card NVIDIA Quadro K600 equivalent or above
    Resolution 1920 x 1200
    Mouse Mouse with mouse wheel

    Running calculations in the cloud from SolarFarmer

    No extra installations are needed to be able to run calculations in the cloud from the SolarFarmer desktop application. However, you must be registered with the SolarFarmer web service and retrieve your API token.

    You then set the environment variable SF_API_KEY with the value of your API token. The desktop application will then be able to use this token to run calculations in the cloud.

    To set this up on your PC:

    1. Acquire your API token
      See Acquiring your Web API Token for instructions on how to do this.

      You must have a Veracity account (https://www.veracity.com/ - DNV's cloud platform) to use the system, and be registered on the SolarFarmer web service.

      If, when logging in with your Veracity account, you are not registered and you believe you should be, please email solarfarmer@dnv.com and we can add you.

    2. Set the SF_API_KEY environment variable

      • On your PC, open settings by clicking the Windows Start Menu and the Settings Gear, then typing "environment variables" in the search box and selecting Edit environment variables for your account.
        Edit environment variables for your account

      • The top half of the Environment Variables window is for User variables. Click the New button to enter a new user environment variable. Cloud Calculation

      • Type SF_API_KEY in the Variable name field, paste your API access token in the value field, and click OK to save the changes. Then click OK again to close the Environment Variables window. Enter new user environment variable

    3. Restart SolarFarmer
      Once your SF_API_KEY is set as an environment variable you will see the Cloud option enabled in the Energy chapter of SolarFarmer once you have restarted the application.

      If the SF_API_KEY is not set then the cloud option is grayed out. A green check mark indicates that a connection is established with the SolarFarmer web service and the versions of the API and core calculation engine are displayed. If you see a red X or the connection fails, check your API access token is setup correctly in your environment variable, and click 'Retry'. If the trouble persists please contact solarfarmer@dnv.com.

      Cloud Calculation

    Important

    Your API access token is a secret. Treat it like your password. Never share it with anyone.

    If you believe your token has been compromised, let SolarFarmer support know (solarfarmer@dnv.com) and regenerate your token on the web service website. This will immediately make any previous tokens unusable.

    In This Article
    Back to top DNV SolarFarmer Home