CliDApp4Rhino


NameCliDApp4Rhino JSON
Version 1.0.5 PyPI version JSON
download
home_pageNone
SummaryCliDApp4Rhino is a graphical user interface tool for the Rhino 3D CAD software.
upload_time2024-05-08 18:19:05
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # CliDApp4Rhino

## Overview

CliDApp4Rhino package is a Python package with the plugin for the [Rhinoceros](https://www.rhino3d.com/) program developed by [CliMA](https://clima.caltech.edu/) that enables users to download weather files into the Rhinoceros environment from the CliDApp API.

### Requirements

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

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

### Installation

To install the CliDApp4Rhino plugin, follow the steps below:

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

```shell
pip install CliDApp4Rhino
```

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

```shell
clidapp4rhino
```

4. Open Rhino and enter the following in the command-line

```shell
CliDApp4Rhino
```

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

### Usage

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

<div align="center">
<img src="https://clidapp.s3.amazonaws.com/static/server/img/dialog.png" alt="CliDApp4Rhino Dialog Box" width="35%" height="35%">
</div>

Begin by selecting a city from the dropdown

<div align="center">
<img src="https://clidapp.s3.amazonaws.com/static/server/img/city_selection.png" alt="CliDApp4Rhino City Selection" width="35%" height="35%">
</div>

Then select a weather file from the following three options:

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

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.

### Example

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.

<div align="center">
    <img src="https://clidapp.s3.amazonaws.com/static/server/img/form_inputs.png" alt="CliDApp4Rhino Form Input" width="35%" height="35%" style="display: inline-block; margin-right: 10px;">
    <img src="https://clidapp.s3.amazonaws.com/static/server/img/file.png" alt="CliDApp4Rhino File" width="35%" height="35%" style="display: inline-block;">
</div>

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

<div align="center">
<img src="https://clidapp.s3.amazonaws.com/static/server/img/ladybug_inputs.png" alt="CliDApp4Rhino Ladybug Input" width="35%" height="35%">
</div>
<br>
<div align="center">
<img src="https://clidapp.s3.amazonaws.com/static/server/img/wind_rose.png" alt="CliDApp4Rhino Wind Rose" width="35%" height="35%">
</div>


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "CliDApp4Rhino",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "\"Elizabeth Consulting International Inc.\" <info@ec-intl.com>",
    "download_url": "https://files.pythonhosted.org/packages/8b/b9/c9dae7cecdc9a77081ca13bee3104fc465979a773f96f4ed67e8d08a9b62/clidapp4rhino-1.0.5.tar.gz",
    "platform": null,
    "description": "# CliDApp4Rhino\n\n## Overview\n\nCliDApp4Rhino package is a Python package with the plugin for the [Rhinoceros](https://www.rhino3d.com/) program developed by [CliMA](https://clima.caltech.edu/) that enables users to download weather files into the Rhinoceros environment from the CliDApp API.\n\n### Requirements\n\nBefore installing the CliDApp4Rhino plugin, ensure that you have the follwing:\n\n- Rhinoceros 5 and above\n- Python 3 or later installed on your device\n- Internet connection: to download weather files\n\n### Installation\n\nTo install the CliDApp4Rhino plugin, follow the steps below:\n\n1. Close Rhinoceros (Rhino) if opened\n2. Navigate to the terminal and enter the following to install the package\n\n```shell\npip install CliDApp4Rhino\n```\n\n3. After run the following command to install the package to the correct directory.\n\n```shell\nclidapp4rhino\n```\n\n4. Open Rhino and enter the following in the command-line\n\n```shell\nCliDApp4Rhino\n```\n\nIf Rhino suggests this command, then you have successfully installed the plugin.\n\n### Usage\n\nAfter installing the plugin and launching the CliDApp4Rhino command, you will now see the dialog box below:\n\n<div align=\"center\">\n<img src=\"https://clidapp.s3.amazonaws.com/static/server/img/dialog.png\" alt=\"CliDApp4Rhino Dialog Box\" width=\"35%\" height=\"35%\">\n</div>\n\nBegin by selecting a city from the dropdown\n\n<div align=\"center\">\n<img src=\"https://clidapp.s3.amazonaws.com/static/server/img/city_selection.png\" alt=\"CliDApp4Rhino City Selection\" width=\"35%\" height=\"35%\">\n</div>\n\nThen select a weather file from the following three options:\n\n- Typical Meteorological Year (TMY)\n- Future Meteorological Year (FTMY)\n- Actual Meteorological Year (AMY)\n\nThe 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.\n\nAfterwards, 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.\n\n### Example\n\nAn example of using the CliDApp4Rhino plugin is downloading the EPW weather files to visualise data in wind rose charts.\n\nAs shown in the form inputs below, the following file was downloaded.\n\n<div align=\"center\">\n    <img src=\"https://clidapp.s3.amazonaws.com/static/server/img/form_inputs.png\" alt=\"CliDApp4Rhino Form Input\" width=\"35%\" height=\"35%\" style=\"display: inline-block; margin-right: 10px;\">\n    <img src=\"https://clidapp.s3.amazonaws.com/static/server/img/file.png\" alt=\"CliDApp4Rhino File\" width=\"35%\" height=\"35%\" style=\"display: inline-block;\">\n</div>\n\nWe get the following chart using a Panel, the ImportEPW Ladybug module, and the WindRose Ladybug module.\n\n<div align=\"center\">\n<img src=\"https://clidapp.s3.amazonaws.com/static/server/img/ladybug_inputs.png\" alt=\"CliDApp4Rhino Ladybug Input\" width=\"35%\" height=\"35%\">\n</div>\n<br>\n<div align=\"center\">\n<img src=\"https://clidapp.s3.amazonaws.com/static/server/img/wind_rose.png\" alt=\"CliDApp4Rhino Wind Rose\" width=\"35%\" height=\"35%\">\n</div>\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "CliDApp4Rhino is a graphical user interface tool for the Rhino 3D CAD software.",
    "version": "1.0.5",
    "project_urls": {
        "Homepage": "https://github.com/ec-intl/clidapp4rhino",
        "Issues": "https://github.com/ec-intl/clidapp4rhino/issues"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "eb5432ff86ef76adc6ac55cd10ef89024aff63685df54c87424ec6f28c473eb6",
                "md5": "93cac9c0976ae000cc2beac24d5130e0",
                "sha256": "26c2331f0167b9e556e06788635a482da8ffc595b13d04e6af69cebcfcb1543c"
            },
            "downloads": -1,
            "filename": "clidapp4rhino-1.0.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "93cac9c0976ae000cc2beac24d5130e0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 14701626,
            "upload_time": "2024-05-08T18:18:59",
            "upload_time_iso_8601": "2024-05-08T18:18:59.830289Z",
            "url": "https://files.pythonhosted.org/packages/eb/54/32ff86ef76adc6ac55cd10ef89024aff63685df54c87424ec6f28c473eb6/clidapp4rhino-1.0.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8bb9c9dae7cecdc9a77081ca13bee3104fc465979a773f96f4ed67e8d08a9b62",
                "md5": "b5305a6c345fea5a74bab8e45ecbce3c",
                "sha256": "a1191fa3c056100a613bec113749b05c226921b059a879863f98f18ff6ac8966"
            },
            "downloads": -1,
            "filename": "clidapp4rhino-1.0.5.tar.gz",
            "has_sig": false,
            "md5_digest": "b5305a6c345fea5a74bab8e45ecbce3c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 14702807,
            "upload_time": "2024-05-08T18:19:05",
            "upload_time_iso_8601": "2024-05-08T18:19:05.003454Z",
            "url": "https://files.pythonhosted.org/packages/8b/b9/c9dae7cecdc9a77081ca13bee3104fc465979a773f96f4ed67e8d08a9b62/clidapp4rhino-1.0.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-08 18:19:05",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ec-intl",
    "github_project": "clidapp4rhino",
    "github_not_found": true,
    "lcname": "clidapp4rhino"
}
        
Elapsed time: 0.29890s