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

地面气象月报表数据文件查询软件使用说明国家气象信息中心气象资料室软件编写：周学东（江苏省气候中心）目 录一、软件简介二、软件的安装、升级、卸载三、使用前的准备工作四、启动软件五、基本参数确定六、软件界面及主要功能七、查询数据八、保存和恢复工作状态九、保存结果十、复制结果到其它软件十一、打印结果十二、对齐方式十三、自定义软件功能十四、动态连接库函数返回值特定值简要列表十五、动态连接库函数返回值主要项目单位（量纲）简要列表一、 软件简介本软件使用模式数据文件访问接口动态连接库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启动软件，首先将进入获取数据的参数输入窗口：五、 基本参数确定参数输入窗口中下面的三行为基本参数区，点击“基本设置”按钮可以关闭，同时该按钮会变为“更多设置”。再点则会打开该参数区。当存在默认值文件，软件启动时会读取该默认值，并默认关闭基本参数区的显示，如必要，请点击“更多设置”按钮打开。如果使用距平（百分率）项目，请在累年平均文件输入区中已经做好的累年平均值文件名（如果不在软件所在目录下，请指定路径）。根据动态连接库YearStat.DLL的约定，软件必须知道模式文件的保存路径，否则结果将总是缺测。使用的模式文件分为3类：A0、A1类；A类；A6、A7类。请将A0、A1、A类文件（也可以使用A2文件）的路径输入A/A0文件路径输入区（优先顺序为2003版A文件、2000版A文件、A1文件、A2文件、A0文件。A6、A7文件的路径输入A6/7文件路径输入区。考虑到操作系统对文件目录管理的效率直接取决于目录中文件目录名的数量，所以建议有关数据分开保存，同时因为YearStat.DLL支持包含可变区站号（用#表示）和可变年份（用%表示）的路径名，因此也强烈建议模式文件按站（或年）分目录保存，将各目录下的文件名数量控制在1024以下（一般不要超过2048）。输入区中的路径名可以直接指向IP地址（或共享计算机名）开始的共享路径而不映射逻辑盘符（但要保证有读数据的权限），也可以使用相对路径（当前路径为软件所在的路径）。历史上的模式文件很多是人工输入的，因此数据可能存在一些错误，软件对其中一些错误采取了智能容错处理，但对于以下5种情况需要由使用者指定容错方法：1、重算20-20时雨量：由于输入错误，某些天的20-08、08-20、20-20时雨量出现矛盾，如果选择重算20-20时雨量，则文件中的20-20时值作废，按照20-08、08-20时值重新计算，否则保留矛盾的20-20时值。2、规范处理冻土数据：如果某天某层（共2层）的冻土深度为“, 000”则修改为“, ,”，如果深度的下界小于上界，则上下界值交换。3、R=改为R0=：很多情况下，模式文件对于全月无降水情况会不小心输入R=（全月缺测），如果没有对历史资料进行此方式位的重新检查，建议选择此项。4、Z=改为Z0=：很多情况下，模式文件对于全月无积雪情况会不小心输入Z=（全月缺测），如果没有对历史资料进行此方式位的重新检查，建议选择此项。5、A=改为A0=：很多情况下，模式文件对于全月无冻土情况会不小心输入A=（全月缺测），但确实大部分站不观测冻土，因此如果没有对历史资料进行此方式位的重新检查，选择此项可以使得冻土结果由缺测变为无冻土。所指定的参数如果需要成为默认值（启动软件时将自动恢复），请使用“保存为默认值”按钮（要求软件目录有修改权限），如果临时修改输入区中的设置后需要恢复默认设置时，请使用“重读默认值”按钮。默认值被保存在Def_Path.TXT文件中，其格式为：A/A0模式文件路径A6/7模式文件路径累年平均值文件（含路径）重算20-20时雨量状态（1=设置，0不设置）规范处理冻土数据状态（1=设置，0不设置）R=改为R0=状态（1=设置，0不设置）Z=改为Z0=状态（1=设置，0不设置）A=改为A0=状态（1=设置，0不设置）六、 软件界面及主要功能软件有两个窗口，一个是上面的参数输入窗口，另一个是获取结果的查阅窗口。在软件主菜单9项中前6项仅对结果查阅窗口有效。参数输入窗口包括包括一个分类页、一个选站区、一组起止年月输入区、一组直接保存到文件参数区、定时项目的4次输出控制、可选项目分类控制、输出格式选择控制、项目添加删除及顺序控制按钮组、选站按钮组、保存状态按钮、重读状态按钮、获取数据按钮、取消按钮等，而每一类分类页（年、月、日、时等）各包含独立的已选项目和可选项目列表。选站区另外提供一个鼠标右键小菜单提供一组增强功能（按区站号排序、按站名排序、同地区站选择/不选、定位指定站、定位下一个站、刷新台站资料信息、查看详细资料信息、不选无资料/资料不齐站点等）。主菜单可以使用“帮助”、“版本”及“退出”功能。程序同时提供光标跟随短提示，可以提示相应输入区的作用。其中年份限制选择1951年到当前的年份。结果查阅窗口则只有一个主菜单和结果表格。主菜单可以重新进入获取数据的参数输入窗口、结果保存、结果复制到剪贴板、结果打印、左对齐表格、右对齐表格、帮助、版本和退出的功能，结果区可以滚动浏览全部结果，鼠标右键支持个别数据的复制到剪贴板的功能以及显示区列宽的增加和减少功能。每次获取新的资料后，表格的列宽是自动调整为适应内容的，你可以适当加宽列，但不能缩小到比自动宽度更小的值。七、 查询数据进入获取数据的参数输入窗口（如正在结果查询窗口中，请选择主菜单的“获取新资料”）。1、选择需要查询的分类（年、月、旬、日、时等），然后进行所需要项目的挑选，挑选时，从右侧的可选窗口中选择所需要的项目，双击之或点击“添加项目”将该项目添加到已选项目区的末尾（重复添加无效），使用“删除项目”删除已选项目中的指定项目，使用“项目上移”和“项目下移”改变已选项目中的项目排列顺序。请直接在“添加项目”右侧的下拉选择中选择要素类别，可选择项目清单会立即刷新（没有可选项目时为空的清单）。如果查询定时值，可以选择“仅使用四时次”禁止24次的结果输出。2、选择起止年（月），直接在窗口下方的年、月项目中选择，如果希望多年查询时不使用历年同期功能，请去掉“历年同期”前的选择，其中年项目不出现月选择和历年同期选择。3、选择站点，直接在站点清单的相应方框内点击进行选择/不选择（请注意：站点区最右边的一列被系统定义为窗口内容平移的点击区，如果直接点击最右列的方框，结果将不是所希望的），也可以点击“全选”选择全部站点、“清除”取消全部的选择。4、你可以使用鼠标右键小菜单进行排序、条件定位、按地区批量选择/不选、按资料情况批量不选，加快选择速度。软件支持按区站号或站名的双向排序；指定一个站后（蓝色），可以要求对该站同地区的站进行全选或全不选（不如选择一个省的全部站）；可以通过输入区站号或站名的一部分直接定位到相应的站（或下一个站）；可以直接定位到下一个被选择的或未被选择的站；可以手动刷新台站资料情况；可以对已经获得的台站资料情况查询详细的年、月资料存在情况；可以根据获得的台站资料情况，排除对无资料的或者资料不齐的站的选择。5、选择输出格式（格式化输出、函数原始值输出），使用格式化输出可以输出比较直观的结果，比如隐含的小数位会恢复，一些观测特性和超限数据等的标志会比较直观，缺测用“/”表示，空白用“-”表示，结冰无记录或微量等用“*”表示，日期等出现多个使用个数后+“n”表示，风向或风向度数如果来自8/16风向，后面加上(8)/(16)表示，高度估测/水汽压未订正加括号，直接用、中文标注进行辅助说明等，但格式化输出对进一步的计算处理会带来麻烦。使用函数原始值输出，则一般均为整数型数据，部分数据会隐含小数位数，观测特性、超限等标志用特定数表示，缺测、空白、结冰和微量也使用特定数表示，特定值的定义因要素和项目不同而各不相同，一般的，对于整型数据，缺测用32766表示，空白用32744表示，微量或结冰等用32700表示，对于长整型数据（如年降水量、年蒸发量、年日照时数、气温稳定通过期间的气温降水日照合计等），缺测用-32766表示，空白用-32744表示，如果日期出现多个，用995X表示，如果风向出现多个用90X表示，风向出现个数为的不确定值，用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结冰时的湿球温度：3