{Documentation} Adding intro page to projectaria-tools.

Summary: This diff adds a intro page for projectaria_tools.

Reviewed By: kongchen1992

Differential Revision: D84951849

fbshipit-source-id: a2ee9ae2ebc82aac4ca1e00c1f4a5dc6722179f2

Author: YLouWashU

website/docs-ark/mps/start.mdx

@@ -54,7 +54,7 @@ Note that if the above command emits some error, please refer to the [troublesho
 
 Project Aria MPS CLI is only available if you install the pip installation version of Project Aria MPS. This installation has been designed to be simple to use, even if you are not familiar with programming languages.
 :::info Dependencies
-Project Aria MPS pypi package automatically installs the [projectaria-tools](/research-tools/projectariatools/start#installing) package and [projectaria-vrs-health-check](/ark/vrs_health_check/installation#installing-vrs-health-check) package
+Project Aria MPS pypi package automatically installs the [projectaria-tools](/research-tools/projectariatools/installation#installing) package and [projectaria-vrs-health-check](/ark/vrs_health_check/installation#installing-vrs-health-check) package
 :::
 
 ## Supported Platforms

website/docs-ark/vrs_health_check/installation.mdx

@@ -19,7 +19,7 @@ rm -rf $HOME/projectaria_gen2_python_env
 python3 -m venv $HOME/projectaria_gen2_python_env
 source $HOME/projectaria_gen2_python_env/bin/activate
 
-python3 -m pip install projectaria-tools-vrs-health-check
+python3 -m pip install projectaria-vrs-health-check
 ```
 </TabItem>
 <TabItem value="windows" label="Windows">

website/docs-research-tools/osi.mdx

@@ -75,7 +75,7 @@ Choose your starting point based on your research goals:
 Begin with the [Aria Gen 2 Pilot Dataset](/research-tools/dataset/pilot/content) to explore available data. Then follow the [Download Guide](/research-tools/dataset/pilot/download) to access the dataset and start your research.
 
 ### For Tool Users
-Install [Project Aria Tools](/research-tools/projectariatools/start) to work with Aria data. The library provides Python APIs and tutorials for loading, visualizing, and processing VRS files.
+Install [Project Aria Tools](/research-tools/projectariatools/installation) to work with Aria data. The library provides Python APIs and tutorials for loading, visualizing, and processing VRS files.
 
 ### For Algorithm Developers
 Explore the Open Models section to access pre-trained models and algorithms. Use them as baselines or building blocks for your own research.

website/docs-research-tools/projectariatools/_category_.json

@@ -1,4 +1,8 @@
 {
   "label": "Project Aria Tools",
-  "position": 0
+  "position": 0,
+  "link": {
+    "type": "doc",
+    "id": "projectariatools/overview"
+  }
 }

website/docs-research-tools/projectariatools/advanced-installation.mdx

@@ -14,7 +14,7 @@ This page covers advanced installation options to build Project Aria Tools from
 
 
 ## Pre-requisites: install dependencies {#prerequisites}
-Before proceed to any of the advanced installation steps, please follow the command in [the installer widget on Quick Start page](/docs-research-tools/projectariatools/start.mdx#installing) to pull the correct branch from Github.
+Before proceed to any of the advanced installation steps, please follow the command in [the installer widget on Quick Start page](/docs-research-tools/projectariatools/installation.mdx#installing) to pull the correct branch from Github.
 
 Then install the following third party dependency lib:
 ```mdx-code-block

website/docs-research-tools/projectariatools/start.mdx renamed to website/docs-research-tools/projectariatools/installation.mdx

@@ -1,6 +1,6 @@
 ---
 sidebar_position: 0
-title: Get Started
+title: Installation
 ---
 
 import React, { useEffect, useMemo, useState } from "react";
@@ -29,16 +29,3 @@ Use the above table to get the exact command to install `projectaria-tools` libr
 | macOS (Apple Silicon / ARM64) | macOS **14+ (Sonoma or newer)** on M1/M2/M3                        | ✅ Supported                              | 3.10 – 3.12              |
 | macOS (Intel)                 | macOS **13+ (Ventura or newer)**                                   | ✅ Supported                              | 3.8 – 3.12               |
 | Windows (x64)                 | MSVC **2019/2022**                                                 | 🚧 Planned                               | 3.10 – 3.12              |
-
-
-
-## Python Notebook Tutorials
-
-Proceed to the following Python notebook tutorials to learn how to use the Python APIs to consume Aria data:
-- [Tutorial 1: VrsDataProvider Basics](/docs-research-tools/projectariatools/pythontutorials/dataprovider.mdx): how to perform basic operations in loading and access data in an Aria VRS file.
-- [Tutorial 2: Device Calibration](/docs-research-tools/projectariatools/pythontutorials/calibration.mdx): how to work with device calibration in Aria VRS.
-- [Tutorial 3: Queued Sensor Data](/docs-research-tools/projectariatools/pythontutorials/queue.mdx): how to use the unified queued API to efficiently “stream” multi-sensor data.
-- [Tutorial 4: On-Device Eye Tracking and Hand Tracking](/docs-research-tools/projectariatools/pythontutorials/eyetracking-handtracking.mdx): how to work with on-device-generated EyeGaze and Hand-tracking signals from Aria Gen2 glasses.
-- [Tutorial 5: On-Device VIO](/docs-research-tools/projectariatools/pythontutorials/vio.mdx): how to work with on-device-generated VIO data from Aria Gen2 glasses.
-- [Tutorial 6: Timestamp Mapping in Single- and Multi-Device Recordings](/docs-research-tools/projectariatools/pythontutorials/time-sync.mdx): understanding timestamp mapping in Aria data, and how to use timestamp mapping in multi-device recording.
-- [Tutorial 7: Machine Perception Services (MPS) Data Loading](/docs-research-tools/projectariatools/pythontutorials/mps.mdx): how to load and visualize output data from Aria MP.

website/docs-research-tools/projectariatools/overview.mdx

@@ -0,0 +1,47 @@
+---
+sidebar_position: 0
+title: Project Aria Tools Overview
+---
+
+# Project Aria Tools
+
+`projectaria-tools` is the official library for accessing and processing data recorded by **Project Aria glasses**.
+It provides a unified interface to load VRS files and access all associated sensor and machine perception data through high-level, easy-to-use APIs.
+The library supports efficient operations such as random access, timestamp-based queries, and synchronized multi-sensor data retrieval, with a consistent set of **C++ and Python APIs** seamlessly bridged via Pybind11.
+
+Project Aria glasses record its data in **VRS** (Visual Recordings System) format, which is a general-purpose recording format from Meta.
+Properly interpreting Project Aria VRS requires detailed understanding of the device’s sensor configurations, calibration models, and on-device perception outputs.
+`projectaria-tools` abstracts these complexities, ensuring that all data is correctly parsed, aligned, and represented for research and development workflows.
+
+In addition to data access, the library includes visualization and conversion utilities that allow users to inspect and export selected streams to standard formats such as CSV and MP4, making it easier to analyze and share Aria data across diverse toolchains.
+
+## Getting Started
+
+If you're new to `proejctaria-tools`, start here:
+
+- **[Quick Start Installation Guide](./installation.mdx)** - Learn how to install `projectaria-tools` on your system
+- **[Advanced Installation](./advanced-installation.mdx)** - Advanced installation options and configurations
+- **[Pixi Installation](./advanced-installation-pixi.mdx)** - Install using Pixi package manager
+
+
+## Python Notebook Tutorials
+
+Explore our comprehensive Python tutorials to learn how to work with Aria data:
+
+- [Tutorial 1: VrsDataProvider Basics](/docs-research-tools/projectariatools/pythontutorials/dataprovider.mdx): how to perform basic operations in loading and access data in an Aria VRS file.
+- [Tutorial 2: Device Calibration](/docs-research-tools/projectariatools/pythontutorials/calibration.mdx): how to work with device calibration in Aria VRS.
+- [Tutorial 3: Queued Sensor Data](/docs-research-tools/projectariatools/pythontutorials/queue.mdx): how to use the unified queued API to efficiently “stream” multi-sensor data.
+- [Tutorial 4: On-Device Eye Tracking and Hand Tracking](/docs-research-tools/projectariatools/pythontutorials/eyetracking-handtracking.mdx): how to work with on-device-generated EyeGaze and Hand-tracking signals from Aria Gen2 glasses.
+- [Tutorial 5: On-Device VIO](/docs-research-tools/projectariatools/pythontutorials/vio.mdx): how to work with on-device-generated VIO data from Aria Gen2 glasses.
+- [Tutorial 6: Timestamp Mapping in Single- and Multi-Device Recordings](/docs-research-tools/projectariatools/pythontutorials/time-sync.mdx): understanding timestamp mapping in Aria data, and how to use timestamp mapping in multi-device recording.
+- [Tutorial 7: Machine Perception Services (MPS) Data Loading](/docs-research-tools/projectariatools/pythontutorials/mps.mdx): how to load and visualize output data from Aria MP.
+
+
+## Visualization Tools
+
+Tools for visualizing and exploring Aria data:
+
+- **[Python Visualization](./tools/pythonviz.mdx)** - Python-based visualization
+- **[C++ Visualization](./tools/cppviz.mdx)** - C++ visualization tool
+- **[VRS to MP4](./tools/vrstomp4.mdx)** - Convert VRS recordings to MP4 video
+- **[Export to CSV](./tools/exportcsv.mdx)** - Export sensor data to CSV format

website/docs-research-tools/projectariatools/pythontutorials/calibration.mdx

@@ -214,7 +214,7 @@ ray_3d = camera_calib.unproject(test_pixel)
 print(f"Pixel {test_pixel} unprojected to -> 3D ray {ray_3d}")
 ```
 
-## Camera Intrinsics: undistortion
+### Camera Intrinsics: undistortion
 
 Camera calibration enables post-processing of Aria images, such as undistorting images from a fisheye to a linear camera model. Steps:
 

website/docs-technical-specs/vrs/useful-tools.mdx

@@ -5,6 +5,6 @@ title: Useful VRS Tools
 
 # Useful VRS Tools
 
-* The most intuitive way to access Aria VRS files is via the tools (and APIs) shipped in [`projectaria-tools` library](/research-tools/projectariatools/start), which includes tools to [visualize Aria VRS](/research-tools/projectariatools/tools/pythonviz), [convert to MP4](/research-tools/projectariatools/tools/vrstomp4), and [export to other data format](/research-tools/projectariatools/tools/exportcsv).
+* The most intuitive way to access Aria VRS files is via the tools (and APIs) shipped in [`projectaria-tools` library](/research-tools/projectariatools/installation), which includes tools to [visualize Aria VRS](/research-tools/projectariatools/tools/pythonviz), [convert to MP4](/research-tools/projectariatools/tools/vrstomp4), and [export to other data format](/research-tools/projectariatools/tools/exportcsv).
 * Users can inspect the data quality of Aria VRS file using [`VrsHealthCheck`](/ark/vrs_health_check/installation), which is a tool that we specially tailored for Aria VRS recordings.
 * Users can also choose to use [the native tool provided by the `VRS` library](https://facebookresearch.github.io/vrs/) to perform some simple actions on the VRS file, including inspecting basic data information, extracting to images or audio files, etc. But please note that the `VRS` library needs to be [built with H.265 decoding support](https://github.com/facebookresearch/vrs#build--run-with-h265-hevc-decoding-support-macos--linux) in order to properly handle Aria Gen2 VRS files.

website/docs/intro.mdx

@@ -69,7 +69,7 @@ Project Aria’s offering to the research community is organized into two major
 
 - **[Open Datasets](/research-tools/dataset/pilot/content):** Explore and download egocentric datasets
 - **Pre-trained Models:** Use and fine-tune state-of-the-art models for your research. Coming soon
-- **[Project Aria Tools](/research-tools/projectariatools/start):** Python libraries and utilities for working with Aria data
+- **[Project Aria Tools](/research-tools/projectariatools/installation):** Python libraries and utilities for working with Aria data
 
 ---