QS Ledger 项目使用教程

1. 项目目录结构及介绍

QS Ledger 项目的目录结构如下：

qs_ledger/
├── apple_health/
├── bonus_data_analysis_notebooks/
├── fitbit/
├── goodreads/
├── google_calendar/
├── google_sheets/
├── habitica/
├── instapaper/
├── kindle/
├── last_fm/
├── oura/
├── pocket/
├── rescuetime/
├── strava/
├── todoist/
├── toggl/
├── wordcounter/
├── .gitignore
├── Example_Combined_Personal_Data.ipynb
├── LICENSE.md
├── README.md
├── example_correlation_explorer_with_plotly.py
├── requirements.txt

目录介绍

• apple_health/: 包含与 Apple Health 数据相关的下载和分析脚本。
• bonus_data_analysis_notebooks/: 包含额外的数据分析笔记本。
• fitbit/: 包含与 Fitbit 数据相关的下载和分析脚本。
• goodreads/: 包含与 GoodReads 数据相关的下载和分析脚本。
• google_calendar/: 包含与 Google Calendar 数据相关的下载和分析脚本。
• google_sheets/: 包含与 Google Sheets 数据相关的下载和分析脚本。
• habitica/: 包含与 Habitica 数据相关的下载和分析脚本。
• instapaper/: 包含与 Instapaper 数据相关的下载和分析脚本。
• kindle/: 包含与 Kindle 数据相关的下载和分析脚本。
• last_fm/: 包含与 Last.fm 数据相关的下载和分析脚本。
• oura/: 包含与 Oura Ring 数据相关的下载和分析脚本。
• pocket/: 包含与 Pocket 数据相关的下载和分析脚本。
• rescuetime/: 包含与 RescueTime 数据相关的下载和分析脚本。
• strava/: 包含与 Strava 数据相关的下载和分析脚本。
• todoist/: 包含与 Todoist 数据相关的下载和分析脚本。
• toggl/: 包含与 Toggl 数据相关的下载和分析脚本。
• wordcounter/: 包含与 WordCounter 数据相关的下载和分析脚本。
• .gitignore: Git 忽略文件配置。
• Example_Combined_Personal_Data.ipynb: 示例笔记本，展示如何将多个数据源合并到一个统一的数据框架中。
• LICENSE.md: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• example_correlation_explorer_with_plotly.py: 示例代码，使用 Plotly 和 Dash 进行数据相关性分析。
• requirements.txt: 项目依赖文件。

2. 项目启动文件介绍

QS Ledger 项目主要通过 Jupyter Notebook 进行数据下载和分析。以下是主要的启动文件：

• Example_Combined_Personal_Data.ipynb: 该笔记本展示了如何将多个数据源的数据合并到一个统一的数据框架中。启动该笔记本可以开始数据合并和分析。
• example_correlation_explorer_with_plotly.py: 该脚本使用 Plotly 和 Dash 进行数据相关性分析。可以通过命令行运行该脚本，启动相关性分析工具。

3. 项目配置文件介绍

QS Ledger 项目的主要配置文件是 requirements.txt，该文件列出了项目所需的所有 Python 依赖包。以下是配置文件的介绍：

• requirements.txt: 该文件包含了项目运行所需的所有 Python 包及其版本信息。可以通过以下命令安装所有依赖：

  pip install -r requirements.txt
  

  该文件的内容示例如下：

  pandas==1.3.3
  numpy==1.21.2
  matplotlib==3.4.3
  seaborn==0.11.2
  plotly==5.3.1
  dash==2.0.0
  

  这些依赖包用于数据处理、分析和可视化。

通过以上步骤，您可以顺利启动和配置 QS Ledger 项目，开始您的个人数据聚合和分析之旅。