地面气象月报表数据文件查询软件2.0版使用说明

PAGEPAGE5地面气象月报表数据文件查询软件使用说明国家气象信息中心气象资料室软件编写：周学东（江苏省气候中心）目录一、软件简介二、软件的安装、升级、卸载三、使用前的准备工作四、启动软件五、基本参数确定六、软件界面及主要功能七、查询数据八、保存和恢复工作状态九、保存结果十、复制结果到其它软件十一、打印结果十二、对齐方式十三、自定义软件功能十四、动态连接库函数返回值特定值简要列表十五、动态连接库函数返回值主要项目单位（量纲）简要列表软件简介本软件使用模式数据文件访问接口动态连接库YearStat.DLL开发设计，可以提供各种常用的年、月、旬、候、日、时气象观测和统计加工数据的多站、多要素访问，管理项目可在动态连接库支持的项目中自由增加或删减而无需修改软件。软件同时支持结果直接输出到文件功能，以更好地支持大数据量的查询输出，方便建立数据集文件。软件直接使用各个时期的各种地面信息化模式文件作为数据源，并自动按照2003版A文件、2000版A文件、A1文件（A2文件）、A0文件的优先顺序寻找相应的资料文件，具有自动合并2000版A文件及之前的A1、A2、A0文件与相应A6、A7文件数据的功能，软件虽然同时也能合并V文件数据，但本软件不使用V文件中的数据。自动适应不同模式文件的差异，具有一定的模式文件格式容错能力，不再需要准备单一格式模式文件，不需要进行多模式之间的转换，不需要进行模式文件的标准处理（软件已内含），使用和维护简单。软件具有工作状态记忆能力，可以满足不同用户同时工作需求，保存并恢复各种定制任务的工作状态，记录特定查询任务的设置参数，便于重新计算或调整任务。软件最多支持对2000个台站的管理，提供站号排序、站名排序、直接查找定位，可以按单独选择、地区选择、按资料情况选择，管理方便。软件同时提供资料存在情况的简单管理功能，在台站清单中就可以直接看到资料的起止年代，还可以进一步查看每个站的详细资料年月情况。软件的安装、升级、卸载本软件为免安装软件，请直接将相关的文件复制到本地。如果希望在局域网上共享使用，也可以直接复制到共享目录，但共享权限会限制用户修改其中的工作参数，并限制在该目录中保存工作状态（但可以保存到其它位置）。软件的执行程序SMSD.EXE即为启动程序，必要时，请自行创建相应的快捷方式到桌面或程序组。软件的升级，由于软件的数据管理和统计功能全部被封装在动态连接库YearStat.DLL文件中，升级时通常只要更新支持新模式和新统计方法及项目的该动态连接库文件即可。由于动态连接库文件只有当没有任何程序调用该文件时才能更改，所以需要升级时请停止包括SMSD.EXE在内的所有使用该动态连接库文件的应用程序。卸载软件时，只要删除相应的目录即可，软件不生成任何附加的文件，也不使用任何系统目录和临时目录。安装目录中的文件清单：SMSD.EXE主程序YearStat.DLL动态连接库文件SMSD.TXT项目支持表文件Station.TXT或StatName.txt站表文件HANDSHAK.JPG欢迎屏幕底图（可以自由替换）Def_Path.TXT模式文件所在路径参数文件（可由主程序创建和更新）地面气象月报表数据文件查询软件2.0版使用说明.htm本文件YearStat.DOC动态连接库（年项目）使用说明（含年项目表）ReadA.DOC动态连接库（月项目）使用说明（含月以下项目表）使用前的准备工作为了使用本软件，在使用前必须根据本地情况修改本地站表文件。该站表文件保存在执行程序所在的目录下，文件名为Station.TXT或StatName.TXT（前者优先），其中后者可以直接从整编软件的“结果\WorkBook\”目录下复制过来（其中第一行的说明部分——以“区”开头会被自动跳过）。站表文件格式为文本文件，每一行定义一个站，为用逗号分开的4个参数（超过4个参数时抛弃多余的参数），依次为区站号、可替代站的区站号、所在地区名、站名。地区名可以是省名，也可以是地级地区名。如果指定可替代站，则当指定的站模式文件不存在时，会自动使用替代站的模式文件进行资料替代。其中区站号支持加密站的字母区号（2位，建议使用大写字母），加密站字母区站号的内部数值型表示为AABBiii,AA和BB分别为区号第一和第二个字母的ASCII码，iii为站号。非加密站区站号的数值型表示不变。由于计算年、月等气温、降水距平（百分率）需要基本的常年平均值，模式数据文件中并没有准备好这部分数据。如果需要此项目，必须事先准备好累年值文件，建议此文件保存在程序所在的目录中，文件名任意，使用时输入软件界面，否则相关项目结果将是缺测。累年文件（文本文件）由一系列数值型字串组成，之间用空格或回车换行分隔，为方便编辑和查看，可以按个人习惯规定回车的位置。一个站的各累年平均值加上对应的区站号共99个数据，依此为区站号，气温的年平均值，12个月的平均值和36个旬的平均值，降水量的平均值(相同顺序)，单位为0.1度和0.1毫米，除了年降水量平均值用-32766表示缺测外，其它缺测用32766表示。各个站的平均值序列不分先后的依此保存。对于加密自动站前二位使用字母表示时，区站号格式为AABBiii，其中AA和BB=48-57表示0-9字符，65-90表示A-Z字符（即字符的ASCII码），AA和BB分别对应第一个和第二字符。启动软件直接执行SMSD.EXE启动软件，首先将进入获取数据的参数输入窗口：≥的不确定值，用95X表示等。本说明的最后有简要的列表，但详细情况请查阅YearStat.DOC（年项目、跨月统计的月项目、距平及百分率月项目）、ReadA.DOC（月以下项目）文档中的说明。6、选择统计方法规范：整编规范依据的是1961-1990年气候资料整编统计方法，气表规范依据的是地面观测规范，两者之间的主要差别有两条，其一是雷暴初终日统计，整编规范要求当雷暴初终日出现在1-2月时，进行跨年订正，即在冬季挑选最长无雷暴期，按照最长无雷暴期重新确定初终日，因此可能会跨年，但气表规范只在当年内挑选，不允许跨年；其二是海平面气压的计算公式上，整编规范中只使用当时的气温，而气表规范使用当时气温和12小时前气温的平均值进行海平面气压的计算。7、如果选择“直接保存到”文件功能，请输入保存的文件名（可含路径），可以用#####表示实际的区站号，%%%%表示实际的年份，根据需要选择字段的分割符号（Tab、逗号或空格），如果再选择“附加台站参数”，则输出时会在区站号后面补上纬度、经度和海拔高度。该功能主要用于数据集制作，允许大数据量的生成，但因此也就不再允许使用窗口查看检索结果。8、必要时使用“更多设置”可进一步确认模式文件的路径和容错设置。9、点击“获取”按钮开始获取资料并自动进入结果查阅窗口，否则点击“取消”按钮回到结果查阅窗口（当已经存在结果时）。10、因为逐时日照时数按地方时记录，通常情况下，请不要和其它定时项目混合查询。否则，一定要注意输出结果中的时次和日期对于逐时日照时数而言是以0时为日界限的，因此当日21-23时的记录会出现在当日记录的前面，而同时次的其它定时记录实际上表示的是日历日期的昨天。保存和恢复工作状态可能上面所进行的数据获取的参数定义是比较复杂和耗时的，为了便于对工作要求进行管理，在设置好上述参数后，使用“保存状态”按钮可以将除了基本设置参数外的全部参数保存到指定的文件中去（扩展名自动为.par），然后在需要时使用“重读状态”按钮从指定文件中取回参数设置。保存结果对于所获得的查询结果，使用主菜单“保存结果到文件”可以以文本文件的方式保存表中的结果（含表头），保存的字段格式取决于当前结果是左对齐的还是右对齐的。左对齐时，字段之间以逗号分割（没有多余的空格），右对齐时是以定长方式保存（填充空格）。复制结果到其它软件对于所获得的查询结果，使用主菜单“复制结果到剪贴板”可以以文本的方式保存表中的结果（含表头）到剪贴板，保存的字段格式取决于当前结果是左对齐的还是右对齐的。左对齐时，字段之间以逗号分割（没有多余的空格），右对齐时是以定长方式保存（填充空格）。如果只想复制部分数据到剪贴板，请首先选择相应的内容（不支持表头），然后用鼠标右键选择“复制选择的数据到剪贴板”。注意拉动选择区时，最先选择的表格栏不是蓝色的，但有虚线框存在（说明是当前栏目），其栏目是包括在选择区内的。打印结果对于所获得的查询结果，使用主菜单“打印结果”可以以文本的方式打印表中的结果（含表头），打印总是定长方式的，但会保留左对齐或右对齐方式。当表格超宽、超长时，打印会自动分页。对齐方式使用主菜单的“左对齐排列”使得表格内容（不含标题行）左对齐，“右对齐排列”则为右对齐。对齐方式直接影响结果保存、复制、打印的格式。自定义软件功能软件自定义功能主要在可支持的输出项目上，目前默认的支持项目只是YearStat.DLL动态连接库支持项目中的常用项目，还有非常多的统计值没有加入可选项目中（主要是为了使用中较清晰、减少项目列表长度）。如果发现目前的可选项目不能满足需求，只要通过修改SMSD.TXT文件就可以轻松定制可选项目列表。SMSD.TXT文件格式说明：（文本文件）该文件的内容每一行定义一个可选项目，内容包括项目所属的要素、项目的输出标题（不可重复）、项目对应动态连接库访问函数中的valuename名、需要的para参数、单位说明、是否是需要次年资料全部处理后再重新计算的项目（去年值）。所有项目分为年值类、月值类、旬值类、候值类、日值类、时值类，分别将相应的定义行放在[Year]、[Month]、[Decads]、[FiveDays]、[Day]、[Time]分类名后，注意顺序以方便找寻原则排列。其中所属的要素为数字0-22，依次对应参数部分(0)、方式位(1)、气压(2)、气温(3)、湿球温度(4)、水汽压(5)、相对湿度(6)、云量(7)、云高(8)、云状(9)、能见度(10)、降水(11)、天气现象(12)、蒸发量(13)、积雪(14)、电线结冰(15)、风(16)、浅层地温(17)、较深层地温(18)、冻土(19)、日照(20)、草面温度(21)、露点温度(22)。要素分类后为空格。项目输出标题为显示打印的项目标题，请尽量短些，但不要重复（软件限制重复标题的项目被选择）。后面应为空格。valuename名请参阅YearStat.DOC（年项目）和ReadA.DOC（月以下项目）。如果后面还有内容，要求后随空格。para参数请按照valuename名的要求列出，但“Month=mm”、“Decad=dd”、“Five=ff”、“Date=dd”、“Time=tt”、“S_Hour=hh”因已经被列入循环变量自动设置，除非必要，否则请不要设置。另外，para参数还承担动态连接库需要的参数外的另外两个附加参数需要，一是如果出现“/Last”表示该项目是一个去年值项目，二是如果出现“/$单位1,单位2$/”则表示该项目使用格式化输出时的单位为“单位1”、使用函数原始值输出时的单位为“单位2”，如果两个单位相同，则可以简化为“/$单位$/”。动态连接库函数返回值特定值简要列表（详见连接库的说明文档）整型数缺测：32766整型数空白：32744微量或结冰：32700长整型缺测：-32766长整型空白：-32744海拔高度估测：+100000西经或南纬：取负数风仪高度为距平台高度：+500多个出现日期：995X连续项目的次年月份：+100气压极值取自定时：+20000结冰时的湿球温度：30XXX表示-XX.X℃水汽压未订正：+500最小相对湿度取自定时：+300定时观测云量10-：11云状中的天气现象：9XX，XX为天气现象编码云状中的时次结束：0云高中的时次结束：0雨量中纯雾露霜：32XXX雨量：31XXX雨夹雪量：31XXX自记降水小时值中的<：-1自记降水小时值中的：-2降水距平百分率≥1000%：10000连续最长无/小降水日数≥可计算天数：+1000蒸发量超刻度：+500无降水/结冰/积雪/冻土：0指定天气现象连续最长出现时数（分钟数）超可计算范围：用负数表示天气现象结束时间出现在夜间：-1八方位统计的风向：+100风向个数：90X风向≥个数：95X风速超刻度：+1000八风向统计的频率：+200最多风向为次多时（静风最大）：+50风向度数的静风表示：0风向度数来源于16方位观测：+1000风向度数来源于8方位观测：+2000地温零上超刻度：+10000地温零下超刻度：-10000冻土深度超刻度：+500逐小时日照：夜间时：-1天气现象序列中的特定值：0结束一天的序列30XX：天气现象编码4000/5000：夜间()1000-2440：起止时间=午夜起的分钟数+10003000：时间的…6000-7440：无终止时间的开始时间=午夜起的分钟数+600032767：无终止时间的开始时间缺测19-999：瞬时最大风速1.9-99.9m/s