ladybug.config module

Ladybug configurations.

Import this into every module where access configurations are needed.

Usage:

from ladybug.config import folders print(folders.default_epw_folder) folders.default_epw_folder = “C:/epw_data”

class ladybug.config.Folders(config_file=None, mute=True)[source]

Bases: object

Ladybug folders.

Parameters:

  • config_file – The path to the config.json file from which folders are loaded. If None, the config.json module included in this package will be used. Default: None.

  • mute – If False, the paths to the various folders will be printed as they are found. If True, no printing will occur upon initialization of this class. Default: True.

Properties:

  • ladybug_tools_folder

  • default_epw_folder

  • python_package_path

  • python_scripts_path

  • python_exe_path

  • python_version

  • python_version_str

  • config_file

  • mute

property config_file

Get or set the path to the config.json file from which folders are loaded.

Setting this to None will result in using the config.json module included in this package.

property default_epw_folder

Get or set the path to the default folder where EPW files are stored.

property ladybug_tools_folder

Get or set the path to the ladybug tools installation folder.

property python_exe_path

Get the path to the Python executable to be used for Ladybug Tools CLI calls.

If a version of Python is found within the ladybug_tools installation folder, this will be the path to that version of Python. Otherwise, it will be assumed that this is package is installed in cPython outside of the ladybug_tools folder and the sys.executable will be returned.

property python_package_path

Get the path to where this Python package is installed.

property python_scripts_path

Get the path to where Python CLI executable files are installed.

This can be used to call command line interface (CLI) executable files directly (instead of using their usual entry points).

property python_version

Get a tuple for the version of python (eg. (3, 8, 2)).

This will be None if the version could not be sensed or if no Python installation was found.

property python_version_str

Get text for the full version of python (eg.”3.8.2”).

This will be None if the version could not be sensed or if no Python installation was found.