Doppler产品数据格式(ProductDescriptionBlock)

---

ProductDescriptionBlock.java

---

001 /**
002  * PACKAGE     : cma.gmb.doppler.datatype
003  * FILENAME    : ProductDescriptionBlock.java
004  * DESCRIPTION : 多普勒雷达产品数据结构
005  * AUTHOR      : 刘泽军
006  * EMAIL       : BJ0773@gmail.com
007  * Date        : 2007-05-21 09:55:21
008  * Update      :
009  * Reference   : 《NEXRAD LEVEL II数据格式》中文版及英文版
010  */
011 
012 package cma.gmb.doppler.datatype;
013 
014 import java.io.*;
015 import java.lang.*;
016 
017 import cma.common.dataio.*;
018 
019 public class ProductDescriptionBlock {//产品说明数据结构
020 
021     public  static  int SIZE    = 102;
022 
023     public  short   BlockDivider;           //18~19 数据块分隔符，为-1
024     public  int     RadarLatitude;          //20~23 雷达站经度，单位：0.001度
025     public  int     RadarLongitude;         //24~27 雷达站纬度，单位：0.001度
026     public  short   RadarHeight;            //28~29 海拔高度，单位：英尺
027     public  short   ProductCode;            //30~31 产品代号
028     public  short   OperationalMode;        //32~33 运行模式，
029                                                 // 0=Maintenance
030                                                 // 1=Clear Air
031                                                 // 2=Precipitation/Server Weather
032     public  short   VolumeCoveragePattern;  //34~35 VCP方式
033     public  short   SequenceNumber;         //36~37 产品生成序列号
034     public  short   VolumeScanNumber;       //38~39 体扫计数，1~80之间循环
035     public  short   VolumeScanDate;         //40~41 体扫日期(Julian-1/1/70)
036     public  int     VolumeScanTime;         //42~45 体扫时间(GMT)
037     public  short   ProductGenerationDate;  //46~47产品生成日期
038     public  int     ProductGenerationTime;  //48~51 产品生成GMT时间
039     public  short   P1;                     //52~53
040     public  short   P2;                     //54~55
041     public  short   ElevationNumber;        //56~57 表示体扫中的第几个仰角层(1~20)
042     public  short   P3;                     //58~59
043     public  short[] DataLevelThreshold;     //60~91 数据分级门限值，共16个数据
044     public  short   P4;                     //92~93
045     public  short   P5;                     //94~95
046     public  short   P6;                     //96~97
047     public  short   P7;                     //98~99
048     public  short   P8;                     //100~101
049     public  short   P9;                     //102~103
050     public  short   P10;                    //104~105
051     public  short   NumberOfMaps;           //106~107 底图数据中的块数；
052                                                 // Version;   高字节表示 产品的版本号，原始产品为0；
053                                                 // StopBlank;  低字节1=Stop ON, 2=Stop OFF
054     public  int     OffsetToSymbology;      //108~111 符号数据偏移
055     public  int     OffsetToGraphic;        //112~115 图形数据偏移
056     public  int     OffsetToTabular;        //116~119 表格数据偏移
057 
058 /**
059  * 功能：构造函数
060  * 参数：
061  *      无
062  * 返回：
063  *      无
064  */
065     public ProductDescriptionBlock() {
066         DataLevelThreshold  = new short[16];
067     }
068 
069 /**
070  * 功能：从文件中读取数据，并进行BigEndian转换
071  * 参数：
072  *      raf     - 随机访问的文件对象
073  * 返回：
074  *      是否成功
075  */
076     public boolean read(RandomAccessFile raf) {
077         try {
078             byte[]  buf = new byte[ProductDescriptionBlock.SIZE];
079             int     len = raf.read(buf);
080             return(len == ProductDescriptionBlock.SIZE ? parse(buf, 0) : false);
081         }
082         catch(Exception ex) {
083             return(false);
084         }
085     }
086 
087 /**
088  * 功能：从输入流文件中读取数据，并进行BigEndian转换
089  * 参数：
090  *      in      - InputStream对象
091  * 返回：
092  *      是否成功
093  */
094     public boolean read(InputStream in) {
095         try {
096             byte[]  buf = new byte[ProductDescriptionBlock.SIZE];
097             int     len = in.read(buf);
098             return(len == ProductDescriptionBlock.SIZE ? parse(buf, 0) : false);
099         }
100         catch(Exception ex) {
101             return(false);
102         }
103     }
104 
105 /**
106  * 功能：从缓冲区中读数据
107  *       (在外部方法中，一次性读入所有数据，然后逐类分析数据)
108  * 参数：
109  *      buf     - 缓冲数据
110  *      index   - 偏移
111  * 返回：
112  *      正确读出的数据字节数
113  */
114     public int read(byte[] buf, int index) {
115         return(parse(buf, index)?ProductDescriptionBlock.SIZE:0);
116     }
117 
118 /**
119  * 功能：从缓冲区中分析出数据
120  * 参数：
121  *      buf     - 缓冲数据
122  * 返回：
123  *      是否成功
124  */
125     public boolean parse(byte[] buf) {
126         return(parse(buf, 0));
127     }
128 
129 /**
130  * 功能：从缓冲区中分析出数据
131  * 参数：
132  *      buf     - 缓冲数据
133  *      index   - 偏移
134  * 返回：
135  *      是否成功
136  */
137     public boolean parse(byte[] buf, int index) {
138         if( buf.length < index + ProductDescriptionBlock.SIZE ) {
139             return(false);
140         }
141         BlockDivider            = DataConverterBE.getShort(buf, index+ 0);//18~19 数据块分隔符，为-1
142         RadarLatitude           = DataConverterBE.getInt  (buf, index+ 2);//20~23 雷达站经度，单位：0.001度
143         RadarLongitude          = DataConverterBE.getInt  (buf, index+ 6);//24~27 雷达站纬度，单位：0.001度
144         RadarHeight             = DataConverterBE.getShort(buf, index+10);//28~29 海拔高度，单位：英尺
145         ProductCode             = DataConverterBE.getShort(buf, index+12);//30~31 产品代号
146         OperationalMode         = DataConverterBE.getShort(buf, index+14);//32~33 运行模式，
147         VolumeCoveragePattern   = DataConverterBE.getShort(buf, index+16);//34~35 VCP方式
148         SequenceNumber          = DataConverterBE.getShort(buf, index+18);//36~37 产品生成序列号
149         VolumeScanNumber        = DataConverterBE.getShort(buf, index+20);//38~39 体扫计数，1~80之间循环
150         VolumeScanDate          = DataConverterBE.getShort(buf, index+22);//40~41 体扫日期(Julian-1/1/70)
151         VolumeScanTime          = DataConverterBE.getInt  (buf, index+24);//42~45 体扫时间(GMT)
152         ProductGenerationDate   = DataConverterBE.getShort(buf, index+28);//46~47 产品生成日期
153         ProductGenerationTime   = DataConverterBE.getInt  (buf, index+30);//48~51 产品生成GMT时间
154         P1                      = DataConverterBE.getShort(buf, index+34);//52~53
155         P2                      = DataConverterBE.getShort(buf, index+36);//54~55
156         ElevationNumber         = DataConverterBE.getShort(buf, index+38);//56~57 表示体扫中的第几个仰角层(1~20)
157         P3                      = DataConverterBE.getShort(buf, index+40);//58~59 一般为仰角度数 *0.1
158         for(int i=0;i<16;i++) {
159             DataLevelThreshold[i]   = (short)((int)DataConverterBE.getShort(buf, index+42+i*2) % 256);//60~91 数据分级门限值
160         }
161         P4                      = DataConverterBE.getShort(buf, index+74);//92~93
162         P5                      = DataConverterBE.getShort(buf, index+76);//94~95
163         P6                      = DataConverterBE.getShort(buf, index+78);//96~97
164         P7                      = DataConverterBE.getShort(buf, index+80);//98~99
165         P8                      = DataConverterBE.getShort(buf, index+82);//100~101
166         P9                      = DataConverterBE.getShort(buf, index+84);//102~103
167         P10                     = DataConverterBE.getShort(buf, index+86);//104~105
168         NumberOfMaps            = DataConverterBE.getShort(buf, index+88);//106~107 底图数据中的块数；
169         OffsetToSymbology       = DataConverterBE.getInt  (buf, index+90);//108~111
170         OffsetToGraphic         = DataConverterBE.getInt  (buf, index+94);//112~115
171         OffsetToTabular         = DataConverterBE.getInt  (buf, index+98);//116~119
172         return(true);
173     }
174 
175 /**
176  * 功能：获得数据信息
177  * 参数：
178  *      无
179  * 返回：
180  *      数据信息
181  */
182     public String info() {
183         String  msg =
184             "/nProductDescriptionBlock.SIZE = " + String.valueOf(ProductDescriptionBlock.SIZE) +
185             "/n    BlockDivider             = " + String.valueOf(BlockDivider) +
186             "/n    RadarLatitude            = " + String.valueOf(RadarLatitude) +
187             "/n    RadarLongitude           = " + String.valueOf(RadarLongitude) +
188             "/n    RadarHeight              = " + String.valueOf(RadarHeight) +
189             "/n    ProductCode              = " + String.valueOf(ProductCode) +
190             "/n    OperationalMode          = " + String.valueOf(OperationalMode) +
191             "/n    VolumeCoveragePattern    = " + String.valueOf(VolumeCoveragePattern) +
192             "/n    SequenceNumber           = " + String.valueOf(SequenceNumber) +
193             "/n    VolumeScanNumber         = " + String.valueOf(VolumeScanNumber) +
194             "/n    VolumeScanDate           = " + String.valueOf(VolumeScanDate)+"("+MessageHeaderBlock.getDate(VolumeScanDate)+")" +
195             "/n    VolumeScanTime           = " + String.valueOf(VolumeScanTime)+"("+MessageHeaderBlock.getTime(VolumeScanTime)+")" +
196             "/n    ProductGenerationDate    = " + String.valueOf(ProductGenerationDate)+"("+MessageHeaderBlock.getDate(ProductGenerationDate)+")" +
197             "/n    ProductGenerationTime    = " + String.valueOf(ProductGenerationTime)+"("+MessageHeaderBlock.getTime(ProductGenerationTime)+")" +
198             "/n    P1                       = " + String.valueOf(P1) +
199             "/n    P2                       = " + String.valueOf(P2) +
200             "/n    ElevationNumber          = " + String.valueOf(ElevationNumber) +
201             "/n    P3                       = " + String.valueOf(P3);
202         for(int i=0;i<16;i++) {
203             msg = msg + "/n    DataLevelThreshold["+(i<10?" ":"")+String.valueOf(i)+"] = " + String.valueOf(DataLevelThreshold[i]);
204         }
205         msg = msg +
206             "/n    P4                       = " + String.valueOf(P4) +
207             "/n    P5                       = " + String.valueOf(P5) +
208             "/n    P6                       = " + String.valueOf(P6) +
209             "/n    P7                       = " + String.valueOf(P7) +
210             "/n    P8                       = " + String.valueOf(P8) +
211             "/n    P9                       = " + String.valueOf(P9) +
212             "/n    P10                      = " + String.valueOf(P10) +
213             "/n    NumberOfMaps             = " + String.valueOf(NumberOfMaps) +
214             "/n    OffsetToSymbology        = " + String.valueOf(OffsetToSymbology) +
215             "/n    OffsetToGraphic          = " + String.valueOf(OffsetToGraphic) +
216             "/n    OffsetToTabular          = " + String.valueOf(OffsetToTabular) +
217             "/n";
218         return(msg);
219     }
220 
221 /**
222  * 功能：打印数据，主要用于测试
223  * 参数：
224  *      无
225  * 返回：
226  *      无
227  */
228     public void print() {
229         System.out.println(info());
230     }
231 
232 }