> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapxagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 空间分析

> MapX 的分析是一批确定性的空间算子：距离、叠加、网络、地形、栅格与统计。可以在对话里让 AI 调用，也可以直接在「分析」目录里选工具发起。

MapX 的分析是一批**确定性的空间算子**，在你的项目数据上由服务端执行 —— 就是你过去要用 PostGIS、pgRouting、GDAL、QGIS 或 Python 脚本做的事情。在对话里，AI 负责挑算子、填参数；但真正跑的是一个固定算子，所以结果可复现、可追溯。

<img src="https://mintcdn.com/mapx/Gm8Sq4rHk_eRSOvo/images/concepts/analysis-catalog.png?fit=max&auto=format&n=Gm8Sq4rHk_eRSOvo&q=85&s=466eb5915d333fe626590770857afc25" alt="工作区里的「分析」目录：左侧是按族分组的算子，右侧是算子的输入与参数" width="1440" height="900" data-path="images/concepts/analysis-catalog.png" />

## 分析的入口

分析有两个界面，它们不是一回事：

| 位置 | 是什么 | 什么时候用 |
| - | - | - |
| 顶部菜单 → **分析** | 算子目录：分组、搜索、参数，以及「开始」按钮 | 你明确知道要跑哪个算子，想自己控制输入与参数 |
| 右侧栏 → **分析** | 当前项目的分析记录（任务台账） | 看状态、耗时、结果、统计量，以及失败原因 |

<img src="https://mintcdn.com/mapx/Gm8Sq4rHk_eRSOvo/images/concepts/analysis-runs.png?fit=max&auto=format&n=Gm8Sq4rHk_eRSOvo&q=85&s=5a0e56ad61e92eb86b97f436ac840e02" alt="「分析」面板里的运行记录：状态、耗时与结果" width="1440" height="900" data-path="images/concepts/analysis-runs.png" />

## 算子族

目录里有 70 多个算子，分成 12 个族。下表的条数是当前默认值；准确清单以目录里搜到的为准。

| 族 | 覆盖什么 | 算子数 |
| - | - | - |
| 距离与成本 | 欧氏距离、成本距离、最小成本路径 | 3 |
| 水文分析 | 填洼、流向、累积流、流域、河网提取 | 5 |
| 网络分析 | 服务区、最近设施、OD 成本矩阵、最短路径、选址分配 | 7 |
| 叠加分析 | 裁剪、擦除、相交、联合、合并与汇总，以及加权叠加与面转点 | 15 |
| 模糊叠加 | 隶属度函数与模糊综合（AND / OR / PRODUCT / SUM / GAMMA） | 2 |
| 栅格处理 | 栅格计算、裁剪、重投影与重采样、两期变化矩阵 | 6 |
| 邻域与距离 | 缓冲、最近距离、距离分档、服务环 | 4 |
| 空间统计 | 网格、四象限、热点、重心与标准差椭圆、扩张强度、OLS / GWR | 10 |
| 分区统计 | 按分区面汇总栅格/矢量/分类栅格（含分区 × 类别交叉表） | 3 |
| 地形与表面 | 坡度、坡向、曲率、起伏、地形位置、山体阴影、等高线、视域、重分类 | 13 |
| 插值分析 | IDW、克里金、TIN | 3 |
| 地形指数 | 地形湿度、河流功率、泥沙输移指数 | 3 |

## 发起一次分析

<Steps>
  <Step title="打开目录">
    按 <kbd>⌘</kbd>+<kbd>K</kbd>，或打开顶部菜单选 **分析**。可以按族筛选，也可以直接搜关键词，例如「缓冲」「服务区」「坡度」。
  </Step>

  <Step title="看清算子说明">
    选中一个算子会显示它回答什么问题、需要什么输入、有哪些参数。输入是**带类型**的：需要分区面的算子不会接受点图层，选择器只列出符合条件的图层。
  </Step>

  <Step title="选择数据">
    指定算子要跑在哪一层或哪几层上。多数算子只要一个输入；叠加与网络类要两个以上（例如「起点图层」和「终点图层」）。
  </Step>

  <Step title="设置参数">
    参数同样带类型：距离按米、分类数、字段名、阈值。字段候选来自你选中图层里真实存在的列。
  </Step>

  <Step title="开始">
    点「开始」。运行会先排队再执行，期间你可以继续在项目里做别的事。
  </Step>
</Steps>

## 读结果

每次运行都会产出一个结果图层，部分算子还会产出表格或图表：

* **结果图层** —— 出现在图层列表和地图上，带算子声明的默认图例。要改样式就打开「图层」面板，和其它图层一样编辑。
* **统计结果** —— 数量、面积、均值、覆盖率这类数值挂在这次运行上，不只在图上。
* **数据表** —— 表格型产物可以在数据表面板里打开并导出。

## 状态与失败

运行的状态很简单：**排队 → 运行中 → 已完成**，另外有 **失败** 与 **已取消** 两个终态。台账里能看到每次运行的耗时，并按项目保留历史。

运行失败时，MapX 会用平实的语言说明原因并给出下一步建议 —— 例如输入超过了规模或内存预算、字段不存在、地形分析需要的数据还没补。常见处理：

* **输入太大** —— 先裁剪范围，或只在一块子区域上跑。
* **几何类型不对** —— 到「图层」面板确认图层类型；有些算子需要面，而你手上是点（或反过来）。
* **数据缺失或无效** —— 栅格算子需要有效的坐标系与真实像元值；水文分析需要先填洼。

重试失败的任务会保留原有的输入与参数，你只需要改导致失败的那一项。删除一条任务记录只移除记录与执行明细，**不会**删掉它产出的图层、图表与报告。

<Note>
  跑算子不调用 AI 模型，因此计算本身不消耗 AI 积分 —— 消耗积分的是把它组织起来的那轮对话。计费口径见[积分](/zh/account/credits)。
</Note>

## 用对话还是用目录

**探索**时用对话：你说清问题，AI 负责把算子串起来，你用追问逐步精修。**已经知道要跑什么**、或者要精确控制输入与参数时，用目录直接发起。

两条路写的是同一份任务台账，所以 AI 发起的运行和手动发起的运行能在同一个地方审计。

## 相关

* [AI 对话](/zh/concepts/ai-chat) —— AI 怎么挑算子、怎么串联
* [内置数据](/zh/concepts/builtin-datasets) —— 分析现成的输入数据
* [场景](/zh/concepts/scenarios) —— 带研究区与建议提问的成套起点
* [工作流与计划](/zh/concepts/workflows) —— 把多步分析固化成可复用工作流
* [图层](/zh/concepts/layers) —— 结果图层的样式与管理


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.