All Downloads are FREE. Search and download functionalities are using the official Maven repository.

uk.ac.rdg.resc.edal.wms.GetMapParameters Maven / Gradle / Ivy

There is a newer version: 1.5.3
Show newest version
/*******************************************************************************
 * Copyright (c) 2013 The University of Reading
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. 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.
 * 3. Neither the name of the University of Reading, nor the names of the
 *    authors or contributors may be used to endorse or promote products
 *    derived from this software without specific prior written permission.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 THE AUTHOR 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 uk.ac.rdg.resc.edal.wms;

import java.util.ArrayList;
import java.util.List;
import java.util.Set;

import org.joda.time.Chronology;
import org.joda.time.DateTime;
import org.joda.time.Period;

import uk.ac.rdg.resc.edal.domain.Extent;
import uk.ac.rdg.resc.edal.domain.TemporalDomain;
import uk.ac.rdg.resc.edal.exceptions.BadTimeFormatException;
import uk.ac.rdg.resc.edal.exceptions.EdalException;
import uk.ac.rdg.resc.edal.exceptions.IncorrectDomainException;
import uk.ac.rdg.resc.edal.geometry.BoundingBox;
import uk.ac.rdg.resc.edal.graphics.exceptions.EdalLayerNotFoundException;
import uk.ac.rdg.resc.edal.graphics.formats.ImageFormat;
import uk.ac.rdg.resc.edal.graphics.formats.InvalidFormatException;
import uk.ac.rdg.resc.edal.graphics.style.Drawable.NameAndRange;
import uk.ac.rdg.resc.edal.graphics.utils.PlottingDomainParams;
import uk.ac.rdg.resc.edal.grid.TimeAxis;
import uk.ac.rdg.resc.edal.metadata.VariableMetadata;
import uk.ac.rdg.resc.edal.util.Extents;
import uk.ac.rdg.resc.edal.util.GISUtils;
import uk.ac.rdg.resc.edal.util.TimeUtils;
import uk.ac.rdg.resc.edal.wms.exceptions.EdalUnsupportedOperationException;
import uk.ac.rdg.resc.edal.wms.util.WmsUtils;

/**
 * Object representing a request to the GetMap operation. This simply parses the
 * request and only does very basic sanity checking on the parameters (e.g.
 * checking for valid integers).
 * 
 * @author Guy Griffiths
 */
public class GetMapParameters {
    protected String wmsVersion;
    private String formatString;
    private boolean animation;
    private List animationTimesteps = new ArrayList<>();
    private int frameRate;

    protected PlottingDomainParams plottingDomainParams;
    private GetMapStyleParams styleParameters;

    /**
     * Creates a new instance of GetMapParameter from the given RequestParams
     * 
     * @param params
     *            A {@link RequestParams} object representing the URL parameters
     *            to parse
     * @param catalogue
     *            A {@link WmsCatalogue}. This is used to determine the
     *            {@link Chronology} of the dataset being referred to so that
     *            the time values can be parsed correctly
     * 
     * @throws EdalException
     *             if the request is invalid
     */
    public GetMapParameters(RequestParams params, WmsCatalogue catalogue) throws EdalException {
        this.wmsVersion = params.getMandatoryWmsVersion();
        if (!WmsUtils.SUPPORTED_VERSIONS.contains(this.wmsVersion)) {
            throw new EdalException("VERSION " + this.wmsVersion + " not supported");
        }
        formatString = params.getString("format", "image/png");
        animation = params.getBoolean("animation", false);
        frameRate = params.getPositiveInt("frameRate", 24);
        styleParameters = new GetMapStyleParams(params, catalogue);

        /*
         * Now we have the style parameters, we can find out which layers we
         * will be requesting, and hence which Chronology the time strings are
         * referring to.
         * 
         * All layers need to share the same chronology (otherwise the time
         * string may be ambiguous)
         */
        Chronology chronology = null;
        Set fieldsWithScales = styleParameters.getImageGenerator(catalogue)
                .getFieldsWithScales();
        for (NameAndRange nameAndRange : fieldsWithScales) {
            String wmsLayerName = nameAndRange.getFieldLabel();
            TemporalDomain temporalDomain = WmsUtils.getVariableMetadataFromLayerName(wmsLayerName,
                    catalogue).getTemporalDomain();
            if (temporalDomain != null) {
                if (chronology == null) {
                    chronology = temporalDomain.getChronology();
                } else {
                    if (temporalDomain.getChronology() != null) {
                        if (!chronology.equals(temporalDomain.getChronology())) {
                            throw new IncorrectDomainException(
                                    "All datasets referenced by a GetMap request must share the same chronology");
                        }
                    }
                }
            }
        }
        plottingDomainParams = parsePlottingParams(params, chronology, wmsVersion);
        if (animation) {
            animationTimesteps = parseAnimationTimesteps(params, chronology, catalogue,
                    styleParameters);
        }
    }

    public PlottingDomainParams getPlottingDomainParameters() {
        return plottingDomainParams;
    }

    public GetMapStyleParams getStyleParameters() {
        return styleParameters;
    }

    public String getWmsVersion() {
        return wmsVersion;
    }

    public boolean isAnimation() {
        return animation;
    }

    public List getAnimationTimesteps() {
        return animationTimesteps;
    }
    
    public int getFrameRate() {
        return frameRate;
    }
    
    /**
     * @return The {@link ImageFormat} corresponding to the supplied FORMAT
     *         argument
     * @throws InvalidFormatException
     *             if the supplied FORMAT does not represent a supported
     *             {@link ImageFormat}
     */
    public ImageFormat getImageFormat() throws InvalidFormatException {
        return ImageFormat.get(formatString);
    }

    /**
     * @return The supplied format string, regardless of whether it represents a
     *         supported image type
     */
    public String getFormatString() {
        return formatString;
    }
    
    private static PlottingDomainParams parsePlottingParams(RequestParams params,
            Chronology chronology, String wmsVersion) throws EdalException {
        String timeString = params.getString("time");
        DateTime startTime = null;
        DateTime endTime = null;
        if (timeString != null && !timeString.trim().equals("")) {
            String[] timeStrings = timeString.split(",");
            if (timeStrings.length == 1) {
                /*
                 * We have a single time(range) - i.e. not an animation, so we
                 * interpret this as a time extent
                 */
                String[] timeRangeParts = timeStrings[0].split("/");
                String startTimeStr;
                String endTimeStr;

                if (timeRangeParts.length == 1) {
                    startTimeStr = timeRangeParts[0];
                    endTimeStr = timeRangeParts[0];
                } else if (timeRangeParts.length == 2 || timeRangeParts.length == 3) {
                    /*
                     * This covers either a straight range, or a range including
                     * a timestep period
                     */
                    startTimeStr = timeRangeParts[0];
                    endTimeStr = timeRangeParts[1];
                } else {
                    throw new BadTimeFormatException("Time can either be a single value or a range");
                }
                startTime = TimeUtils.iso8601ToDateTime(startTimeStr, chronology);
                endTime = TimeUtils.iso8601ToDateTime(endTimeStr, chronology);
            }
        }

        Extent tExtent = null;
        if (startTime != null && endTime != null) {
            tExtent = Extents.newExtent(startTime, endTime);
        }

        String targetTimeStr = params.getString("targettime");
        DateTime targetTime = null;
        if (targetTimeStr == null) {
            if (tExtent != null) {
                targetTime = tExtent.getHigh();
            }
        } else {
            targetTime = TimeUtils.iso8601ToDateTime(targetTimeStr, chronology);
        }

        Extent zExtent = null;
        String depthString = params.getString("elevation");
        if (depthString != null && !depthString.trim().equals("")) {
            String[] depthStrings = depthString.split("/");
            if (depthStrings.length == 1) {
                try {
                    Double depth = Double.parseDouble(depthStrings[0]);
                    zExtent = Extents.newExtent(depth, depth);
                } catch (NumberFormatException e) {
                    throw new IllegalArgumentException("Depth format is wrong: " + depthStrings[0]);
                }
            } else if (depthStrings.length == 2) {
                try {
                    zExtent = Extents.newExtent(Double.parseDouble(depthStrings[0]),
                            Double.parseDouble(depthStrings[1]));
                } catch (NumberFormatException e) {
                    throw new IllegalArgumentException("Depth format is wrong: " + depthString);
                }
            } else {
                throw new IllegalArgumentException("Depth can either be a single value or a range");
            }
        }

        Double targetDepth = null;
        String targetDepthString = params.getString("targetelevation");
        if (targetDepthString != null) {
            try {
                targetDepth = Double.parseDouble(targetDepthString);
            } catch (NumberFormatException e) {
                throw new IllegalArgumentException("TARGETELEVATION format is wrong: "
                        + targetDepthString);
            }
        }
        if (targetDepth == null && zExtent != null) {
            targetDepth = zExtent.getHigh();
        }

        String crsCode;
        BoundingBox bbox;
        if (wmsVersion.equals("1.3.0")) {
            crsCode = params.getMandatoryString("CRS");
            if (crsCode.equalsIgnoreCase("EPSG:4326")) {
                crsCode = "CRS:84";
                bbox = GISUtils.parseBbox(params.getMandatoryString("bbox"), false, crsCode);
            } else {
                bbox = GISUtils.parseBbox(params.getMandatoryString("bbox"), true, crsCode);
            }
        } else {
            crsCode = params.getMandatoryString("SRS");
            if (crsCode.equalsIgnoreCase("EPSG:4326")) {
                crsCode = "CRS:84";
            }
            bbox = GISUtils.parseBbox(params.getMandatoryString("bbox"), true, crsCode);
        }

        return new PlottingDomainParams(params.getMandatoryPositiveInt("width"),
                params.getMandatoryPositiveInt("height"), bbox, zExtent, tExtent, null,
                targetDepth, targetTime);
    }

    private List parseAnimationTimesteps(RequestParams params, Chronology chronology,
            WmsCatalogue catalogue, GetMapStyleParams styleParameters)
            throws EdalLayerNotFoundException, BadTimeFormatException,
            EdalUnsupportedOperationException {
        String timeString = params.getString("time");
        List ret = new ArrayList<>();
        if (timeString != null && !timeString.trim().equals("")) {
            if (styleParameters.getNumLayers() != 1) {
                /*
                 * More than one layer has been requested. This is currently
                 * unsupported.
                 * 
                 * TODO log this
                 */
                return ret;
            }
            VariableMetadata metadata = WmsUtils.getVariableMetadataFromLayerName(
                    styleParameters.getLayerNames()[0], catalogue);
            TemporalDomain temporalDomain = metadata.getTemporalDomain();
            if (!(temporalDomain instanceof TimeAxis)) {
                /*
                 * We currently only support animations for discrete axes. No
                 * need to throw an exception - just don't define any animation
                 * timesteps
                 */
                return ret;
            }
            TimeAxis tAxis = (TimeAxis) temporalDomain;

            String[] timeStrings = timeString.split(",");
            for (String timestepStr : timeStrings) {
                String[] timestepStrings = timestepStr.split("/");

                if (timestepStrings.length == 1) {
                    /*
                     * A single time. Add it to the list of timesteps if it's on
                     * the axis
                     */
                    DateTime time = TimeUtils.iso8601ToDateTime(timestepStrings[0], chronology);
                    if (tAxis.contains(time)) {
                        ret.add(time);
                    }
                } else if (timestepStrings.length == 2) {
                    /*
                     * A time range. Add all times on the time axis within this
                     * range
                     */
                    DateTime startTime = TimeUtils
                            .iso8601ToDateTime(timestepStrings[0], chronology);
                    DateTime endTime = TimeUtils.iso8601ToDateTime(timestepStrings[1], chronology);
                    for (DateTime time : tAxis.getCoordinateValues()) {
                        if ((time.isAfter(startTime) || time.equals(startTime))
                                && (time.isBefore(endTime) || time.equals(endTime))) {
                            ret.add(time);
                        }
                    }
                } else if (timestepStrings.length == 3) {
                    /*
                     * Start, end, period.
                     */
                    DateTime startTime = TimeUtils
                            .iso8601ToDateTime(timestepStrings[0], chronology);
                    DateTime endTime = TimeUtils.iso8601ToDateTime(timestepStrings[1], chronology);

                    int startIndex = tAxis.findIndexOf(startTime);
                    int endIndex = tAxis.findIndexOf(endTime);
                    ret.add(tAxis.getCoordinateValue(startIndex));
                    Period resolution = Period.parse(timestepStrings[2]);
                    for (int i = startIndex + 1; i <= endIndex; i++) {
                        DateTime lastdt = ret.get(ret.size() - 1);
                        DateTime thisdt = tAxis.getCoordinateValue(i);
                        if (!thisdt.isBefore(lastdt.plus(resolution))) {
                            ret.add(thisdt);
                        }
                    }
                } else {
                    throw new BadTimeFormatException(
                            "Time can either be a single value or a range (with an optional period)");
                }
            }
        }
        return ret;
    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy