MMGIS开源项目安装与配置指南

1. 项目基础介绍

MMGIS（Multi-Mission Geographic Information System）是一个面向行星任务的空间数据基础设施，提供基于Web的地图界面和多种地理信息处理工具。该项目主要用于行星科学操作，支持2D地图和3D地球视图，以及图像查看器、自定义图层、用户绘图等多种功能。

主要编程语言：JavaScript（前端），Python（后端）。

2. 项目使用的关键技术和框架

• 前端：使用React进行界面构建，以实现交互式的Web地图应用。
• 后端：采用Python的Flask框架，处理HTTP请求并与数据库交互。
• 数据库：使用PostgreSQL数据库，配合PostGIS扩展，以存储空间数据。
• 其他技术：项目还使用了TiTiler和STAC（Spacetime Asset Catalog）等开源库来处理和展示地理图像数据。

3. 项目安装和配置的准备工作与详细步骤

准备工作

• 确保系统中已安装以下软件：
  • Node.js（版本v20.11.1或更高）
  • PostgreSQL（版本v16或更高）
  • PostGIS（版本3或更高）
  • micromamba（版本2或更高）
• 准备好用于项目运行的数据库信息（用户名、密码、数据库名）。

安装步骤

使用Docker安装

1. 克隆项目仓库到本地：

   git clone https://github.com/NASA-AMMOS/MMGIS.git
   

2. 复制sample.env文件到.env，并根据实际情况修改数据库配置信息：

   cp sample.env .env
   

   修改.env中的以下变量：

   DB_NAME=<name>
   DB_USER=<user>
   DB_PASS=<password>
   

3. 创建Missions目录，并将其映射到容器内部：

   mkdir Missions
   cp -r ./Missions ./Missions
   

4. 使用docker-compose运行容器：

   docker-compose up -d
   

5. 首次UI设置：

   • 打开浏览器，访问http://localhost:8888/configure。
   • 注册管理员账户。
   • 创建新任务，可以使用“Test”作为示例任务名称。

不使用Docker安装

1. 安装Node.js（v20.11.1或更高）和PostgreSQL（v16或更高）以及PostGIS（版本3或更高）。

2. 克隆项目仓库到本地：

   git clone https://github.com/NASA-AMMOS/MMGIS.git
   

3. 设置PostgreSQL数据库。

4. 初始化micromamba环境：

   micromamba create -n mmgis python=3.8
   conda activate mmgis
   

5. 安装项目所需的Python依赖：

   pip install -r python-requirements.txt
   

6. 安装前端依赖并构建：

   npm install
   npm run build
   

7. 运行后端服务：

   flask run
   

完成以上步骤后，MMGIS项目应该就可以正常运行了。