Almond Examples 镜像文档

镜像概述和主要用途

Almond Examples镜像包含一系列使用Almond Scala内核的Jupyter笔记本示例集合，旨在展示Almond在Jupyter环境中的功能特性和使用方法。该镜像提供多种便捷的运行和查看方式，适合快速学***、体验Scala在Jupyter中的编程及数据可视化应用。

核心功能和特性

• 丰富示例集合：包含多个Jupyter笔记本，全面展示Almond Scala内核的核心功能
• 多平台访问：支持通过浏览器直接交互式运行，无需本地安装配置
• 动态内容支持：兼容nbviewer，可正确渲染plotly、vegas等库生成的动态图表
• 便捷部署：提供Docker镜像，支持本地快速部署和个性化实验

使用场景和适用范围

• 学***Almond Scala内核的安装与使用
• 体验Scala语言在Jupyter环境中的编程实践
• 演示动态数据可视化在Scala中的实现方式
• 快速验证Almond相关功能原型

使用方法和配置说明

在Binder上交互式运行

最简单的入门方式是通过Binder在浏览器中运行示例，仅需一个浏览器即可开始使用。

Binder是一项可将包含Jupyter笔记本的Git仓库转换为可执行环境的服务，无需本地安装任何软件即可直接操作示例并尝试新内容。

在nbviewer中查看笔记本输出

可直接在GitHub上查看笔记本（GitHub提供基础Jupyter笔记本渲染功能），但该方式不执行JavaScript，无法显示plotly和vegas等库生成的动态图表。

推荐使用nbviewer查看，其支持直接从GitHub仓库加载笔记本并正确渲染动态内容：
项目所有笔记本的nbviewer列表

本地运行

通过Docker运行

基于最新Almond Docker镜像构建，运行命令如下：

bash
docker run -it --rm -p 8888:8888 almondsh/examples:latest

运行后，将Docker输出中的URL复制到浏览器即可访问。若需使用JupyterLab而非经典界面，在打开的URL中将"tree"替换为"lab"。

在本地机器安装运行

1. 安装Jupyter Notebook或JupyterLab
2. 安装Almond内核
3. 克隆项目仓库并在项目目录中运行jupyter notebook或jupyter lab
4. 打开示例笔记本进行交互操作