# SIF加地物光谱仪本地数据存储格式说明

注意：本文仅对存储内容进行说明 文件名称及存储路径策略另行讨论 

本次存储的文件以CSV格式存储 逗号分隔值（Comma-Separated Values，CSV，有时也称为字符分隔值，因为分隔字符也可以不是逗号），其文件以纯文本形式存储表格数据（数字和文本）。纯文本意味着该文件是一个字符序列，不含必须像二进制数字那样被解读的数据。CSV文件由任意数目的记录组成，记录间以某种换行符分隔；每条记录由字段组成，字段间的分隔符是其它字符或字符串，最常见的是逗号或制表符。通常，所有记录都有完全相同的字段序列。通常都是纯文本文件。

数据分为数据区域与数据描述区 

# 一 数据描述区

即元数据 元数据（Metadata），又称中介数据、中继数据，为描述数据的数据（data about data），主要是描述数据属性。本设备元数据主要包含以下六部分内容

**红色为配置文件给出 蓝色存疑**

## 1.1、环境信息

包括自然环境与人工环境

### 自然环境信息

**时间信息**：主要记录数据开始采集时间，时间信息统一采用UTC时间 格林威治时间。世界统一时间、世界标准时间、国际协调时间、世界协调时间，UTC协调世界时即格林威治平太阳时间，是指格林威治所在地的标准时间，也是表示地球自转速率的一种形式，UTC基于国际原子时间，通过不规则的加入闰秒来抵消地球自转变慢的影响，是世界上调节时钟和时间的主要时间标准。其中年月日中间以下划线“_”(英文输入法 ASCII 95)分割。其中年用4位数表示，月和日均两位，如下所示

​                        XXXX_XX_XX

时间采取24小时制，时间中间以冒号“：”分割，均以两位填充，不足两位补零格式如下

​                        XX:XX:XX

年与时间中间以空格分开最终格式如下所示

​                        XXXX_XX_XX XX:XX:XX

**<font color='red'>地点：</font>**设备所处的行政范围 具体到乡。一个设备应该对应唯一地点，一个地点可以对应多个设备

名称中不应出现中文、“*”、“，“、”/“、”#“等特殊符号，每一级首字母应该大写 其他字母采用小写。级与级之间应该以下划线为分割 如下 XXXX省XXXXXX市XXXXX县XXXXX乡如果有缺级，则直接省略

**温度**：设备采集时的机箱温度，采用摄氏度。小数点保存两位

**湿度：**设备采集时的机箱湿度。 两位有效数字

**<font color='red'>GPS_longtitude</font>**：数据所在位置的GPS坐标的经度值，GPS采用WGS84坐标 小数点个数后8位。

**<font color='red'>GPS_Latitude</font>:** 数据所在位置的GPS坐标的纬度值，GPS采用WGS84坐标，数据保留小数点后8位

**<font color='red'>GPS_半球</font>**：设备所在地球半球位置 其中N表示北半球 S表示南半球

**<font color='red'>GPS_高程</font>**：设备的海拔高度 属于相对搞成

**<font color='red'>高程坐标系统</font>：**高程的系统。

**<font color='cornflowerblue'>降雨：</font>**设备采集数据时是否有下雨发生

**<font color='cornflowerblue'>风速</font>**：设备采集时的风速

*注意：上述顺序不代表数据存储数据，数据以键 值进行存储，在读取时应进行键值判断。*

### 人工环境

**数据存储名称**：设备采集时存储文件的名称 防止用户后期修改文件名时无法找到对应的文件名称

**<font color='red'>设备安装时间</font>：**设备安装日期 格式与时间信息一致

**<font color='red'>ISIF定标时间</font>：**设备1定标时间 格式与时间信息一致

**<font color='red'>设备2定标时间</font>：**设备2定标时间 格式与时间信息一致

**<font color='red'>设备维护人员姓名</font>**：设备维护人员名称

**<font color='red'>设维护人员电话</font>**：设备维护人员电话

**<font color='red'>远程资源用户id</font>**：公司会将设备必要的文件存储至云上，届时用户可以通过网络对数据进行下载

**<font color='red'>定标文件下载路径</font>**：云服务的路径

*注意：上述顺序不代表数据存储数据，数据以键 值进行存储，在读取时应进行键值判断。*

## 1.2、ISIF设备信息

**设备序列号：**ISIF出厂序列号 由设备厂商出具

**产品序列号：**由IRIS确定的序列号，格式为型号-序列号 如ISIF-101

**向上光纤U1曝光时间（shutter1）**单位毫秒 整型

**向下光纤D1曝光时间（shutter2）：**单位毫秒 整型

**向下光纤D2曝光时间（shutter3）：**单位毫秒 整型

**向下光纤D3曝光时间（shutter4）：**单位毫秒 整型

**波段数量：**设备波段个数

**向上定标文件名**：向上光纤ISIF设备的定标文件名称

**向下定标文件名1**：向下光纤1 加ISIF设备定标文件名称

**向下定标文件名2：**向下光纤2 加ISIF设备定标文件名称

**向下定标文件名3：**向下光纤3 加ISIF设备定标文件名称

**向上测量时TEC温度：**单位摄氏度 保留一位小数

**向下测量1时TEC温度：**单位摄氏度 保留一位小数

**向下测量2时TEC温度：**单位摄氏度 保留一位小数

**向下测量3时TEC温度：**单位摄氏度 保留一位小数

**....** :  ....

## 1.3、ISIF波长数据

**ISIF设备的波长文件：**波长数据，采用两位有效数字

## 1.4、IS1设备信息

**IS1设备序列号：**光谱设备出厂序列号 由设备厂商出具

**IS1产品序列号：**由IRIS确定的序列号，格式为型号-序列号

**向上光纤U1曝光时间（shutter1）：**单位毫秒 整型

**向下光纤D1曝光时间（shutter2）：**单位毫秒 整型

**向下光纤D2曝光时间（shutter3）：**单位毫秒 整型

**向下光纤D3曝光时间（shutter4）：**单位毫秒 整型

**波段数量：**设备波段个数

**向上定标文件名**：向上光纤ISIF设备的定标文件名称

**向下定标文件名1**：向下光纤1 加ISIF设备定标文件名称

**向下定标文件名2：**向下光纤2 加ISIF设备定标文件名称

**向下定标文件名3：**向下光纤3 加ISIF设备定标文件名称

**向上测量时TEC温度：**单位摄氏度 保留一位小数

**向下测量1时TEC温度：**单位摄氏度 保留一位小数

**向下测量2时TEC温度：**单位摄氏度 保留一位小数

**向下测量3时TEC温度：**单位摄氏度 保留一位小数

**....** :  ....

## 1.5、IS1波长数据

**光谱设备的波长文件** ：波长数据，采用两位有效数字

# 二 数据区

<font color='red'>规则：</font>

1. 光纤明明为P1，P2,P3,P4
2. <font color='red'>数据存储按行来 一行数据存储</font> 
3. <font color='red'>单行数据中第一列为数据名称 名称按第一条规则定义</font>
4. <font color='red'>第二列数据为数据状态表示 valid有效 invalid表示无效</font>
5. <font color='red'>单行数据中从第三列开始为数据 数据采用整形存储</font>

## 三 数据展示

```csv
TotalSpectrometer,2
environmental factor,Date,XXXX_XX_XX XX:XX:XX,Location,Beijing_Haidian
Device1_Info,Modle,ISIF,SN,10085,......
wavelenth,300.00,301.00,.........
Device2_Info,Modle,IS1,SN,10085,......
wavelenth,300.00,301.00,.........
Data_Start
Device1_P1,valid,shuttertime,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data
Device1_P2,valid,shuttertime,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data
Device1_P3,valid,shuttertime,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data
Device1_P4,valid,shuttertime,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data
Device2_P1,valid,shuttertime,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data
Device2_P2,valid,shuttertime,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data
Device2_P3,valid,shuttertime,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data
Device2_P4,valid,shuttertime,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data,data
```
