RStudioでコードをデバッグし、Rで新しいプロジェクトを作成する方法

今年の私への新年の贈り物は、新しいチームとR言語のプロジェクトでした。そのとき、私は少し知っていました。最初は難しくてはっきりしていませんでしたが、時間が経つにつれ、絵はきれいになりました。私たちはなんとか何かを理解することができました、何かがそのまま受け入れられなければなりませんでした。そして今、Rに取り組んで2か月半後、私は自分の経験を共有し、このプロジェクトの最初のステップについて話すことにしました。この非常に興味深い言語を習得する過程で私を圧倒した私の精神的な苦痛と感情のすべてを説明することはしませんが、問題の技術的な側面に焦点を当てます。私の記事の目的は、RStudioでコードをデバッグし、Rで新しいプロジェクトを作成する方法について説明することです。



私が最初に直面しなければならなかったのは、アプリケーションのデバッグでした。 RStudioでは、コードの個々のセクションを選択して実行することができます。デバッグモードではブレークポイントを設定できないため、これはRマークダウンを操作するときに非常に役立ちます。また、行を選択してどこでも実行できます。



コード行を実行する



さらに、彼はこれらの行で呼び出される変数を地球環境から取得します。この関数またはその関数がどのように機能するかを確認するには、グローバル変数を作成し、これらの関数からコードを1行ずつ実行して、何が起こるかを監視するだけで十分です。私はRStudioで働いており、これらの変数の値は[グローバル環境]タブで確認できます。



地球環境パネル



これらは、コンソールを介してこれらの変数の値を作成または変更します。



コンソール



しかし、変数の他に、別の問題があります。コマンドを1行ずつ実行すると、実行する行で呼び出される関数のコードが見つからない場合があります。これを行うには、それらもメモリにロードする必要があります。これを行うには、この関数のコードを含むファイルを開き、[ソース]ボタンをクリックする必要があります。



ソースボタン



RStudioには従来のデバッグモードもあります。ブレークポイントを設定する機能があり、デバッグモードで実行する機能とブラウザ()関数があり、Rがコードの実行を中断すると、アプリケーションをデバッグできます。しかし、私たちのプロジェクトでは、Rマークダウンを使用した作業のため、これは広く使用されていませんでした。



次にRで遭遇したのは、通常のプロジェクト(新規プロジェクト)とパッケージタイプのプロジェクト(Rパッケージ)の2種類のプロジェクトです。私がチームに参加したとき、これら2つが混在していました。パッケージがあるように見えましたが、ビルドされる予定はなく、RScrtiptを介して起動しました。今、私の同僚の努力のおかげで、私たちは実用的なRパッケージを手に入れました。



画像



通常のプロジェクト(新規プロジェクト)では、ソース()関数を介して1つのファイルが別のファイルに接続されているRスクリプトファイルを作成できます。したがって、スクリプトを実行すると、プロジェクトのすべてのファイルを含む「1つの非常に大きなファイル」のように見えます。それは必ずしも便利ではなく、あまり柔軟ではありません。



ソースボタン



通常のプロジェクトとは異なり、Rパッケージタイプのプロジェクトでは、Rで関数のライブラリを作成し、任意のマシンにインストールして、Rスクリプトファイル内でこれらの関数を呼び出すことができます。注意点が1つあります。関数はRスクリプトからのみ使用できます。したがって、それらを使用する前に、そのようなスクリプトを作成し、その中にこれらの関数の呼び出しを記述する必要があります。コマンドRscriptを使用してコンソールで起動されます。これを機能させるには、Rscript.exeファイルへのパスを環境変数に登録する必要があります。私のマシンでは、このパスは次のようになります 。C:\ Program Files \ R \ R-4.0.3 \ bin..。パッケージタイプのプロジェクトで独自の関数を作成する場合、開発モードでは、すべての変更をメモリにプルするload_all()関数を使用する必要があります。これを使用しない場合は、プロジェクトのコードを変更するたびに、これらの変更を有効にするために、インストールプロセスを開始する必要がありますが、Rはすぐには実行しません。



R-Packageプロジェクトについて:単純なプロジェクトとは異なり、特定の必要な構造と特別なファイルが含まれています。それ:



  • パッケージの説明を含むDESCRIPTIONファイル
  • 関数の説明用のmanフォルダー
  • 作成されたパッケージの使用可能な関数のリストを含むNAMESPACEファイル
  • Rと呼ばれるフォルダ。Rコードが含まれている必要があります。
  • .Rbuildignore ,
  • .Rhistory,
  • .RData Environment,


.Rhistoryと.RDataは、パッケージプロジェクトと通常のプロジェクトの両方に存在します。追加のリソース用のinstフォルダーと単体テスト用のtestフォルダーを作成することもできます。 Rパッケージがどのように機能し、なぜこのように機能するのかについての詳細 は、リンクをたどることができます



Rパッケージプロジェクトを作成するときは、roxygen2ユーティリティが使用されます。パッケージのドキュメントを作成するのに役立ちます。コード内で各関数を直接記述し、ユーティリティ自体がこの記述をmanフォルダーに転送して、必要な形式に変換し、関数に関する情報をNAMESPACEファイルに追加するという考え方です。 roxygen2の詳細については、こちらをご覧ください



プロジェクトを設定するための便利なパッケージもあります。これらは、プロジェクトを作成するためのほとんどすべての手順で使用されます。少なくとも、インターネットで見つけたすべての手順で使用されます。



  • devtools-メインパッケージ。プロジェクトを簡略化された形式で操作するためのほとんどのコマンドが含まれています。
  • usethisは、多くの日常的な操作を簡素化するヘルパーパッケージです。
  • testthat-ユニットテストを書くためのパッケージ
  • covr-ユニットテストカバレッジのコードをチェックするためのパッケージ


R言語の説明とドキュメントを含むすべてのパブリックパッケージは、CRANに保存されます-包括的なRアーカイブネットワーク(https://cran.r-project.org/)



便宜上、RStudioには、新しくチェックするための組み込みツールがすでに用意されています。プロジェクトを作成し(チェックパッケージ)、テストします(テストパッケージ)。



ビルドメニュー



彼は彼が望むすべてを言ったようですが、百回読むよりも一度見る方が良いです。以下は、Rの使用を開始する方法に関するビデオです。



  1. RStudioでRを使い始める。RプロジェクトまたはRパッケージ
  2. ユニットテストとドキュメントとともにRパッケージプロジェクトを作成する
  3. RパッケージプロジェクトのRコードの実行とデバッグ


私の経験では、新しいプログラミング言語を使用したプロジェクトに自分自身を見つけることは、ほとんどの場合、最大の問題は言語自体ではなく、言語を操作するためのツール、構成ツール、および環境設定です。うまくいけば、この記事を読んだ後、多くの人がRを使い始めるのがはるかに簡単になるでしょう。



All Articles