001 //$HeadURL: svn+ssh://jwilden@svn.wald.intevation.org/deegree/base/branches/2.5_testing/src/org/deegree/model/coverage/grid/CompoundGridCoverageReader.java $
002 /*----------------------------------------------------------------------------
003 This file is part of deegree, http://deegree.org/
004 Copyright (C) 2001-2009 by:
005 Department of Geography, University of Bonn
006 and
007 lat/lon GmbH
008
009 This library is free software; you can redistribute it and/or modify it under
010 the terms of the GNU Lesser General Public License as published by the Free
011 Software Foundation; either version 2.1 of the License, or (at your option)
012 any later version.
013 This library is distributed in the hope that it will be useful, but WITHOUT
014 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
015 FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
016 details.
017 You should have received a copy of the GNU Lesser General Public License
018 along with this library; if not, write to the Free Software Foundation, Inc.,
019 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
020
021 Contact information:
022
023 lat/lon GmbH
024 Aennchenstr. 19, 53177 Bonn
025 Germany
026 http://lat-lon.de/
027
028 Department of Geography, University of Bonn
029 Prof. Dr. Klaus Greve
030 Postfach 1147, 53001 Bonn
031 Germany
032 http://www.geographie.uni-bonn.de/deegree/
033
034 e-mail: info@deegree.org
035 ----------------------------------------------------------------------------*/
036 package org.deegree.model.coverage.grid;
037
038 import java.io.IOException;
039 import java.util.ArrayList;
040 import java.util.List;
041
042 import org.deegree.datatypes.parameter.GeneralParameterValueIm;
043 import org.deegree.datatypes.parameter.InvalidParameterNameException;
044 import org.deegree.datatypes.parameter.InvalidParameterValueException;
045 import org.deegree.datatypes.parameter.ParameterNotFoundException;
046 import org.deegree.framework.log.ILogger;
047 import org.deegree.framework.log.LoggerFactory;
048 import org.deegree.model.spatialschema.Envelope;
049 import org.deegree.ogcwebservices.LonLatEnvelope;
050 import org.deegree.ogcwebservices.wcs.configuration.File;
051 import org.deegree.ogcwebservices.wcs.describecoverage.CoverageOffering;
052
053 /**
054 * This reader enables creation of <tt>GridCoverage</tt>s from more than one source. This will be
055 * used for example for tiled images.
056 *
057 *
058 * @author <a href="mailto:poth@lat-lon.de">Andreas Poth</a>
059 * @author last edited by: $Author: mschneider $
060 *
061 * @version $Revision: 18195 $, $Date: 2009-06-18 17:55:39 +0200 (Do, 18 Jun 2009) $
062 */
063
064 public class CompoundGridCoverageReader extends AbstractGridCoverageReader {
065
066 private static final ILogger LOGGER = LoggerFactory.getLogger( CompoundGridCoverageReader.class );
067
068 /**
069 * @param source
070 * @param description
071 * @param envelope
072 * @param format
073 */
074 public CompoundGridCoverageReader( File[] source, CoverageOffering description, Envelope envelope, Format format ) {
075 super( source, description, envelope, format );
076 }
077
078 /**
079 * Read the grid coverage from the current stream position, and move to the next grid coverage.
080 *
081 * @param parameters
082 * An optional set of parameters. Should be any or all of the parameters returned by
083 * {@link "org.opengis.coverage.grid.Format#getReadParameters"}.
084 * @return A new {@linkplain GridCoverage grid coverage} from the input source.
085 * @throws InvalidParameterNameException
086 * if a parameter in <code>parameters</code> doesn't have a recognized name.
087 * @throws InvalidParameterValueException
088 * if a parameter in <code>parameters</code> doesn't have a valid value.
089 * @throws ParameterNotFoundException
090 * if a parameter was required for the operation but was not provided in the
091 * <code>parameters</code> list.
092 * @throws IOException
093 * if a read operation failed for some other input/output reason, including
094 * {@link java.io.FileNotFoundException} if no file with the given <code>name</code>
095 * can be found, or {@link javax.imageio.IIOException} if an error was thrown by the
096 * underlying image library.
097 */
098 public GridCoverage read( GeneralParameterValueIm[] parameters )
099 throws InvalidParameterNameException, InvalidParameterValueException,
100 ParameterNotFoundException, IOException {
101
102 File[] files = (File[]) source;
103 List<GridCoverage> list = new ArrayList<GridCoverage>( files.length );
104 for ( int i = 0; i < files.length; i++ ) {
105 GridCoverageReader gcr = createGridCoverageReader( files[i] );
106 if ( gcr != null ) {
107 GridCoverage gc = gcr.read( parameters );
108 if ( gc != null ) {
109 list.add( gc );
110 }
111 }
112 }
113 return createGridCoverage( list );
114 }
115
116 /**
117 * creates a GridCoverage compound from the GridCoverages contained in the passed List. It is
118 * assumed that all GridCoverages in the List are of the same type and that the list contains at
119 * least one GridCoverage
120 *
121 * @param list
122 * @return a GridCoverage compound from the GridCoverages contained in the passed List.
123 */
124 private GridCoverage createGridCoverage( List<GridCoverage> list ) {
125
126 GridCoverage gc = null;
127 if ( list != null && list.size() > 0 ) {
128 gc = list.get( 0 );
129 if ( gc instanceof ImageGridCoverage ) {
130 ImageGridCoverage[] tmp = new ImageGridCoverage[list.size()];
131 tmp = list.toArray( tmp );
132 gc = new ImageGridCoverage( description, envelope, tmp );
133 } else if ( gc instanceof ByteGridCoverage ) {
134 ByteGridCoverage[] tmp = new ByteGridCoverage[list.size()];
135 tmp = list.toArray( tmp );
136 gc = new ByteGridCoverage( description, envelope, tmp );
137 } else if ( gc instanceof ShortGridCoverage ) {
138 ShortGridCoverage[] tmp = new ShortGridCoverage[list.size()];
139 tmp = list.toArray( tmp );
140 gc = new ShortGridCoverage( description, envelope, tmp );
141 } else if ( gc instanceof FloatGridCoverage ) {
142 FloatGridCoverage[] tmp = new FloatGridCoverage[list.size()];
143 tmp = list.toArray( tmp );
144 gc = new FloatGridCoverage( description, envelope, tmp );
145 }
146 }
147
148 return gc;
149 }
150
151 /**
152 * creates a GridCoverageReader depending on the native format of the data source
153 *
154 * @param file
155 * @return a GridCoverageReader depending on the native format of the data source
156 * @throws IOException
157 */
158 private GridCoverageReader createGridCoverageReader( File file )
159 throws IOException, InvalidParameterValueException {
160
161 // calculate and set LonLatBoundingBox for the GC CoverageOffering
162 // as source of the returned GridCoverage
163 LonLatEnvelope lle = calcLonLatEnvelope( file.getEnvelope(), file.getCrs().getIdentifier() );
164 CoverageOffering desc = (CoverageOffering) description.clone();
165 desc.setLonLatEnvelope( lle );
166
167 Envelope env = envelope.createIntersection( file.getEnvelope() );
168 GridCoverageReader gcr = null;
169 if ( env != null ) {
170 if ( format.getName().equalsIgnoreCase( "GEOTIFF" ) ) {
171 gcr = new GeoTIFFGridCoverageReader( file, desc, env, format );
172 } else if ( isImageFormat( format ) ) {
173 gcr = new ImageGridCoverageReader( file, desc, env, format );
174 } else {
175 throw new IOException( "not supported file format: " + format.getName() );
176 }
177 } else {
178 LOGGER.logInfo( "no data available for BBOX: ", file.getEnvelope() );
179 }
180
181 return gcr;
182 }
183
184 /**
185 * returns true if the passed format is an image format
186 *
187 * @param format
188 * @return <code>true</code> if the passed format is an image format
189 */
190 private boolean isImageFormat( Format format ) {
191 String frmt = format.getName().toUpperCase();
192 return frmt.equalsIgnoreCase( "png" ) || frmt.equalsIgnoreCase( "bmp" ) || frmt.equalsIgnoreCase( "tif" )
193 || frmt.equalsIgnoreCase( "tiff" ) || frmt.equalsIgnoreCase( "gif" ) || frmt.equalsIgnoreCase( "jpg" )
194 || frmt.equalsIgnoreCase( "jpeg" ) || frmt.indexOf( "ECW" ) > -1;
195 }
196
197 /**
198 * This method is an implementation dummy, it doensn't actually do anything.
199 */
200 public void dispose()
201 throws IOException {
202 // throwin nottin
203 }
204
205 }