Mars Dust Activity Database

Version 1.1 of the Mars Dust Activity Database (MDAD, v1.1) includes storm boundaries for every instance from the Mars Color Imager (MARCI) era of Version 1.0 of the MDAD (Mars Years 28–32). The dataset is organized into five tar files, one for each Mars year. Two formats are provided in every tar file and provide equivalent data. A netcdf file (*.nc) contains a mask of the dust events on each sol of the Mars Year (soy) in an array called "MDAD," along with a string vector of the name of the sol from the Mars Daily Global Map (MDGM) database in a variable called "dayList," and an array of values in a variable called "timeList" of the time of the sol containing: start soy, end soy, mean soy, median soy, start areocentric longitude (Ls), end Ls, mean Ls, median Ls. The MDAD mask has dimensions time x longitude (3600 points) x latitude (1801 points). The length of the time dimension varies across years: MY 28 (340), MY 29 (551), MY 30 (616), MY 31 (623), MY 32 (358). The dayList and timeList variables have the same time dimension length as the MDAD masks. The mask variable is in uint8 (unsigned byte) format and may be converted directly to unsigned int upon reading. Values of (255) indicate missing pixels of the MDGM. A value of (0) indicates no dust instances. Values ranging 1–133 are the number portion of the member ID to connect the mask back to MDAD v1.0. Values ranging 134–250 are splitting members with the member ID of (mask value - 133)b. Each Mars-year bundle also contains a folder of *.csv files, each of which corresponds to a single dust storm instance on a single sol. The csv files are named with the following convention: SUB_dayXX_MEM_ZZZb.csv, where “SUB” is the MARCI mission subphase and XX is the sol number ranging 01–34. The last seven characters are the member ID for the storm from MDAD v1.0, with ZZZ ranging 001–133 and "MEM" the subphase on which the member starts. For storms that have merged, only the member ID with the smallest ZZZ is included in the file name, and the character "b" is only included in the file name for splitting storms. Each *.csv file consists of a two column matrix. Column 1 is east longitude, and column 2 is latitude. Each longitude, latitude point is a pixel on the boundary of the storm instance. The boundaries have a resolution of 1/10°, so each row of the matrix maps to a unique pixel of a MDGM. The total set of longitude, latitude points is the outline of the dust instance, which traces the outside of the storm masks provided in the *.nc files. An additional comma separated value file with the name SUB.list provides a copy of the "timeList" array included in the *.nc files. For each subphase of MDGMs, there is a single *.list, and each row is a single day with the following information in csv format: subphase_day, start MY, end MY, start sol-of-year (soy), end soy, mean soy, median soy, start areocentric longitude (Ls), end Ls, mean Ls, median Ls. Additionally, a folder entitled "list" contains an additional *.list comma separated value file for each day of the subphase, where each row describes a single swath in that sol's MDGM. It has the following format: Swath name, Earth time collected, MY, Mars month, soy, Ls, center west longitude.

火星尘埃活动数据库（Mars Dust Activity Database, MDAD）v1.1版本，收录了MDAD v1.0（对应火星年28至32）的火星彩色成像仪（Mars Color Imager, MARCI）时代所有尘埃事件的风暴边界。本数据集分为5个tar压缩包，每个对应一个火星年。每个tar包内均提供两种等价的数据格式。

netCDF文件（后缀为*.nc）包含以数组"MDAD"存储的、对应各火星年每个火星日（sol of the Mars Year，缩写soy）的尘埃事件掩膜；同时附带名为"dayList"的字符串向量变量，存储来自火星每日全球地图（Mars Daily Global Map, MDGM）数据库的火星日名称；另有名为"timeList"的数值数组变量，存储该火星日的相关时间参数，包括：起始火星年当日（soy）、终止火星年当日、平均火星年当日、中位火星年当日，以及起始日心经度（areocentric longitude，简称Ls）、终止日心经度、平均日心经度、中位日心经度。

MDAD掩膜的维度为时间×经度（3600个点）×纬度（1801个点）。各火星年的时间维度长度各不相同：火星年28为340，火星年29为551，火星年30为616，火星年31为623，火星年32为358。"dayList"与"timeList"变量的时间维度长度与MDAD掩膜一致。

该掩膜变量采用无符号字节（uint8）格式，读取后可直接转换为无符号整数。其中，值255代表MDGM的缺失像素，值0代表无尘埃事件，值1~133为成员ID的数值部分，用于将掩膜关联回MDAD v1.0；值134~250则为拆分事件，其成员ID为（掩膜值 - 133）b。

每个火星年的数据包还附带一个*.csv文件文件夹，每个文件对应单个火星日上的单个尘埃风暴事件。csv文件的命名规则为："SUB_dayXX_MEM_ZZZb.csv"，其中"SUB"为MARCI任务子阶段，"XX"为火星日编号（范围01~34），最后7位字符为MDAD v1.0中该风暴的成员ID（ZZZ范围001~133），"MEM"为该成员起始的子阶段。对于合并的风暴，文件名仅包含编号最小的ZZZ对应的成员ID；仅拆分风暴的文件名中会包含字符"b"。

每个*.csv文件为两列矩阵，第一列为东经经度，第二列为纬度。每个经纬度点均为该风暴事件边界上的像素，边界分辨率为1/10°，因此矩阵的每一行均对应MDGM的唯一像素。所有经纬度点共同构成该尘埃事件的轮廓，与*.nc文件中提供的风暴掩膜外边界一致。

另有一个名为SUB.list的逗号分隔值文件，复刻了*.nc文件中的"timeList"数组。针对MDGM的每个子阶段，均对应一个*.list文件，每行以csv格式存储单日信息，包括：子阶段日期、起始火星年、终止火星年、起始火星年当日（soy）、终止火星年当日、平均火星年当日、中位火星年当日、起始日心经度（Ls）、终止日心经度、平均日心经度、中位日心经度。

此外，一个名为"list"的文件夹中，包含对应子阶段每个火星日的额外*.list逗号分隔值文件，每行描述该火星日MDGM中的单个条带，格式为：条带名称、采集的地球时间、火星年、火星月份、火星年当日（soy）、日心经度（Ls）、中心西经。