実行に失敗した例#

この例は、エラーを発生させるコードブロックと、その後に続くコードブロックは実行されない様子を示しています。

スクリプトが失敗すると、ギャラリーサムネールはイメージの破損印に置き換えられます。これにより、ギャラリーの表示で簡単に識別できます。

失敗したコードブロックのPythonトレースバックも表示されます。

14 # Code source: Óscar Nájera
15 # License: BSD 3 clause
16 # sphinx_gallery_line_numbers = True
17
18 import matplotlib.pyplot as plt
19 import numpy as np
20
21 plt.pcolormesh(np.random.randn(100, 100))
plot raise
<matplotlib.collections.QuadMesh object at 0x7f28abfad030>

次のブロックでNameErrorが発生します

26 iae  # noqa
Traceback (most recent call last):
  File "/home/circleci/project/examples/no_output/plot_raise.py", line 26, in <module>
    iae  # noqa
NameError: name 'iae' is not defined

Sphinxギャラリーは、サンプルスクリプトで例外が発生した後で、残りのコードブロックの実行を停止します。それにもかかわらず、htmlはすべてのサンプルの注釈付きテキストとコードブロックをレンダリングしますが、出力が表示されることはありません。

これは別のエラーを発生させるブロックですが、実行されません

37 plt.plot("Strings are not a valid argument for the plot function")

スクリプトの総実行時間: (0分 0.780秒)

推定メモリ使用量: 538 MB

Sphinx-Galleryが生成したギャラリー