MetaEditorのヘルプ → プロジェクトおよびMQL5ストレージ → プロジェクトの生成及び稼働

プロジェクトの作成と操作

MetaEditorには、プロジェクトを操作するための便利な機能が多数用意されています。ファイルを1つの構造にまとめて整理したり、プロジェクト設定を管理したり、MQL5 Algo Forgeを介してバージョン管理を行いながら共同作業したりできます。 MQL5 Algo Forge バージョン管理機能付き。

プロジェクトとは

プロジェクトとは、MQL5アプリケーションのコンパイルに必要な設定、パラメータ、その他の情報を格納するMQPROJファイルです。

MQPROJファイルをダブルクリックすると[プロジェクト]タブが開きます。このタブは、Navigator内でプロジェクトを便利に操作するための専用ワークスペースです。プロジェクトに含まれるすべてのファイルとフォルダは、このタブ上でカテゴリー別に整理されます。

プロジェクトの構造と設定    

プロジェクトの作成 #

トップメニューから[ファイル]>[新規プロジェクト]をクリックするか、Ctrl + Shift + Nを押します。希望するプログラムの種類を選択し、 MQL5ウィザードの手順に従って進みます。

新しいプロジェクトの作成

名前やその他の詳細情報を入力し、パラメータを追加して、イベントハンドラーを選択します。

ウィザードでは、デフォルトのテンプレートと互換性のないファイル構造を格納するための空のプロジェクトも作成できます。空のプロジェクトには空のMQPROJファイルのみが含まれ、ソースコードファイルは手動で作成する必要があります。

MQ5ファイルを基にしたプロジェクトの作成 #

MQ5ファイルを右クリックし、[ソースからプロジェクトを新規作成]を選択します。

ソースファイルに基づいて新しいプロジェクトを作成する

同じ名前の新しいMQPROJプロジェクトファイルがディレクトリ内に作成されます。ソースコード内で#propertyを使用して指定された主要なプログラムプロパティは、名前、著作権、バージョン、開発者サイトへのリンク、プログラムの説明などを含め、自動的にプロジェクトに追加されます。#includeディレクティブによってソースコードに含まれているすべてのファイルは、プロジェクトの「Dependencies」セクションに追加されます。

プロジェクトのプロパティ #

プロジェクトの設定は専用のダイアログボックスから変更できるため、MQ5ファイルのソースコードを直接編集する必要はありません。[プロジェクト]タブでMQPROJファイルをダブルクリックしてください。

プロジェクトの構造と設定

次のプロジェクト設定を使用できます。

  • Platform:プロジェクトの開発対象となるプラットフォームのバージョン。MetaTrader 4またはMetaTrader 5を指定します。
  • Program type:Expert Advisor、Indicator、Script、Libraryのいずれかを指定します。
  • Copyright:ソースコードの#property copyright ...と同様の著作権情報です。
  • Link:ソースコードの#property link ...と同様の、開発者サイトへのリンクです。
  • Version:ソースコードの#property version ...と同様のプログラムのバージョンです。
  • Icon:ソースコードの#property icon ...と同様のプログラムのアイコンです。
  • Description:ソースコードの#property description ...と同様のプログラムの説明です。
  • CPU:特定のプロセッサ命令セット向けにコンパイルを最適化します。X64 Regular、AVX、AVX2 + FMA3、AVX512 + FMA3から選択できます。
  • Maximum optimization:このオプションを有効にすると、アプリケーションの実行速度が向上します。
  • Check floating point dividers:このオプションを無効にすると、コード実行時にゼロ除算エラーのチェックを行わないため、アプリケーションの動作が若干高速になります。
  • Use tester optimization cache:最適化中、ストラテジーテスターは実行したすべてのパスの結果をキャッシュに保存します。結果は入力パラメータの各セットについて保存されます。これにより、同じパラメータで再最適化する際、再計算することなく保存済みの結果を使用できます。
    ただし、特定の処理(たとえば数学的な計算)では、以前の結果が存在するかどうかにかかわらず計算を実行する必要がある場合があります。その場合は、プロジェクトで[Use optimization cache]オプションを無効にしてください。すべてのテスト結果は引き続きキャッシュに保存されるため、ストラテジーテスターのレポートで実行済みのパスのデータを確認できます。
  • Calculate indicator on every tick in tester:このオプションはIndicatorプロジェクトでのみ利用できます。ストラテジーテスターの実行時に、ティックごとにインジケーターを強制的に計算します。このオプションはストラテジーテスターでの動作にのみ適用されます。プラットフォーム上では、インジケータは常に受信した各ティックで計算されます。
    インジケータを使用してEAをテストする場合、ストラテジーテスターは、インジケータバッファの値が要求されるなど、インジケータのデータにアクセスしたときにのみインジケータの値を計算します。EAが各ティックでインジケータの値を必要としない場合、この方式によってテストおよび最適化を大幅に高速化できます。インジケータを各ティックで計算する必要がある場合は、このオプションを有効にしてください。
    また、ストラテジーテスターでは、以下の場合にもインジケータが各ティックで計算されます。
  • ビジュアルモードでテストしている場合
  • インジケーターに EventChartCustom、OnChartEvent、OnTimer関数が含まれている場合
  • 1916未満のコンパイラービルドを使用してインジケーターが作成されている場合
  • Display a confirmation window before running the script:スクリプトを誤って実行することを防ぐため、実行前に確認ウィンドウを表示します。
  • Display a window with properties before running the script:スクリプトを実行する前に、入力パラメータを確認・変更できるプロパティウィンドウを表示します。

プロジェクトファイルで指定されたプロパティとソースコード内で指定されたプロパティが競合する場合、プロジェクトファイルで指定されたプロパティが優先されます。

プロジェクトへのファイルの追加と削除 #

ソースコードで使用されているすべてのファイルが、プロジェクトナビゲータに自動的に追加されます。たとえば、 #include ディレクティブを使用して新しいMQHファイルを追加すると、そのファイルは自動的にNavigatorの「Dependencies」セクションに表示されます。使用されているヘッダーファイルは「Headers」セクションに追加されます。 #resource ディレクティブによってプロジェクトのリソースとして使用されている画像、サウンド、その他のMQLプログラムは、「Resources」セクションに追加されます。

ソースコードを含むMQL5ファイルは「Sources」セクションに表示されます。テスト用のsetファイルやチャートテンプレートなどのその他のファイルは、「Settings and files」セクションに追加できます。

コンテキストメニューのコマンドを使用して、既存のファイルをプロジェクトに追加したり、プロジェクトから削除したりできます。ファイルを削除する際には注意してください。プロジェクトからファイルを削除して関連付けだけを解除することも、ファイル自体をディスクから完全に削除することもできます。

プロジェクトへのファイルの追加と削除

「既存フォルダーの追加」コマンドを使用すると、選択したディレクトリにある、サポート対象のすべてのファイルを一括してプロジェクトに追加できます。

手動でプロジェクトに追加したファイルは、プログラムコードには含まれず、プロジェクトディレクトリにもコピーされません。そのファイルはナビゲータに表示するためにプロジェクトに関連付けられるだけです。

プロジェクトのコンパイル #

プロジェクトのEX5実行ファイルを取得するには、プロジェクトまたはプログラムのメインMQ5ファイルを開き、コンパイルコマンド(F7)を実行します。ファイルはMQPROJプロジェクトファイルが格納されているディレクトリに作成されます。

グループプロジェクトをコンパイルすると、プログラムの種類に応じて、実行ファイルがローカルのExperts、Indicators、またはScriptsディレクトリに自動的にコピーされます。これにより、必要なディレクトリへ手動でコピーすることなく、MetaTraderですぐにプログラムを実行できます。

Shared Projects #

「Shared Projects」は、共同作業用の専用セクションです。このセクション内に作成したプロジェクトは、自動的にオンラインストレージにプッシュされます。

新しい共有プロジェクトを作成するには、「Shared Projects」を右クリックして[新規プロジェクト]を選択します。

共有プロジェクトの作成

その後、 MQL5 ウィザードで通常の手順を実行し、使用するプログラムの種類、名前、プロパティを設定します。共同プロジェクトでは、他の参加者が簡単に見つけられるよう、明確で分かりやすい名前を使用してください。プロジェクト名には、スペースのないラテン文字と数字のみを使用できます。

共有プロジェクトの作成が完了すると、MQL5 Algo Forge Webサイト上に、自分の名前でプライベートリポジトリとして表示されます。

Shared Projectsの公開範囲の変更 #

リポジトリをパブリックにしたり、特定のユーザーにアクセス権を付与したりできます。プロジェクトフォルダを右クリックし、[Shared Project Settings]を選択します。

「共有」を「プライベートプロジェクト」から以下のいずれかのオプションに変更します。

  • Private project:作成者のみがプロジェクトにアクセスできます。
  • Free-to-join project:誰でもプロジェクトに参加できます。
  • Join-by-request project:ユーザーがプロジェクトへの参加を申請でき、作成者が各申請を承認または拒否できます。

共有プロジェクトへのアクセスの構成

特定のユーザーにアクセス権を付与することもできます。[新規ユーザーを追加]をクリックし、そのユーザーのMQL5.communityログイン名を入力します。[権限]ドロップダウンをクリックすると、ユーザーに付与できる権限が表示されます。

  • Read:プロジェクトのファイルを表示およびダウンロードできます。
  • Read and Write:プロジェクトのファイルを表示、ダウンロード、および変更できます。
  • Administrator:Read and Writeのすべての操作に加えて、参加者のリストを管理できます。

公開プロジェクト #

公開プロジェクトとは、公開範囲がパブリックに設定されたリポジトリです。MQL5ユーザーであれば誰でも、公開プロジェクトのファイルをダウンロードしたり、フォーク して自分用のコピーを作成したり、所有者やメンテナーと共同作業したり、コードの変更を 提案 したりできます。

MetaEditorの[公開プロジェクト]タブは現在開発中です。その代わりに、MQL5 Algo Forge Webサイトで利用可能なパブリックプロジェクトを 閲覧 できます。 WebサイトMQL5 Algo Forgeは、アルゴリズム取引コミュニティ向けのGitHubのようなサービスです。

公開プロジェクトWebサイト

公開プロジェクトを フォーク すると、フォークしたコピーがWebサイト上で自分の名前のパブリックリポジトリとして表示されます。MetaEditorでフォークしたコピーをクローンすると、[ Shared Projects]に表示されます。

プロジェクトの公開範囲の変更

既存のプロジェクトを公開プロジェクトに変更したい場合は、その公開範囲をパブリックに設定します。実行する この操作は MetaEditorで行うか、MQL5 Algo Forge Webサイトで次の手順に従って実行できます。

リポジトリのページを開き、右上にある[設定]をクリックします。

リポジトリ設定Webページ

[リポジトリを非公開にする]オプションの選択を解除し、[設定を保存]をクリックします。

リポジトリ設定を変更する