キカガクブログ 
- 最近プログラミングの勉強を始めた方
- コードの理解度を上げたい方
- コードを模写するだけではなく、自分で実装してみたい方
こんにちは、機械学習講師の竹内です。
みなさんはプログラミングをする際に、公式ドキュメントを読んでいますでしょうか。
公式ドキュメントとはフレームワークやライブラリ、言語の内容について、公式組織が公開している文書のことです。基本的には英語で書かれているものが多く、例えば Python や HTML など様々な公式ドキュメントが存在します。
私自身、プログラミングを学習し始めた時は公式ドキュメントを全く読んでいませんでしたが、勉強を進める中で公式ドキュメントに助けられたことが何度もありました。
本記事では、公式ドキュメントを読むことによるメリットを 3 つお伝えしたいと思います。
この文章は公式ドキュメントの情報だけを見ることを推奨するものではありません。しかし 1 次情報（公式ドキュメント）を見ることでしか得られないメリットもありますので、ぜひ公式ドキュメントを上手く活用してみてください。
メリット 1：必ず正しいことが書かれている
公式ドキュメントには必ず正しいことが書かれています。そのため、上手く動かないコードがあったとしても公式ドキュメントを調べれば必ず正解にたどり着けます。
具体例を用いて考えてみましょう。皆さんがコードを調べていた時、 A さんの記事と B さんの記事では以下のようにコードが書かれていました。
この場合どちらが正しいでしょうか。違いは kernel_size の部分です。
※ コードの内容はわからなくても問題ありません。
import torch
torch.nn.Conv2d(in_channels=1, out_channels=3, kernel_size=3)
import torch
torch.nn.Conv2d(in_channels=1, out_channels=3, kernel_size=(3, 3))実装して動かしてみるとわかりますが、この 2 つのコードはどちらとも正しいです。
なぜどちらとも正しいと言えるのでしょうか。公式ドキュメントを見て確認してみましょう。
出典：Conv2d — PyTorch 1.9.0 documentation
上記のドキュメントでは次のことが書かれています。
パラメータ
kernel_size,
stride,
padding,
dilationには，以下のいずれかを指定できます。
- 1つの
int– この場合，高さと幅の両方に同じ値が使われます。- 2つの
intのタプル – この場合，最初のintが高さの次元に， 2 番目のintが幅の次元に使用されます。
つまり kernel_size=3 と指定すると自動的に kernel_size=(3, 3) に変更してくれることが記載されています。そのため A さんの記事のコードと B さんの記事のコードはどちらとも正しいと言えます。
このように何が正しいのかわからなくなった時に公式ドキュメントは必ず正解を教えてくれます。
またプログラミング言語やフレームワークはバージョンが更新されると記述方法が大きく変わることも珍しくありません。
公式ドキュメントには必ず最新の記述方法が記載されているので、公式ドキュメントが読めると常に最新のバージョンに対応できます。
メリット 2：情報が網羅されている
公式ドキュメントには必ず全ての情報が記載されています。先程、具体例として記載したコードの公式ドキュメントを見てみましょう。
出典：Conv2d — PyTorch 1.9.0 documentation
こちらを A さんのコードと見比べてみましょう。
import torch
torch.nn.Conv2d(in_channels=1, out_channels=3, kernel_size=3)A さんは引数として in_channels, out_channels, kernel_size の 3 つしか指定していませんでしたが、他にも stride, padding, dilation, groups, bias, padding_mode, device, dtype を指定できることがわかります。
（stride=1 とはデフォルトで 1 という値が指定されていることを意味します。）
また、今回は torch.nn.Conv2d() クラスについて紹介しましたが、公式ドキュメントにはその他にどんなクラス（機能）があるかも確認できます。
出典：torch.nn — PyTorch 1.9.0 documentation
公式ドキュメントを調べることで今まで使ったことのない機能を知ることができます。
メリット 3：公式が推奨する実装方法やサンプルがある
公式ドキュメントを読み解いてコードを作ることはプログラミング初学者にとってかなり難しい作業かと思います。（私は最初の頃全くできませんでした…）
しかし公式ドキュメント内にはサンプルコードが記載されていることが多いです。つまり動くコードが記載されているということです。
先程、使用したコードの公式ドキュメントにもサンプルコードが記載されています。
出典：Conv2d — PyTorch 1.9.0 documentation
そのため以下のようなステップを踏むことでコードの理解を深めることができます。
補足 : 公式ドキュメントの読み方
公式ドキュメントは英語で書かれていることが多いため、英語が苦手で読むモチベーションが上がらない方もいらっしゃるかと思います。
そんなときは DeepL を使ってみてください。（無料で使えます！）
DeepL は機械翻訳ツールなのですが、翻訳の精度がかなり高く自然な日本語で読めます。私自身 DeepL を使用して公式ドキュメントを読んでいますのでぜひ皆さんも活用してみてください。
最後に：公式ドキュメントをうまく使おう
本記事では公式ドキュメントを読むことによるメリットについてお伝えしました。
しかし、最初にお伝えしたように公式ドキュメントだけを見るべきとお伝えしたいわけではありません。Web で検索すれば公式ドキュメントよりもわかりやすく伝えてくれる記事をたくさん見つけられます。
「最初の学習にはわかりやすい記事を使い、知識の深堀りに公式ドキュメントを使用する」といったように皆さんの学習ツールの 1 つとして活用していただければ幸いです。
まずは無料で学びたい方・最速で学びたい方へ
まずは無料で学びたい方： Python&機械学習入門コースがおすすめ
AI・機械学習を学び始めるならまずはここから！経産省の Web サイトでも紹介されているわかりやすいと評判の Python&機械学習入門コースが無料で受けられます！
さらにステップアップした脱ブラックボックスコースや、IT パスポートをはじめとした資格取得を目指すコースもなんと無料です！
最速で学びたい方：キカガクの長期コースがおすすめ
続々と転職・キャリアアップに成功中！受講生ファーストのサポートが人気のポイントです！
AI・機械学習・データサイエンスといえばキカガク！
非常に需要が高まっている最先端スキルを「今のうちに」習得しませんか？
無料説明会を週 2 開催しています。毎月受講生の定員がございますので確認はお早めに！
- 国も企業も育成に力を入れている先端 IT 人材とは
- キカガクの研修実績
- 長期コースでの学び方、できるようになること
- 料金・給付金について
- 質疑応答
