Java 调用gdal API(二)——栅格裁剪

gdal可以说是GIS数据处理比较好的工具之一,虽然也提供了Java API,但是官方文档确实太过简单,用起来确实太难受,每次都需要去参考对应的C++api,然后在对应使用。

因此小编决定从这篇文章开始,将自己以前以及今后用到的API,都记录下,以帮助更多从事java GIS服务开发者。

今天主要来记录栅格数据的裁剪功能,gdal中提供了多种裁剪方法,今天主要介绍以下两种:

第一中是通过gdal自身的Warp方法,其实现有以下几个接口;

public static int Warp(Dataset dstDS, Dataset[] object_list_count, WarpOptions warpAppOptions, ProgressCallback callback);
public static int Warp(Dataset dstDS, Dataset[] object_list_count, WarpOptions warpAppOptions);
public static Dataset Warp(String dest, Dataset[] object_list_count, WarpOptions warpAppOptions, ProgressCallback callback);
public static Dataset Warp(String dest, Dataset[] object_list_count, WarpOptions warpAppOptions);

其实这个几个接口基本差不多

1、dstDs/dest 其实就是目标数据,两种方式,要么传入目标路径,要么是目标Dataset

2、object_list_count 这个是源数据的Dataset 数据

3、warpAppOptions 这个参数很重要,是我们裁剪需要传递的重要参数,后面代码会专门解释

4、callback 处理进度

下面我们结合最后一个方法,来处理一个栅格裁剪

 

private static void cutTif() throws FactoryException, IOException, ParseException {
        Dataset dataSet = gdal.Open("E:\\数据\\影像数据\\tiff\\xian18.tif");
        //通过最大最小经纬度生成一个面矢量
        createCutShapeRegion(108.583740,33.928528,108.883740,34.260242);
        Vector vector = new Vector();
        vector.add("-cutline");
        vector.add("D:\\data\\cut2.shp");
        vector.add("-crop_to_cutline");
        Dataset ds = gdal.Warp("D:\\data\\xian18_1.tif",new Dataset[]{dataSet},new WarpOptions(vector));
        if (ds != null){
            System.out.println("成功!");
        }
    }
createCutShapeRegion是用通过bbox来生成shape数据的,我这边是用矩形来裁剪的,当然你也可以用多边形,通过传入多边形的顶点来生层一个面矢量,记住一定是面矢量,
D:\\data\\cut2.shp是createCutShapeRegion生成的矢量文件,最主要的两个参数一个是-cutline 一个是-crop_to_cutline,其中-cutline后面跟裁剪的矢量文件,-crop_to_cutline不需要具体值,这些具体参数可参考gdal的warp的参数介绍,其实和安装版gdalwarp的参数是基本一致的。

但是这里说明下,并不是gdalwarp的所有参数都在gdal的java api中进行了适配,就比如gdalwarp这个命令中除了上面使用shp作为裁剪之外,还有一个-te参数,这个参数后面跟一个经纬度的范围
主要作用就是将原始数据裁剪为制定的范围,就比如我们使用安装的gdal中可以这样调用裁剪
gdalwarp.exe -te 108.583740 33.928528 108.883740 34.260242  E:\\数据\\影像数据\\tiff\\xian18.tif D:\\data\\xian18_2.tif
然而这个-te参数如果使用代码来调用,就会报没有-te这个option,就比如下面的这个例子其实是跑不通的
public static void main(String[] args) throws NoSuchFieldException, IllegalAccessException, FactoryException, IOException, ParseException {
        gdal.AllRegister();
        Dataset dataSet = gdal.Open("E:\\数据\\影像数据\\tiff\\xian18.tif");
        Vector vector = new Vector();
        vector.add("-te");
        vector.add("108.583740 33.928528 108.883740 34.260242"); //裁剪范围
        vector.add("-crop_to_cutline");
        Dataset ds = gdal.Warp("D:\\data\\xian18_1.tif",new Dataset[]{dataSet},new WarpOptions(vector));
    }

上述代码是跑不通的,虽然安装板的gdalwarp可以使用-te来裁剪,而且效率比上面使用shp要更快,但是java代码的api却没有集成这个-te参数,当然我不知道是我调用的问题,还是确实没有适配

如果有了解的朋友,麻烦告知一声。

 

除了上述使用gdalwarp的接口外,我们还可以通过使用driver来快速裁剪出一个tif,具体代码如下

private static void clipRaster(Dataset dataset, Envelope boundingBox){
        //获取当前数据范围
        ReferencedEnvelope originalEnvelope = (ReferencedEnvelope) GdalDataAnalysis.readBboxFromFile(dataset);
        //判断是否相交,不想交则直接返回
        if (!originalEnvelope.intersects(boundingBox)){
            return;
        }
        //求请求与原始数据的范围
        ReferencedEnvelope interEnvelope = originalEnvelope.intersection(boundingBox);
        //原始数据上偏移位置
        int offset_x = (int) ((interEnvelope.getMinX() - originalEnvelope.getMinX()) / GdalDataAnalysis.getResoulution(dataset,true));
        int offset_y = (int) ((interEnvelope.getMaxY() - originalEnvelope.getMaxY()) / GdalDataAnalysis.getResoulution(dataset,false));
        //需要多少个原始像素
        int block_xsize = (int) ((interEnvelope.getMaxX() - interEnvelope.getMinX()) / GdalDataAnalysis.getResoulution(dataset,true));
        int block_ysize = (int)Math.abs((interEnvelope.getMaxY() - interEnvelope.getMinY()) / GdalDataAnalysis.getResoulution(dataset,false));
        //实际瓦片的长度,裁剪数据的分辨率和原始图像一致
        int image_Xbuf = block_xsize;
        int image_Ybuf =  block_ysize;
        //写入瓦片的偏移位置
        int imageOffSetX = 0;
        int imageOffSetY = 0;
        //循环读写
        Driver driver = gdal.GetDriverByName("GTiff");
        int dataType = dataset.GetRasterBand(1).getDataType();
        int bands = dataset.getRasterCount();
        byte[] pixelArray = new byte[image_Xbuf*image_Ybuf];
        Dataset dsDataset = driver.Create("D:\\data\\xian18_1.tif",image_Xbuf,image_Ybuf,bands, dataType);
        for (int i = 1;i<=bands;i++){
            Band band = dataset.GetRasterBand(i);
            band.ReadRaster(offset_x,offset_y,block_xsize,block_ysize,image_Xbuf,image_Ybuf,dataType,pixelArray);
            //写数据
            dsDataset.GetRasterBand(i).WriteRaster(imageOffSetX,imageOffSetY,block_xsize,block_ysize,pixelArray);
            //清理删除缓存
            dsDataset.GetRasterBand(i).FlushCache();
            dsDataset.GetRasterBand(i).delete();
        }
        dsDataset.SetProjection(dataset.GetProjection());
        double[] rsGeoTransform = dataset.GetGeoTransform();
        rsGeoTransform[0] = interEnvelope.getMinX();
        rsGeoTransform[3] = interEnvelope.getMaxY();
        dsDataset.SetGeoTransform(rsGeoTransform);
        dsDataset.FlushCache();
        dsDataset.delete();
    }

这个函数中dataset是原始数据,boundingBox是裁剪矩形范围,当然这个方法,无法裁剪不规则多边形,也就是它只能裁剪矩形规则范围。

相比使用shape文件裁剪效率,这个直接拷贝像素的效率更高,当然这些裁剪方法中,还是直接使用gdalwarp.exe的-te参数效率最高,但是

奈何gdal的java api中好像没有适配这个参数,不知道为什么?

好了今天的内容就讲解到这里,如有问题,欢迎评论区讨论。

 

 

 

 




 




 

 


 

热门相关:亿万盛宠只为你   富贵不能吟   锦庭娇   戏精老公今天作死没   修真界败类