Home Image

Climate Modeling Alliance

CliDApp4Rhino Plugin

Overview

CliDApp4Rhino is a Python plugin for the Rhinoceros program developed by CliMA that enables users to download weather files into the Rhinoceros environment from the CliDApp API.


Before installing the CliDApp4Rhino plugin, ensure that you have the following:

  • Rhinoceros 5 and above
  • Python 3 or later installed on your device.
  • Internet connection: to download weather files


To install the CliDApp4Rhino plugin, follow the steps below:

  • Close Rhinoceros (Rhino) if opened
  • Navigate to the terminal and enter the following to install the package

pip install CliDApp4Rhino

  • After run the following command to install the package to the correct directory.

clidapp4rhino

  • Open Rhino and enter the following in the command line

CliDApp4Rhino

If Rhino suggests this command, then you have successfully installed the plugin.



After installing the plugin and launching the CliDApp4Rhino command, you will now see the dialog box below:

CliDApp4Rhino Dialog Box


Begin by selecting a city from the dropdown.

city selection dropdown


Then, select a weather file from the following three options:

  • Typical Meteorological Year (TMY)
  • Future Meteorological Year (FTMY)
  • Actual Meteorological Year (AMY)

Next, select a data type. Currently, only observation data is available.

The start/end-year ranges will differ depending on the weather file selected. Currently, for AMY and TMY files, the start-year and end-year range starts from 1979 and ends in 2022. For FTMY files, the start year is 2050, and the end year is 2070.

Afterwards, select your desired file type. Then, enter the path where you want to download the file. If the text box for Download Path is left empty, the default path will be Downloads/clidapp/epw. Lastly, click on OK to begin downloading the weather file.



An example of using the CliDApp4Rhino plugin is downloading the EPW weather files to visualise data in wind rose charts.

As shown in the form inputs below, the following file was downloaded.

Form inputs for TMY EPW for Hartsfield ATL, 1979 to 1989. Downloaded file


We get the following chart using a Panel, the ImportEPW Ladybug module, and the WindRose Ladybug module.

Module inputs in Grasshopper.
Wind Rose Chart for ATL.