ucsdets/datascience-notebook

datascience-notebook 镜像文档

镜像概述

datascience-notebook 是加州大学圣地亚哥分校（UCSD）通用数据科学课程的标准笔记本镜像。该镜像集成了数据科学研究与学习所需的核心工具和环境，旨在为用户提供开箱即用的数据分析、机器学习实践平台，无需手动配置复杂依赖。

核心功能与特性

多语言支持

• Python 3.7：配备完整的科学计算库，包括NumPy、Pandas、Scikit-learn、SciPy等
• R 3.6：集成tidyverse生态系统（dplyr、ggplot2、tidyr等）及统计分析工具（forecast、randomForest等）

开发环境

• Jupyter Notebook 6.0.3：支持交互式代码编写与结果展示
• JupyterLab 2.0.1：提供集成开发环境，支持多文档管理与终端交互
• IPython 7.13.0：增强的Python交互式解释器

环境管理

• Conda：通过Conda管理依赖，base环境包含200+科学计算包
• Pip：补充安装额外Python包，如datascience、folium、pytutor等

核心库与工具

• 数据处理：Pandas、NumPy、SciPy、R data.table
• 可视化：Matplotlib、Seaborn、Bokeh、ggplot2
• 机器学习：Scikit-learn、RandomForest、XGBoost（依赖中含相关库）
• 统计分析：Statsmodels、R forecast、plyr
• 图像处理：Scikit-image、Pillow

使用场景

• UCSD数据科学课程教学与实践
• 数据科学入门学习与实验
• 数据分析、机器学习模型开发原型验证
• 学术研究中的数据处理与可视化任务

使用方法

基本运行命令

通过Docker启动镜像，映射Jupyter端口（默认8888）：

bash
docker run -p 8888:8888 datascience-notebook

启动后，终端会输出Jupyter访问链接（含token），格式类似： http://127.0.0.1:8888/?token=<generated-token> 在浏览器中打开该链接即可使用Jupyter环境。

数据持久化

挂载本地目录到容器，实现数据持久化：

bash
docker run -p 8888:8888 -v /本地路径:/home/jovyan/work datascience-notebook

/home/jovyan/work为容器内默认工作目录，挂载后本地文件可直接在Jupyter中访问。

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  datascience-notebook:
    image: datascience-notebook
    ports:
      - "8888:8888"
    volumes:
      - ./notebooks:/home/jovyan/work
    environment:
      - JUPYTER_TOKEN=mysecret token  # 自定义访问token
    restart: unless-stopped

启动服务：docker-compose up -d

环境详情

Conda base环境

包含200+依赖包，核心类别：

• 基础工具：Python 3.7、R 3.6、Conda 4.7.12、Git
• 科学计算：NumPy 1.18.1、SciPy 1.4.1、h5py 2.10.0
• 数据分析：Pandas 1.0.2、Dask 2.11.0、Numba 0.48.0
• 可视化：Matplotlib 3.1.3、Seaborn 0.10.0、Bokeh 1.4.0
• 机器学习：Scikit-learn 0.22.2、XGBoost相关依赖
• R包：tidyverse、ggplot2、forecast、randomForest

Pip环境

补充安装的核心包：

• datascience 0.15.6：UCSD数据科学课程专用库
• folium 0.11.0：地理数据可视化
• pytutor 1.0.0：代码执行可视化工具
• nbgrader 0.6.0：Jupyter作业评分工具
• okpy 1.18.1：编程作业自动评测工具

完整依赖列表可通过容器内命令查看：

• Conda环境：conda list
• Pip环境：pip list