環境変数

On this page

環境変数#

内部および外部(サードパーティ)の環境変数は、 userdeveloper 、または特定のホスト platform 例:GitHubランナーにデフォルトで設定されています。

Internal#

geovista の動作に影響を与えるパッケージ環境変数:

Table 2: Internal Environment Variables#

名前

説明

GEOVISTA_CACHEDIR

User

geovistaのリソースをダウンロードしてキャッシュするルートディレクトリ(絶対パス)を設定します。 GEOVISTA_CACHEDIR を参照してください。

デフォルトは platformdirs.user_cache_dir() によって返されるユーザーとプラットフォーム固有のキャッシュディレクトリの下にある geovista サブディレクトリです。

GEOVISTA_DATA_VERSION

User

BASE_URL からダウンロードしてキャッシュするデータリソースのバージョンを設定します。 GEOVISTA_DATA_VERSION を参照してください。

Defaults to the specific DATA_VERSION bundled with the version of geovista.

GEOVISTA_DISABLE_PLOT_THEME

User

When set, a plotting theme will not be loaded whenever geovista.themes.set_plot_theme() is called.

By default the GeoVistaTheme is enabled whenever geovista is imported. This environment variable allows users to override this default behaviour and allow prior pyvista or custom plot themes to remain activated.

Also see geovista.themes.restore_plot_theme() to undo the last call to geovista.themes.set_plot_theme().

GEOVISTA_IMAGE_TESTING

Developer

When set, plotting themes will not be loaded whenever geovista.themes.set_plot_theme() is called. Additionally, labels will not be rendered for geovista.gridlines.

This allows image testing to be more robust, particularly by being independent of any geovista theme changes.

Image tests default to using the pyvista testing theme.

GEOVISTA_POOCH_MUTE

User

Controls the verbosity level of the geovista CACHE manager. Set to True to silence the pooch logger diagnostic warnings. See GEOVISTA_POOCH_MUTE and also pooch_mute().

Defaults to False.

GEOVISTA_SPHX_GLR_SERIAL

Developer

When set, disables parallel building of the sphinx-gallery.

GEOVISTA_VTK_WARNINGS

User

Set to True to enable backend VTK diagnostic warnings.

Defaults to False.

Third-Party#

geovista の動作に影響を与える注目すべきサードパーティ環境変数:

Table 3: External Environment Variables#

名前

説明

CI

Platform

GitHub Action ランナーに設定するデフォルトの環境変数。

EAGER_IMPORT

User

Set this environment variable to disable lazy loading of geovista subpackages and external libraries.

Deferred imports are enabled by default in geovista.

For further details see lazy-loader and SPEC 1.

PYVISTA_BUILDING_GALLERY

Developer

ドキュメント sphinx-gallery をビルドするときに true に設定します。

PYVISTA_OFF_SCREEN

User

Set this environment variable to enable off-screen rendering.

PYVISTA_PLOT_THEME

User

Set this environment variable to the name of a registered pyvista plot theme to be loaded and enabled. Overrides the initial default configuration of the GeoVistaTheme when importing geovista.

May also be set to the package.module:ClassName dotted path of an importable pyvista.plotting.themes.Theme subclass.

READTHEDOCS

Platform

Read the Docs ランナーに設定するデフォルトの環境変数。

XDG_CACHE_HOME

User

geovista のリソースをダウンロードしてキャッシュするルートディレクトリ(絶対パス)を設定します。

Overrides GEOVISTA_CACHEDIR.

For further details see XDG Base Directory Specification.