view artifacts/src/main/java/org/dive4elements/river/artifacts/sinfo/flowdepth/BedQualityD50KmValueFinder.java @ 8917:86395ab8ebc3

SINFO Flowdepth: d50 aggregation by median instead of arithmetic mean
author mschaefer
date Mon, 26 Feb 2018 18:56:05 +0100
parents 37ff7f435912
children
line wrap: on
line source
/* Copyright (C) 2017 by Bundesanstalt für Gewässerkunde
 * Software engineering by
 *  Björnsen Beratende Ingenieure GmbH
 *  Dr. Schumacher Ingenieurbüro für Wasser und Umwelt
 *
 * This file is Free Software under the GNU AGPL (>=v3)
 * and comes with ABSOLUTELY NO WARRANTY! Check out the
 * documentation coming with Dive4Elements River for details.
 */

package org.dive4elements.river.artifacts.sinfo.flowdepth;

import java.util.List;

import org.apache.commons.lang.math.DoubleRange;
import org.apache.commons.math.ArgumentOutsideDomainException;
import org.apache.commons.math.analysis.interpolation.LinearInterpolator;
import org.apache.commons.math.analysis.polynomials.PolynomialSplineFunction;
import org.apache.log4j.Logger;
import org.dive4elements.river.artifacts.math.Utils;
import org.dive4elements.river.artifacts.model.DateRange;
import org.dive4elements.river.backend.SedDBSessionHolder;
import org.dive4elements.river.model.River;
import org.hibernate.SQLQuery;
import org.hibernate.Session;
import org.hibernate.type.StandardBasicTypes;

import gnu.trove.TDoubleArrayList;

/**
 * Searchable sorted km array with parallel bed measurements value array and linear interpolation for km and d50 between the array elements.<br />
 * <br />
 * See comment of SQL command on how the values are filtered and aggregated.
 * 
 * @author Matthias Schäfer
 *
 */
public class BedQualityD50KmValueFinder {

    /***** FIELDS *****/
    
    /**
     * Private log to use here.
     */
    private static Logger log = Logger.getLogger(BedQualityD50KmValueFinder.class);

    /**
     * Query selecting all sub layer bed measurements with their d50 for a km range and a time period<br />
     * <br />
     * A km may have bed measurements for multiple dates, multiple distances from the river bank, and multiple depth layers.
     * The query filters by km range, time period and layer (sub layer: below bed to max. 50 cm depth).<br />
     * 
     * If PostgreSQL would support a median aggregate function like Oracle does the aggregation could be placed into this query.
     */
    private static final String SQL_BED_D50_SUBLAYER_MEASUREMENT =
    "SELECT t.km, t.datum, p.tiefevon, p.tiefebis, a.d50 AS d50"
        + " FROM sohltest t INNER JOIN station s ON t.stationid = s.stationid"
        + "    INNER JOIN gewaesser g ON s.gewaesserid = g.gewaesserid"
        + "    INNER JOIN sohlprobe p ON t.sohltestid = p.sohltestid"
        + "    INNER JOIN siebanalyse a ON p.sohlprobeid = a.sohlprobeid"
        + " WHERE (g.name = :name) AND (s.km BETWEEN :fromkm - 0.0001 AND :tokm + 0.0001)"
        + "    AND (p.tiefevon > 0.0) AND (p.tiefebis <= 0.5)"
        + "    AND (t.datum BETWEEN :fromdate AND :todate)"
        + " ORDER BY t.km ASC, a.d50 ASC";

    /**
     * Real linear interpolator for kms and d50 values (m)
     */
    private PolynomialSplineFunction interpolator;
    
    
    /***** METHODS *****/
    
    /**
     * Returns the d50 value interpolated according to a km
     * @return d50 (m) of the km, or NaN
     */
    public double findD50(double km) throws ArgumentOutsideDomainException {
        return interpolator.value(km);
        /* ohne interpolation:
        if ((kms == null) || (kms.size() == 0))
            return Double.NaN;
        int i = kms.binarySearch(km);
        if (i >= 0)
            return values.get(i);
        i = -i - 1;
        if ((i - 1 >= 0) && Utils.epsilonEquals(km, kms.get(i - 1), 0.0001))
            return values.get(i - 1);
        else if ((i >= 0) && (i <= kms.size() - 1) && Utils.epsilonEquals(km, kms.get(i), 0.0001))
            return values.get(i);
        else
            return Double.NaN; */
    }
    
    /**
     * Loads the range of the river's kms with their associated values.
     * @return Whether the load has been successful
     */
    public boolean loadValues(final River river, final DoubleRange kmRange, final DateRange dateRange) {
        log.debug(String.format("loadValues km %.3f - %.3f %tF - %tF", kmRange.getMinimumDouble(), kmRange.getMaximumDouble(), dateRange.getFrom(), dateRange.getTo()));
        Session session = SedDBSessionHolder.HOLDER.get();
        SQLQuery sqlQuery = session.createSQLQuery(SQL_BED_D50_SUBLAYER_MEASUREMENT)
            .addScalar("km", StandardBasicTypes.DOUBLE)
            .addScalar("datum", StandardBasicTypes.DATE)
            .addScalar("tiefevon", StandardBasicTypes.DOUBLE)
            .addScalar("tiefebis", StandardBasicTypes.DOUBLE)
            .addScalar("d50", StandardBasicTypes.DOUBLE);
        String seddbRiver = river.nameForSeddb();
        sqlQuery.setString("name", seddbRiver);
        sqlQuery.setDouble("fromkm", kmRange.getMinimumDouble());
        sqlQuery.setDouble("tokm", kmRange.getMaximumDouble());
        sqlQuery.setDate("fromdate", dateRange.getFrom());
        sqlQuery.setDate("todate", dateRange.getTo());
        @SuppressWarnings("unchecked")
        final List<Object[]> rows = sqlQuery.list();
        final TDoubleArrayList kms = new TDoubleArrayList();
        final TDoubleArrayList values = new TDoubleArrayList();
        final TDoubleArrayList kmd50s = new TDoubleArrayList();
        for (int i = 0; i <= rows.size() - 1; i++) {
            kmd50s.add((double) rows.get(i)[4]);
            if (((i == rows.size() - 1) || !Utils.epsilonEquals((double) rows.get(i)[0], (double) rows.get(i+1)[0], 0.0001))) {
                int k = kmd50s.size() / 2;
                values.add(((k + k < kmd50s.size()) ? kmd50s.get(k) : (kmd50s.get(k-1) + kmd50s.get(k)) / 2) / 1000);
                kms.add((double) rows.get(i)[0]);
                log.debug(String.format("loadValues km %.3f d50(mm) %.1f count %d", kms.get(kms.size()-1), values.get(values.size()-1), kmd50s.size()));
                kmd50s.clear();
            }
        }
        try {
            interpolator = new LinearInterpolator().interpolate(kms.toNativeArray(), values.toNativeArray());
            return true;
        } catch (Exception e) {
            interpolator = null;
            return false;
        }
    }
}

http://dive4elements.wald.intevation.org