LandPlotExample modified to display GSHHS data

GshhsLandPlotExample.java

/*
 * Copyright (c) 2012, Metron, Inc.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *     * Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 *     * Neither the name of Metron, Inc. nor the
 *       names of its contributors may be used to endorse or promote products
 *       derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL METRON, INC. BE LIABLE FOR ANY
 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
package com.metsci.glimpse.examples.charts.shoreline;

import java.io.IOException;
import java.io.InputStream;
import java.text.ParseException;

import com.metsci.glimpse.charts.shoreline.LandBox;
import com.metsci.glimpse.charts.shoreline.LandShapePainter;
import com.metsci.glimpse.charts.shoreline.gshhs.GshhsFile;
import com.metsci.glimpse.charts.shoreline.gshhs.GshhsPolygonHeader.UnrecognizedValueException;
import com.metsci.glimpse.charts.vector.MercatorProjection;
import com.metsci.glimpse.examples.Example;
import com.metsci.glimpse.layout.GlimpseLayoutProvider;
import com.metsci.glimpse.painter.decoration.CopyrightPainter;
import com.metsci.glimpse.painter.info.MeasurementPainter;
import com.metsci.glimpse.plot.SimplePlot2D;
import com.metsci.glimpse.support.color.GlimpseColor;
import com.metsci.glimpse.util.geo.LatLonGeo;
import com.metsci.glimpse.util.geo.projection.GeoProjection;
import com.metsci.glimpse.util.io.StreamOpener;

/**
 * Displays shoreline data available from the NOAA/NGDC Coastline Extractor
 * tool at http://www.ngdc.noaa.gov/mgg/coast/</p>
 *
 * When downloading data, choose the following options:
 * World Vector Shoreline
 * Compression Method: None
 * Coast Format: Mapgen
 * Coast Preview: No Preview
 *
 * @author ulman
 */
public class GshhsLandPlotExample implements GlimpseLayoutProvider
{
    public static void main( String[] args ) throws Exception
    {
        Example.showWithSwing( new GshhsLandPlotExample( ) );
    }

    @Override
    public SimplePlot2D getLayout( ) throws ParseException, IOException, UnrecognizedValueException
    {
        // create a tangent plane
        // land coordinates are specified as lat lons and must be converted
        // into flat rectangular coordinates to be displayed by glimpse
        final GeoProjection projection = new MercatorProjection( );

        // create a plot, which automatically provides axes, mouse interation, and
        // plot decorations like grid lines and mouse crosshairs
        final SimplePlot2D plot = new SimplePlot2D( );

        // don't show crosshairs
        plot.getCrosshairPainter( ).setVisible( false );

        // hide the plot title and the x and y axes
        plot.showTitle( false );
        plot.setTitleHeight( 0 );
        plot.setAxisSizeX( 0 );
        plot.setAxisSizeY( 0 );

        // set a 10 pixel border around the edge of the plot
        plot.setBorderSize( 10 );

        // create a custom layer to display land and load data into it
        // the data file used was created using the NOAA/NGDC Coastline Extractor
        // tool at http://www.ngdc.noaa.gov/mgg_coastline/
        LandShapePainter landLayer = new LandShapePainter( );

        // select a subsection of the data (this is currently ignored)
        LatLonGeo neCorner = LatLonGeo.fromDeg( 20, 10 );
        LatLonGeo swCorner = LatLonGeo.fromDeg( 10, -10 );
        LandBox box = new LandBox( swCorner, neCorner, true );

        // load the gshhs data file (version 1.1 supported)
        InputStream in = StreamOpener.fileThenResource.openForRead( "/path/to/gshhs/file" );
        GshhsFile file = new GshhsFile( in, box, false );

        // load the data into the painter
        landLayer.loadLandFileAndCenterAxis( file, projection, plot.getAxis( ) );

        // customize the background color of the plot
        plot.setPlotBackgroundColor( GlimpseColor.fromColorHex( "#bbc2c7" ) );

        // add a Metron copywrite notice to the plot
        plot.addPainter( new CopyrightPainter( ) );

        // add the land layer created above to the plot
        plot.addPainter( landLayer );

        // add a painter which displays angles and distances between points (activated by right clicking)
        plot.addPainter( new MeasurementPainter( "m" ) );

        // lock the plot to a 1 to 1 aspect ratio
        plot.lockAspectRatioXY( 1.0f );
        // don't show horizontal/vertical bars marking the cursor position
        plot.getCrosshairPainter( ).setVisible( false );

        return plot;
    }
}