跳到目录

地形：R和Unity中的景观可视化

概述

terrainr使得从API国家地图系列，然后将该数据处理为较大的连接图像，或将其裁剪为可导入Unity 3D渲染引擎的平铺。

terrainr提供三种主要公用设施。首先，用户可以通过获取文件（_T）函数，下载由平方英尺或光栅对象：

图书馆(地形)
图书馆(平方英尺)

感兴趣的位置 <- 三羟甲基苯酚::地理代码_ OSM(“Hyampom California”)$坐标

感兴趣的位置 <- 数据帧(
x个= 感兴趣的位置[[“x”]],
年= 感兴趣的位置[[“y”]]
)

感兴趣的位置 <- st_as_sf(
  感兴趣的位置,
坐标= c（c）(“x”,“y”),
阴极射线管= 4326
)

感兴趣的位置 <- 设置框边长(感兴趣的位置,8000)

输出_文件 <- 获取文件（_T）(感兴趣的位置,
服务= c（c）(“标高”,“正交”),
分辨率= 30 #像素边长（米）
                          )

下载后，这些图像为标准GeoTIFF或PNG格式，可以按预期与其他实用程序一起使用：

光栅::情节(光栅::光栅(输出_文件[[“标高”]][[1]]))

光栅::打印RGB(光栅::砖(输出_文件[[“正交”]][[1]])，刻度= 1)

最后，terrainr帮助您可视化这些数据，它们都是通过新的地理空间地理位置：

图书馆(ggplot2)
ggplot图() + 
  地理空间(数据= 输出_文件[[“正交”]],
                   原子发射光谱(x个= x个，年= 年，第个= 红色，克= 绿色，b= 蓝色)) + 
  坐标_sf(阴极射线管= 4326) + 
  主题_void()

以及Unity 3D渲染引擎，允许您在3D和VR中飞行或浏览下载的数据集：

正在进行（_P）( #不指定分辨率时，默认值为1m像素
  输出_文件 <- 获取文件（_T）(感兴趣的位置,
服务= c（c）(“标高”,“正交”))
)

合并dem <- 合并星形（_R）(输出_文件[[“标高”]],
                            临时文件(文件文本= “.tif”))
合并正交 <- 合并星形（_R）(输出瓷砖[[“正交”]],
                              临时文件(文件文本= “.tif”))

make_manifest品牌(输出_文件$高程,
              输出_文件$正交的)

然后，我们可以将这些瓷砖导入Unity（按照导入渐晕)创建：

可以通过进步者软件包，这样你会更有信心你的电脑仍在运转，而不仅仅是死机。有关更多信息，请查看介绍性小插曲和将数据导入Unity的指南！

引用地形

美国地质调查局提供了引用美国地质勘探局数据产品的指南（下载自获取文件（_T）)在https://www.usgs.gov/faqs/how-should-i-cite-datasets-and-services-national-map.

要在出版物中引用地形，请使用：

Mahoney，M.J.、Beier，C.M.和Ackerman，A.C.（2022）。terrainr：用于创建沉浸式虚拟环境的R包。开源软件杂志，7（69），4060，https://doi.org/10.21105/joss.04060

LaTeX用户的BibTeX条目是：

  @第条{,
    年= {2022},
    出版商={开放期刊}，
    体积= {7},
    数= {69},
    页= {4060},
    作者={迈克尔·马奥尼（Michael J.Mahoney）、科林·拜尔（Colin M.Beier）和艾丹·阿克曼（Aidan C.Ackerman）}，
    标题={{terrainr}:R包，用于创建沉浸式虚拟环境}，
    杂志={开源软件杂志}，
    国防部={10.21105/joss.04060}，
    网址= {https://doi.org/10.21105/joss.04060},
}

可用数据集

当前可以使用下载以下数据集获取文件（_T）或命中_国家_ map_api:

  • 3DEP立面图：美国地质勘探局3D高程项目（3DEP）裸地球DEM。
  • USGSNAIPPlus公司：国家农业图像计划（NAIP）和高分辨率正射影像（HRO）。
  • 非霍奇金淋巴瘤：一组全面的数字空间数据，对自然发生和建造的地表水体（湖泊、池塘和水库）、水流路径（运河、沟渠、溪流和河流）以及相关实体（如点特征）（泉水、水井、流量计和水坝）的信息进行编码。
  • 政府单位：国家的主要民事区域，包括州或地区、县（或同等地区）、联邦和美洲原住民地区、国会选区、次要民事区划、合并地（如城镇）和非合并地。
  • 等高线：美国地质勘探局高程等高线服务。
  • 地名：关于物理和文化地理特征、地理区域和通常可通过名称识别和定位的位置实体的信息。
  • NHD冲洗_HR：一套全面的数字空间数据，包括全国无缝的河段网络、基于高程的集水区、流面和增值属性。
  • 结构：选定的人造设施的名称、功能、位置和其他核心信息和特征。
  • 运输：道路、铁路、小径、机场和其他与人员运输或商业相关的特征。
  • 工作分解结构：美国、波多黎各和美属维尔京群岛的水文单位（HU）多边形边界。

（以上所有描述均摘自国家地图API描述.)

请注意，有时这些资源会脱机，原因与此包中的任何内容无关。您可以查看这些资源的当前状态在此链接.

安装

您可以通过以下方式从CRAN安装地形：

安装.包(“地形”)

或者，如果您想要最新的补丁和功能，您可以从以下位置安装terrainr的开发版本github具有：

#install.packages（“devtools”）
开发工具::安装_工具(“ropensci/terrainr”)

请注意，开发版本不稳定，尚未在CRAN上发布的功能可能随时更改！

行为准则

请注意，此软件包随贡献者行为准则。通过参与此项目，您同意遵守其条款。