Julia公式ドキュメント翻訳ブログ

はじめに

　ブログをご覧の皆様、初めまして！執筆者のウランです。このブログを設立した目的は私自身がプログラミング言語Juliaに興味関心を持ったものの勉強をしようにも日本語のヒントがなく、英語の公式ドキュメントを読みながらセットアップやコーディングに慣れていかなければいけない面倒くささを感じたからです。

　そこで、英語で書かれている1000ページ越えの公式ドキュメントを片っ端から日本語に翻訳し、私より後にJuliaを勉強し、機械学習スキルを上げていきたいという方向けに助けになればという思いからブログをはじめさせていただきました。ただ、執筆者の私自身がPythonでさまざまな開発をやり始めて2年目に突入したばかりの駆け出しエンジニアですので、公式ドキュメントの翻訳内容や解釈に齟齬が出たりもすると思います。翻訳ミスやコーディングの仕方について解釈の相違など発見しましたらお問い合わせよりご指摘いただけますと幸いです。

　また、翻訳している公式ドキュメントはJulia-1.6.2になりますので、それより後のバージョンについて新しい情報を頂ければご指摘お願い致します。

※以下は作成中の箇所です。出来上がり次第順次更新していきます。

目次

1. Julia 1.6 ドキュメンテーション
2. 入門
   1. リソース
3. 変数
   1. 許可される変数名
   2. 文法
4. 整数と浮動小数点
   1. 整数
   2. 小数
   3. 任意精度演算
   4. 数値リテラル係数
   5. 文字通りの0と1
5. 数学演算と初等関数
   1. 算術演算子
   2. ブール演算子
   3. ビット演算
   4. 演算子の更新
   5. ベクトル化されたドット演算子
   6. 数値比較
   7. 演算子の優先順位と結合性
   8. 数値変換
6. 複雑な有理数
   1. 複素数
   2. 有理数
7. 文字列
   1. 文字
   2. 文字列の基本
   3. UnicodeとUTF-8
   4. 連結
   5. 補間
   6. トリプルクォートされた文字列リテラル
   7. 一般的な操作
   8. 非標準の文字列リテラル
   9. 正規表現
   10. バイト配列リテラル
   11. バージョン番号リテラル
   12. 生の文字列リテラル
8. 関数
   1. 引数の受け渡し動作
   2. 戻り値
   3. 演算子は関数
   4. 特別な名前の演算子
   5. 匿名関数
   6. タプル型
   7. 名前付きタプル
   8. 複数の戻り値
   9. 引数の破壊
   10. 可変因数関数
   11. オプションの引数
   12. キーワード引数
   13. デフォルト値の評価範囲
   14. 関数の引数のdo-block構文
   15. 機能構成と配管
   16. 関数をベクトル化するためのドット構文
   17. 参考文献
9. 制御フロー
   1. 複合式
   2. 条件付き評価
   3. 短絡評価
   4. 繰り返し評価: ループ
   5. 例外処理
   6. タスク(別名:コルーチン)
10. 変数のスコープ
    1. グローバルスコープ
    2. ローカルスコープ
    3. 定数
11. 型
    1. 型宣言
    2. 抽象型
    3. プリミティブ型
    4. 複合型
    5. 可変複合型
    6. 宣言された型
    7. ユニオン型
    8. パラメトリック型
    9. 全てのユニオン型
    10. シングルトン型
    11. Type(T) タイプセレクター
    12. エイリアス型
    13. 型の操作
    14. カスタムプリティプリント
    15. 型の種類
12. メソッド
    1. メソッドの定義
    2. メソッドのあいまいさ
    3. パラメトリックメソッド
    4. メソッドの再定義
    5. パラメトリック手法によるデザインパターン
    6. パラメトリックに制約された可変引数メソッド
    7. オプションおよびキーワード引数に関する注意
    8. 関数のようなオブジェクト
    9. 空のジェネリック関数
    10. メソッドの設計とあいまいさの回避
13. コンストラクター
    1. 外部コンストラクターメソッド
    2. 内部コンストラクターメソッド
    3. 不完全な初期化
    4. パラメトリックコンストラクター
    5. ケーススタディ: 合理的
    6. 外部のみのコンストラクター
14. 変換と促進
    1. 変換
    2. 促進
15. インターフェース
    1. 反復
    2. インデックス作成
    3. 抽象配列
    4. ストライド配列
    5. 放送のカスタマイズ
16. モジュール
    1. 名前空欄管理
    2. サブモジュールと相対パス
17. ドキュメンテーション
    1. ドキュメントへのアクセス
    2. 関数とメソッド
    3. 高度な使用法
    4. 構文ガイド
18. メタプログラミング
    1. プログラム表現
    2. 表現と評価
    3. マクロ
    4. コード生成
    5. 非標準の文字列リテラル
    6. 生成された関数
19. 多次元配列
    1. 基本機能
    2. 構築と初期化
    3. 配列リテラル
    4. 内包
    5. ジェネレータ式
    6. インデックス作成
    7. インデックス付きの割り当て
    8. サポートされているインデックスタイプ
    9. 反復
    10. 配列特性
    11. 配列およびベクトル化された演算子と関数
    12. 放送
    13. 実装
20. 欠測値
    1. 欠測値の伝播
    2. 等式および比較演算子
    3. 論理演算子
    4. 制御フローと短絡演算子
    5. 値が欠落した配列
    6. 欠落した値のスキップ
    7. 配列上の論理演算子
21. ネットワークとストリーム
    1. 基本ストリーム　入出力
    2. テキスト　入出力
    3. 入出力　コンテキストプロパティを出力する
    4. ファイルの操作
    5. 簡単なTCPの例
    6. IPアドレスの解決
    7. 非同期　入出力
22. 並列演算
23. 非同期プログラミング
    1. 基本的なタスク操作
    2. チャネルとの通信
    3. より多くのタスク操作
    4. タスクとイベント
24. マルチスレッド
    1. Juliaを複数のスレッドで開始
    2. データ競合の自由
    3. @threadsマクロ
    4. 不可分操作
    5. 副作用と可変関数の引数
    6. @threadの呼び出し
    7. 警告
    8. ファイナライザーの安全な使用
25. マルチプロセッシングと分散コンピューティング
    1. コードの可用性とパッケージのロード
    2. ワーカープロセスの開始と管理
    3. データの移動
    4. グローバル変数
    5. 並列マップとループ
    6. リモート参照と抽象チャネル
    7. チャネルとリモートチャネル
    8. ローカル呼び出し
    9. 共有された配列
    10. クラスターマネージャー
    11. ネットワークトポロジの指定（実験的）
    12. 注目すべき外部パッケージ
26. 外部プログラムの実行
    1. 補間
    2. 引用
    3. パイプライン
27. CとFortranのコードを呼び出す
    1. C互換のJulia関数ポインタの作成
    2. C型をJuliaにマッピングする
    3. C関数をJuliaにマッピングする
    4. Cラッパーの例
    5. Fortranラッパーの例
    6. ガベージコレクションの安全性
    7. 非定数関数仕様
    8. 間接呼び出し
    9. 閉鎖機能
    10. ライブラリを閉じる
    11. 呼び出し規約
    12. グローバル変数へのアクセス
    13. ポインタを介してデータにアクセスする
    14. スレッドの安全性
    15. コールバックの詳細
    16. C++
28. オペレーティングシステムのバリエーションの処理
29. 環境変数
    1. ファイルの場所
    2. 外部アプリケーション
    3. 並列化
    4. REPLフォーマット
    5. デバッグとプロファイリング
30. Juliaの埋め込み
    1. 高レベルの埋め込み
    2. VisualStudioを使用したWindowsへの高レベルの埋め込み
    3. 型の変換
    4. Juliaの関数の呼び出し
    5. メモリ管理
    6. 配列の操作
    7. 例外
31. コードの読み込み
    1. 定義
    2. パッケージのフェデレーション
    3. 環境
    4. 完了
32. プロファイリング
    1. 基本的な使い方
    2. 蓄積と清算
    3. プロファイル結果の表示を制御するためのオプション
    4. 構成
    5. メモリ割り当て分析
    6. 外部プロファイリング
33. スタックトレース
    1. スタックトレースの表示
    2. 有用な情報の抽出
    3. エラー処理
    4. 例外スタックとスタックのキャッチ
    5. バックトレースとの比較
34. パフォーマンスのヒント
    1. グローバル変数の回避
    2. @timeでパフォーマンスを測定し、メモリ割り当てに注意を払う
    3. ツール
    4. 抽象型パラメーターを持つコンテナの回避
    5. 型宣言
    6. 関数を複数の定義に分割する
    7. 「安定型」関数を書く
    8. 変数の型の変更の回避
    9. 個別のカーネル関数（別名: 関数バリア）
    10. パラメータとしての値を持つ型
    11. 多重ディスパッチを悪用する危険性（別名、パラメーターとしての値を持つ型の詳細）
    12. 列に沿って、メモリ順に配列にアクセス
    13. 出力の事前割り当て
    14. より多くのドット： ベクトル化された操作を融合する
    15. スライスにビューを使用することを検討する
    16. データのコピーは必ずしも悪いことではありません
    17. 小さな固定サイズのベクトル/行列演算にはStaticArrays.jlを検討してください
    18. 入出力の文字列補間を回避
    19. 並列実行中のネットワーク入出力を最適化する
    20. 非推奨の警告を修正
    21. 微調整
    22. パフォーマンス注釈
    23. 非正規化数をゼロとして扱います
    24. @code_warntype
    25. キャプチャされた変数のパフォーマンス
    26. シングルトンとの同等性のチェック
35. ワークフローのヒント
    1. REPLベースのワークフロー
    2. ブラウザベースのワークフロー
    3. 改訂ベースのワークフロー
36. スタイルガイド
    1. インデント
    2. スクリプトだけでなく関数を書く
    3. 過度に特定の型を書くことは避けてください
    4. 発信者の過剰な引数の多様性を処理する
    5. 引数を変更する関数の名前に!を追加
    6. 奇妙な型の共用体を避ける
    7. 手の込んだコンテナ型は避けてください
    8. Julia base/と一致する命名規則を使用する
    9. Juliaベースと同様の引数の順序で関数を記述します
    10. try-catchを使いすぎないでください
    11. 条件を括弧で囲まないでください
    12. 使いすぎないでください
    13. 不要な静的パラメータを使用しないでください
    14. インスタンスか型であるかについての混乱を避けてください
    15. マクロを使いすぎないでください
    16. インターフェースレベルで安全でない操作を公開しないでください
    17. 基本コンテナタイプのメソッドをオーバーロードしないでください
    18. 型の侵害を回避する
    19. 型の同等性に注意してください
    20. x->f(x)と書かないでください
    21. 可能であれば、ジェネリックコードの数値リテラルにfloatを使用しないでください
37. よくある質問
    1. 一般質問
    2. セッションとREPL
    3. スクリプティング
    4. 関数
    5. 型、型宣言、コンストラクター
    6. パッケージとモジュール
    7. 無と欠測値
    8. メモリ
    9. 非同期入出力と同時同期書き込み
    10. 配列
    11. コンピューティングクラスター
    12. Juliaのリリース
38. 他の言語との注目すべき違い
    1. MATLABとの注目すべき違い
    2. Rとの注目すべき違い
    3. Pythonとの注目すべき違い
    4. C/C++との注目すべき違い
    5. Lispとの注目すべき違い
39. Unicode入力
40. コマンドラインオプション
41. 要旨
    1. 前書き
    2. 移動
    3. キーワード
    4. スタンダードモジュール
    5. 基本サブモジュール
    6. 全てのオブジェクト
    7. 型のプロパティ
    8. 特殊な型
    9. ジェネリック関数
    10. 構文
    11. 欠測値
    12. システム
    13. バージョニング
    14. エラー
    15. イベント
    16. 反映
    17. 内部
    18. メタ
42. コレクションとデータ構造
    1. 反復
    2. コンストラクターと型
    3. 一般的なコレクション
    4. 反復可能なコレクション
    5. インデックス可能なコレクション
    6. 辞書
    7. セットのようなコレクション
    8. デキュー
    9. 実用的なコレクション
43. 数学
    1. 数学的演算子
    2. 数学的関数
44. 例
    1. カスタマイズ可能な二項演算子
45. 数
    1. 標準の数値型
    2. データフォーマット
    3. 一般的な数値関数と定数
    4. BigFloatsとBigInts
46. 文字列
47. 配列
    1. コンストラクターと型
    2. 基本機能
    3. 放送とベクトル化
    4. 索引付けと割り当て
    5. ビュー（サブアレイおよびその他のビュータイプ）
    6. 連結と順列
    7. 配列関数
    8. 組み合わせ論
48. タスク
    1. スケジューリング
    2. 同期
    3. チャネル
49. マルチスレッド
    1. 同期
    2. 不可分操作
    3. スレッドプールを使用して呼び出す（実験的）
    4. 低レベルの同期プリミティブ
50. 定数
51. ファイルシステム
52. 入出力とネットワーク
    1. 一般的な入出力
    2. テキストの入出力
    3. マルチメディアの入出力
    4. ネットワークの入出力
53. 句読点
54. ソートおよび関連機能
    1. ソート関数
    2. オーダー関連機能
    3. ソートアルゴリズム
    4. 代替注文
55. 反復実用性
56. Cインターフェース
57. LLVMインターフェース
58. Cスタンダードライブラリ
59. スタックトレース
60. SIMDサポート
61. アーティファクト
62. Base64
63. CRC32c
64. 日付
    1. コンストラクター