网站设计公司名称教育行业网站开发

网站设计公司名称,教育行业网站开发,我爱你域名的网站,湖北洈水水利水电建设公司网站Jupyter Notebook 这个名字#xff0c;很多人第一次听到#xff0c;会把它当成一个写 Python 的工具。其实它更像是一种交互式计算文档的思想落地#xff1a;把可运行的代码、代码运行后的输出、解释性的文字、公式、图表、图片乃至交互控件#xff0c;装进同一份文档里很多人第一次听到会把它当成一个写 Python 的工具。其实它更像是一种交互式计算文档的思想落地把可运行的代码、代码运行后的输出、解释性的文字、公式、图表、图片乃至交互控件装进同一份文档里让读者既能阅读叙事也能复现实验与推导。官方对它的经典描述是它是一套基于 Web 的交互式计算环境用来创建与分享计算型文档文档里可以同时包含 Live code、叙事文本、公式与可视化等内容。 (jupyter.org)很多软件把自己叫做notebook但 Jupyter Notebook 的独特之处在于它既是一种文件格式与规范也是一整套围绕这份规范构建的生态。Project Jupyter本身是一个伞状项目覆盖了 Notebook、JupyterLab、内核协议、文件格式等多个子项目核心目标是为计算型笔记本提供工具与标准。 (docs.jupyter.org)名字从哪里来为什么它不只服务于 PythonJupyter 的命名很有工程师的幽默感它既是 Julia、Python、R 三种语言名字的组合梗也借用了伽利略在木星观测记录里写笔记的意象。更重要的是这个名字背后暗示了一个转向Notebook 不再被限定为Python 专属而是面向多语言的交互式计算载体。 (Jupyter Blog)在实际使用里你会看到 Jupyter 支持几十种语言的内核实现常见的包括 Python、R、Julia、Scala 等。Jupyter 官方站点也强调它支持 40 多种编程语言。 (jupyter.org)把它说清楚Jupyter Notebook 到底是什么从工程视角看Jupyter Notebook这四个字经常指向三层含义混在一起就容易产生误解。一层是文档本身磁盘上的一个.ipynb文件。它不是神秘二进制而是一个结构化的JSON文档里面按单元格 cell组织内容代码、文本、输出、元数据都在里面。Jupyter 的架构文档明确写到Notebook 保存到磁盘时使用.ipynb扩展名并采用JSON结构。 (docs.jupyter.org)一层是编辑与展示界面你在浏览器里看到的经典 Notebook 界面或更现代的 JupyterLab。JupyterLab 被官方定位为下一代 Web 交互式界面它把 Notebook、文本编辑器、终端、文件浏览器等多种工作流统一在一个可扩展的界面里。 (jupyterlab.readthedocs.io)一层是运行时系统负责管理文件、会话与内核的服务器进程以及执行代码的内核进程。你在界面里按下运行其实是前端把请求发给服务器服务器再把请求转交给内核执行。把这三层拆开理解你就能明白很多日常现象为什么关掉浏览器标签页代码可能还在跑为什么复制一个.ipynb文件给别人他打开后图表可能不显示或提示不受信任为什么同一个 Notebook 文件既可以用经典界面打开也可以用 JupyterLab 打开。核心机制cell、kernel、server 三者如何协作cell文档的基本粒度Notebook 里的内容以 cell 为基本单位。常见类型是Code cell可以执行代码并把输出挂在这个 cell 下面Markdown cell写解释文字、公式、图片链接等Raw cell原样文本常用于导出流程的特殊控制这种组织方式让 Notebook 兼具源码与报告的属性。它不是把代码粘贴进 Word也不是在 IDE 里写一堆注释而是把叙事与计算绑定在同一个可执行上下文里。kernel真正执行代码的进程Kernel 是计算的心脏。你运行的代码并不是在浏览器里跑而是在某个内核进程里跑。前端与内核之间靠消息协议通信前端发执行请求内核回执行结果、标准输出、错误栈、富媒体输出等。Jupyter 的消息协议文档描述了客户端与内核之间的通信规范并指出它们通过ZeroMQ等传输机制实现。 (jupyter-client.readthedocs.io)server连接浏览器与内核的桥梁浏览器不直接连ZeroMQ因为浏览器环境里做这种套接字通信不现实。Jupyter Server 的文档把这件事说得很直白内核用ZeroMQ套接字通信而 Web 应用侧使用WebSocket服务器负责在两边转发消息。 (Jupyter Server)这也解释了为什么你可以在远程服务器上跑内核在本机浏览器里交互浏览器只需要能访问服务器的HTTP/WebSocket端口。.ipynb文件里装了什么可读的 JSON 与 nbformat 规范.ipynb的底层是JSON并由nbformat规范定义。规范文档强调Notebook 是简单的JSON文档包含文本、源代码、富媒体输出与元数据每一段都以 cell 形式存储。 (nbformat.readthedocs.io)你可以把它理解成一个带版本号的结构化文档协议。它大致包含cells每个 cell 的类型、源码、输出、元数据metadata内核信息、语言信息、扩展记录等nbformat与nbformat_minor格式版本这种设计带来很多好处生态工具能读写同一格式Notebook 能被转换成HTML、PDF、Markdown也能被程序自动生成与批量执行。代价也很明显JSON文件对Git diff不友好输出里如果包含大段二进制编码或富媒体会让版本库膨胀合并冲突也更难处理。后面我会给一些工程化解法。运行模型的真实面貌它是有状态的交互式 REPL而不是脚本很多人用 Notebook 踩坑根子不在语法而在运行模型。Notebook 的内核是一个长期存活的进程行为更接近增强版 REPL你可以反复运行某个 cell变量就覆盖可以跳着执行内存状态就变得像一锅汤可以在上面 import 一堆东西后面随意调用。这种自由度适合探索与推导但它和脚本一次性从上到下执行的心智模型不同。工程上想要让 Notebook 可靠有几条很朴素但极其有效的习惯在分享或提交前用界面里的Restart Kernel然后Run All确保从零状态也能跑通把关键参数集中在前面一两个 cell减少到处散落的魔法数避免在不同 cell 里定义同名函数或同名变量却含义不同输出图表时尽量固定随机种子与版本信息让结果更可复现这些建议听起来像经验之谈但它们都在对抗同一个问题Notebook 的执行顺序与文档阅读顺序并不必然一致。Jupyter Notebook 与 JupyterLab界面之争背后的工作流差异经典 Notebook 界面更文档导向像一张不断延展的纸。JupyterLab 更像可组合的开发环境左侧文件浏览器右侧多标签工作区Notebook、终端、编辑器、数据文件可以并排。官方文档强调 JupyterLab 是可扩展、集成式的工作环境适合更复杂的工作流。 (jupyterlab.readthedocs.io)在团队里常见的分工是个人探索、写教程、写研究记录Notebook 或 JupyterLab 都行经典界面更轻需要终端、文件树、多个面板联动JupyterLab 更顺手需要把 Notebook 变成给别人用的交互应用会走到 Voilà 或类似方案安全这件事别掉以轻心能运行任意代码就意味着高权限风险无论 Notebook 还是 Jupyter Server本质上都是远程代码执行环境。文档里写得非常直接访问 Jupyter Server 就意味着能够运行任意代码因此必须限制访问默认启用基于 token 的认证。 (Jupyter Server)另一个经常被忽略的点是 Notebook 的信任机制。Notebook 文件里可以包含HTML与JavaScript输出如果你从别人那里拿到一个.ipynb直接打开并显示这些输出就可能产生跨站脚本或更复杂的攻击面。经典 Notebook 的安全文档描述了签名校验机制服务器会计算 Notebook 的签名并与数据库比对匹配则信任其HTML与JavaScript输出否则以不受信任方式加载。 (jupyter-notebook.readthedocs.io)工程上比较稳妥的做法是不要把未审查的 Notebook 当成普通文档点开就看输出共享给他人前尽量清理输出或用可信环境重新执行生成输出公网部署不要关认证不要把服务裸露在互联网必要时用反向代理与更严格的鉴权生态工具链Notebook 不止能手工点点点nbconvert把 Notebook 变成可交付物也能批量执行很多团队会把 Notebook 当作可执行报告提交时不只给.ipynb还会导出HTML或PDF作为交付件。nbconvert提供了执行 Notebook 并保存输出的能力文档明确介绍了它可以执行.ipynb输入并把包含输出的结果保存为.ipynb。 (nbconvert.readthedocs.io)ipywidgets让 Notebook 从静态文档变成可交互实验台如果你在 Notebook 里做参数敏感性分析ipywidgets这种交互控件会很爽。官方文档把它定义为面向 Notebook 的浏览器交互控件包含滑条、复选框、文本输入等并强调交互控件能让 Notebook活起来。 (ipywidgets.readthedocs.io)JupyterHub把 Notebook 交给一群人用课堂、企业数据团队、研究组常见需求是多人同时用同一套 Notebook 服务但每个人又要隔离环境与资源。JupyterHub 的定位就是多用户 Hub负责生成、管理、代理多个单用户 Notebook 服务器实例。 (JupyterHub)Jupytext用文本格式解决版本控制与 diff 痛点.ipynb是JSON在Git里读起来费劲。Jupytext 的思路是把 Notebook 的输入内容保存成.py或.md等纯文本天然适合版本控制并且可以选择与.ipynb配对。它的文档强调文本 Notebook 很适合版本控制输出默认不落盘除非你选择与.ipynb配对。 (Jupytext)Voilà把 Notebook 变成一个真正给别人用的 Web 应用当你的 Notebook 里有控件、有交互逻辑你可能不想把代码 cell暴露给最终用户。Voilà 的文档与仓库介绍它可以运行、转换并把 Notebook 作为独立应用提供服务并说明每个连接用户会获得独立的内核用于执行控件回调。 (voila.readthedocs.io)一段可运行的完整示例自动生成 Notebook、执行、导出 HTML下面这段代码是一个完整脚本做三件事用nbformat生成一个新的.ipynb用nbconvert的执行预处理器把 Notebook 跑一遍并保存输出导出成一个HTML文件便于交付或归档你只要装好依赖就能跑。依赖通常在安装 Jupyter 时就会带上缺什么再补什么即可。# 文件名: make_and_run_notebook.py# 运行: python make_and_run_notebook.py# 产物: demo_notebook.ipynb / demo_notebook.executed.ipynb / demo_notebook.htmlfrom__future__importannotationsfrompathlibimportPathimportnbformatfromnbformat.v4importnew_notebook,new_code_cell,new_markdown_celldefbuild_notebook()-nbformat.NotebookNode:nbnew_notebook()nb.cells.append(new_markdown_cell(# Demo: 在 Jupyter Notebook 里写一份可执行的小报告\n\n这份 Notebook 展示三件事\n- 代码与叙事文字放在同一份文档\n- 运行代码产生输出\n- 生成一张简单的图\n))nb.cells.append(new_code_cell(import math\ndata [math.sin(i / 10.0) for i in range(0, 100)]\nsummary {\n \count\: len(data),\n \min\: min(data),\n \max\: max(data),\n \mean\: sum(data) / len(data),\n}\nsummary\n))nb.cells.append(new_markdown_cell(下面用 matplotlib 画一张曲线图。))nb.cells.append(new_code_cell(import matplotlib.pyplot as plt\n\nplt.figure()\nplt.plot(data)\nplt.title(\sin curve\)\nplt.xlabel(\index\)\nplt.ylabel(\value\)\nplt.show()\n))returnnbdefsave_notebook(nb:nbformat.NotebookNode,path:Path)-None:path.write_text(nbformat.writes(nb),encodingutf-8)defexecute_notebook(src_path:Path,dst_path:Path,timeout:int120)-None:fromnbconvert.preprocessorsimportExecutePreprocessor nbnbformat.read(src_path,as_version4)epExecutePreprocessor(timeouttimeout,kernel_namepython3)# metadata.path 决定 Notebook 执行时的工作目录ep.preprocess(nb,{metadata:{path:str(src_path.parent)}})nbformat.write(nb,dst_path)defexport_html(nb_path:Path,html_path:Path)-None:fromnbconvert.exportersimportHTMLExporter nbnbformat.read(nb_path,as_version4)exporterHTMLExporter()body,_resourcesexporter.from_notebook_node(nb)html_path.write_text(body,encodingutf-8)defmain()-None:out_dirPath(.).resolve()srcout_dir/demo_notebook.ipynbexecutedout_dir/demo_notebook.executed.ipynbhtmlout_dir/demo_notebook.htmlnbbuild_notebook()save_notebook(nb,src)execute_notebook(src,executed)export_html(executed,html)print(generated:,src)print(executed :,executed)print(html :,html)if__name____main__:main()如果你本机缺依赖可以这样装python -m pipinstallnbformat nbconvert matplotlib跑完脚本后你可以用JupyterLab或经典 Notebook 打开demo_notebook.executed.ipynb看运行后的输出也可以直接用浏览器打开demo_notebook.html把它当成一份可交付的静态报告。nbconvert能执行并保存 Notebook 输出这一点在它的文档里有明确说明。 (nbconvert.readthedocs.io)它擅长什么也不擅长什么Notebook 最擅长的场景是探索性计算与解释性表达同时发生的地方数据分析、科研推导、教学演示、实验记录、可视化报道、机器学习原型验证。它把思路与证据放在一起读者不需要脑补你怎么从 A 推到 B因为 B 就是代码跑出来的输出。但如果你把它当成大型软件工程的主战场它的短板也会显出来单个内核长期运行状态复杂容易出现只在我电脑上能跑.ipynb的JSON结构让代码评审与合并冲突变得笨重过度依赖交互会让可复现与自动化流水线变得脆弱这也是为什么成熟团队经常把 Notebook 定位为实验台或可执行说明书而把稳定的生产逻辑沉淀为包、模块、服务或工作流再在 Notebook 里调用它们。用这种分层方式Notebook 负责把复杂系统讲清楚生产代码负责把系统跑稳定。一点经验之谈把 Notebook 用得更像工程而不是临时草稿把关键逻辑做成可导入的模块在 Notebook 里只做调用与展示输出与输入分离Notebook 记录输入参数、运行步骤、图表结果原始数据与模型权重用外部文件管理用Jupytext之类的工具把输入内容落到.py或.md降低Git审查成本 (Jupytext)共享时坚持用干净环境RestartRun All让读者拿到的是可复现的路径公网部署严格鉴权默认 token 机制别关别把能执行任意代码的入口当成普通静态网站 (Jupyter Server)如果你愿意再往深处挖我也可以把Jupyter的消息协议按一次真实的execute_request到iopub输出的链路画出来配上一个最小内核与最小客户端示例让你从协议层彻底吃透它为什么能支持多语言与多前端。