ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

ライブ スクリプトまたはライブ関数とは

MATLAB® ライブ スクリプトおよびライブ関数は、ライブ エディターと呼ばれる単一の環境で MATLAB コードと書式設定されたテキスト、数式およびイメージを組み合わせた対話型ドキュメントです。さらに、ライブ スクリプトでは、出力がその作成元のコードとともに格納され、表示されます。

ライブ スクリプトとライブ関数を使用して次を行います。

視覚的に問題を調査および解析

  • 単独の対話型環境でコードを記述、実行およびテストします。

  • コードをブロックごとに実行するか、またはファイル全体で実行し、結果とグラフィックスを、それらを生成したコードとともに表示します。

多様に書式設定された実行可能な表現コンテンツを共有

  • プロセスを説明するためのタイトル、見出しおよび書式設定されたテキストを追加し、サポート素材として式、イメージおよびハイパーリンクを含めます。

  • 表現コンテンツを、多様に書式設定された実行可能なドキュメントとして保存し、同僚や MATLAB コミュニティと共有したり、HTMLPDF、または LaTeX ファイルに変換して公開したりすることができます。

教育のための対話型講義の作成

  • コードと結果に、書式設定されたテキストと数学の方程式を組み合わせます。

  • 順を追った講義内容を作成し、それらを順に実行してトピックについて解説します。

  • 質問に回答したり、関連するトピックについて確認したりするために、その場でコードを変更することができます。

  • 対話型ドキュメントまたはハード コピー形式で講義内容を受講生と共有し、課題として部分的に完了しているファイルを配布します。

標準のコード スクリプトおよび関数との相違点

ライブ スクリプトおよびライブ関数は、いくつかの点で標準のコード スクリプトおよび関数と異なっています。次の表は、主な相違点をまとめています。

 ライブ スクリプトとライブ関数標準のコード スクリプトと関数
ファイル形式ライブ コード ファイル形式。詳細については、ライブ コード ファイル形式 (.mlx)を参照してください。標準テキスト ファイル形式
ファイルの拡張子.mlx.m
出力の表示ライブ エディターでコード付き表示 (ライブ スクリプトのみ)コマンド ウィンドウで表示
国際化ロケール間で相互利用が可能7 ビット ASCII 文字以外は全ロケール間で互換性なし
テキストの書式設定書式設定されたテキストをライブ エディターで追加および表示パブリッシュ マークアップを使用して書式設定されたテキストを追加し、パブリッシュして表示
視覚的表現

要件

  • MATLAB R2016a — MATLAB は、バージョン R2016a 以降でライブ スクリプト、バージョン R2018a 以降でライブ関数をサポートしています。

  • オペレーティング システム — MATLAB は、MATLAB によってサポートされている大半のオペレーティング システムでライブ エディターをサポートしています。詳細については、System Requirements を参照してください。MATLAB によってサポートされていても、ライブ エディターではサポートされないオペレーティング システムがいくつかあります。

    サポートされていないバージョンは、次のとおりです。

    • Red Hat Enterprise Linux 6

    • Red Hat Enterprise Linux 7

    • SUSE Linux Enterprise Desktop Version 13.0 以前

    • Debian 7.6 以前

    オペレーティング システムによっては、ライブ エディターの実行に追加の構成が必要となります。お使いのシステムでライブ エディターを実行できない場合、システムの構成方法をテクニカル サポートにお問い合わせください

サポートされていない機能

ライブ スクリプトまたはライブ関数を作成するかどうかを決める際は、ライブ エディターでサポートされていない一部の機能に注意することが重要です。

  • クラス — クラスは標準のコード ファイル (.m) として作成します。その後、ライブ スクリプトまたはライブ関数でこれらのクラスを使用できます。

  • エディターの設定 — ライブ エディターは、カスタム キーボード ショートカット、Emacs 形式のキーボード ショートカットを含め、エディターの設定の大半を無視します。

ライブ スクリプトとライブ関数を標準コードとして保存

ライブ スクリプトまたはライブ関数を標準のコード ファイル (.m) として保存するには、次を行います。

  1. [ライブ エディター] タブの [ファイル] セクションで、[保存][名前を付けて保存] を選択します。

  2. 表示されたダイアログ ボックスで、[ファイルの種類] として [MATLAB コード ファイル (*.m)] を選択します。

  3. [保存] をクリックします。

保存するときに、MATLAB は、すべての書式設定されたコンテンツをパブリッシュ マークアップに変換します。

関連するトピック