001/**
002 * NNretrievalMethod.java
003 * jCOLIBRI2 framework. 
004 * @author Juan A. Recio-Garc�a.
005 * GAIA - Group for Artificial Intelligence Applications
006 * http://gaia.fdi.ucm.es
007 * 03/01/2007
008 */
009package es.ucm.fdi.gaia.jcolibri.method.retrieve.NNretrieval;
010
011import java.util.Collection;
012import java.util.List;
013import java.util.stream.Collectors;
014
015import es.ucm.fdi.gaia.jcolibri.cbrcore.CBRCase;
016import es.ucm.fdi.gaia.jcolibri.cbrcore.CBRQuery;
017import es.ucm.fdi.gaia.jcolibri.method.retrieve.RetrievalResult;
018import es.ucm.fdi.gaia.jcolibri.method.retrieve.NNretrieval.similarity.GlobalSimilarityFunction;
019import es.ucm.fdi.gaia.jcolibri.util.ProgressController;
020
021/**
022 * Performs a Nearest Neighbor numeric scoring comparing attributes. 
023 * It uses global similarity functions to compare compound attributes 
024 * (CaseComponents) and 
025 * local similarity functions to compare simple attributes.
026 * The configuration of this method is stored in the NNConfig object.
027 * @author Juan A. Recio-Garc�a
028 * @version 2.0
029 * @see NNConfig
030 */
031public class NNScoringMethod {
032
033    /**
034    * Performs the NN scoring over a collection of cases comparing them with a query.
035    * This zmethod is configured through the NNConfig object.
036    */
037        public static List<RetrievalResult> evaluateSimilarity(Collection<CBRCase> cases, CBRQuery query, NNConfig simConfig) {
038
039        ProgressController.init(NNScoringMethod.class,"Numeric Similarity Computation", cases.size());
040
041        GlobalSimilarityFunction gsf = simConfig.getDescriptionSimFunction();
042
043        // Parallel stream
044            List<RetrievalResult> res = cases.parallelStream()
045                .map(c -> new RetrievalResult(c, gsf.compute(c.getDescription(), query.getDescription(), c, query, simConfig)))
046                .collect(Collectors.toList());
047
048            // Sort the result
049        res.sort(RetrievalResult::compareTo);
050
051        ProgressController.finish(NNScoringMethod.class);
052
053                return res;
054        }
055}