PR2025.12.24
鉄道ダイヤの最適化に学ぶ、生成AI活用 複雑なビジネス課題をチャットボットで前に進めるポイント
JuliaのDocumentationについて（全1記事）
コピーリンクをコピー
ブックマーク記事をブックマーク
ガーシー氏：始めさせていただきます。今回は「JuliaのDocumentationについて」ということで、Jupyter使ってるので、Juliaで無駄にMarkdownを書いてレンダリングしてるスライドになってます。
こんなアイコンでだいたい活動していて、アカウント名はこんな感じです。僕はJuliaを使い始めて1年くらいで、今月名古屋から東京に転勤してきました。
名古屋で「機械学習名古屋」に参加したときに、最初に発表してくださったantimon2さんがJuliaの発表をしていて、「すごいおもしろい言語だ」と思って使い始めました。ふだんはWebの開発をしてます。
みなさんJulia開発するときってドキュメンテーション書いてますか？
（会場挙手）
そんなに……。パッケージを作られるときはたぶん書くものかなと思うんですけど。ドキュメンテーションは、例えばこういう関数を作るときこんなふうに文字列で書くと。
よくヘルプで呼び出すときの内容が吐き出されます。
さっきのコメントのところが、Juliaでドキュメンテーションと呼ばれるものです。例えば「＋」のsearchで見てみると、こういう結果が返ってきます。
ここで中身の関数や型がどういうものを表してるのかを説明してくれます。
関数の、いわゆるドキュメンテーションコメントは、もともとコード中にただコメントを書くだけでした。
最初Pythonを使い始めて、PythonだとStringっていう概念で、それが文字列として返ってきて使えて、おもしろいと思っていたんですけど。
JuliaはなんとMarkdownで返ってきました。
さっきも「＋」で見たときMarkdownでこう返ってきてました。なんかすごくオシャレで見やすい。
ここもMarkdownのドキュメンテーションなんですけど、Fieldsのcontentの中にMarkdownのrawテキストみたいなのが入っています。
ここだとArrayで2-elementって書いてあるんですけど、「＋」だとこのドキュメンテーションは2ヶ所。Juliaは多重ディスパッチがあるので、それで複数の定義箇所から持って来てるので2つあります。
変数にも付けられます。変数に定義してドキュメンテーションコメントを書いていると、ヘルプでその変数のときも引いてくることができます。
関数以外にも付けられておもしろいなぁと思いました。
HTMLでも書けます。実際にこういうスクリプトを埋め込んだコメントを書いて、ヘルプを引くと……。まぁアラートが出てしまうんですけど（笑）。
（会場笑）
異質なコメントですね。
HTMLも全般書けるので、iframeとかも、僕の公式ホームページもレンダリングできます（笑）。
つまりiframe対策をこのWebサイトはしてないということです。
ちゃんとした使い方の例としては、TeXも書けるのでこういう感じでシグモイド関数を定義するときに、元の数式を定義しておきます。
画像もこういう感じで埋め込めるので「それがどういう特性を表しているのか」がけっこう見やすくなります。
ドキュメンテーションを動的に生成することもできます。
こういう数式を定義するような型を作っておいて、そこにgetdocのところで返ってくるドキュメンテーションの定義を置きます。
TeXの数式と実際の関数と画像を渡しておくと、さっきの型でインスタンスを生成したとき、ヘルプでこういうふうに（表示されます）。
いろんな数式を実装するときに使い回すこともできます。
時間になったので、これで終わります。ありがとうございます。
（会場拍手）
続きを読むには会員登録
（無料）が必要です。
会員登録していただくと、すべての記事が制限なく閲覧でき、
スピーカーフォローや記事のブックマークなど、便利な機能がご利用いただけます。
すでに会員の方はこちらからログイン
名刺アプリ「Eight」をご利用中の方は
こちらを読み込むだけで、すぐに記事が読めます！
スマホで読み込んで
ログインまたは登録作業をスキップ
この記事をブックマークすると、同じログの新着記事をマイページでお知らせします
PR2025.12.24
鉄道ダイヤの最適化に学ぶ、生成AI活用 複雑なビジネス課題をチャットボットで前に進めるポイント
PR2025.12.25
ペペロンチーノの材料調達と配送計画は“同じ問題” 日常とビジネスの意思決定に共通する「アクションの型」とは
PR2025.12.25
数理最適化で働き方を変える 日立コンサル平井氏の“意思決定デザイン”
PR2025.11.27
数理最適化のエキスパートが断言「AIブームで見落とされがちな重要技術」 1,300社が導入した「演繹的AI」が意思決定を変える
PR2025.11.28
「あの人がいなくなったら仕事が回らない」を解決 属人的な業務から脱却する「最適化」の実践方法
PR2025.11.28
「計画と運用」をごちゃ混ぜにすると崩壊する ビジネスに使える最適化システムの“境界線”の引き方
PR2025.11.27
9割がリピーターでも“飽きられない”仕掛け 馬渕磨理子氏×オリエンタルランドが語る、体験価値と「成長の3本柱」
PR2025.11.28
“テーマパークの外”への挑戦で売上1兆円を目指す 馬渕磨理子氏が迫る、オリエンタルランドの新領域戦略
PR2025.11.28
物価上昇時代の“もう1つの収入源” 自己資本約10万円から始められる、不動産投資の仕組みとリスク解説
PR2025.11.27
AIで激変する顧客体験──「金融機関」と「消費者」の関係を再設計 Brazeが描く“真の顧客エンゲージメント”とは
PR2025.12.24
鉄道ダイヤの最適化に学ぶ、生成AI活用 複雑なビジネス課題をチャットボットで前に進めるポイント
PR2025.12.25
ペペロンチーノの材料調達と配送計画は“同じ問題” 日常とビジネスの意思決定に共通する「アクションの型」とは
PR2025.12.25
数理最適化で働き方を変える 日立コンサル平井氏の“意思決定デザイン”
PR2025.11.27
数理最適化のエキスパートが断言「AIブームで見落とされがちな重要技術」 1,300社が導入した「演繹的AI」が意思決定を変える
PR2025.11.28
「あの人がいなくなったら仕事が回らない」を解決 属人的な業務から脱却する「最適化」の実践方法
PR2025.11.28
「計画と運用」をごちゃ混ぜにすると崩壊する ビジネスに使える最適化システムの“境界線”の引き方
PR2025.11.27
9割がリピーターでも“飽きられない”仕掛け 馬渕磨理子氏×オリエンタルランドが語る、体験価値と「成長の3本柱」
PR2025.11.28
“テーマパークの外”への挑戦で売上1兆円を目指す 馬渕磨理子氏が迫る、オリエンタルランドの新領域戦略
PR2025.11.28
物価上昇時代の“もう1つの収入源” 自己資本約10万円から始められる、不動産投資の仕組みとリスク解説
PR2025.11.27
AIで激変する顧客体験──「金融機関」と「消費者」の関係を再設計 Brazeが描く“真の顧客エンゲージメント”とは
