/* * Copyright (C) 2018 Emeric Poupon * * This file is part of LMS. * * LMS is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * LMS is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with LMS. If not, see . */ #include "FeaturesClassifier.hpp" #include #include "database/Artist.hpp" #include "database/Release.hpp" #include "database/Session.hpp" #include "database/Track.hpp" #include "database/TrackFeatures.hpp" #include "database/TrackList.hpp" #include "som/DataNormalizer.hpp" #include "utils/Logger.hpp" #include "utils/Random.hpp" namespace Recommendation { std::unique_ptr createFeaturesClassifier() { return std::make_unique(); } const FeatureSettingsMap& FeaturesClassifier::getDefaultTrainFeatureSettings() { static const FeatureSettingsMap defaultTrainFeatureSettings { { "lowlevel.spectral_energyband_high.mean", {1}}, { "lowlevel.spectral_rolloff.median", {1}}, { "lowlevel.spectral_contrast_valleys.var", {1}}, { "lowlevel.erbbands.mean", {1}}, { "lowlevel.gfcc.mean", {1}}, }; return defaultTrainFeatureSettings; } static std::optional getTrackFeatureValues(FeaturesClassifier::FeaturesFetchFunc func, Database::IdType trackId, const std::unordered_set& featureNames) { return func(trackId, featureNames); } static std::optional getTrackFeatureValuesFromDb(Database::Session& session, Database::IdType trackId, const std::unordered_set& featureNames) { auto func = [&](Database::IdType trackId, const std::unordered_set& featureNames) { std::optional res; auto transaction {session.createSharedTransaction()}; Database::Track::pointer track {Database::Track::getById(session, trackId)}; if (!track) return res; res = track->getTrackFeatures()->getFeatureValuesMap(featureNames); if (res->empty()) res.reset(); return res; }; return getTrackFeatureValues(func, trackId, featureNames); } static std::optional convertFeatureValuesMapToInputVector(const FeatureValuesMap& featureValuesMap, std::size_t nbDimensions) { std::size_t i {}; std::optional res {SOM::InputVector {nbDimensions}}; for (const auto& [featureName, values] : featureValuesMap) { if (values.size() != getFeatureDef(featureName).nbDimensions) { LMS_LOG(RECOMMENDATION, WARNING) << "Dimension mismatch for feature '" << featureName << "'. Expected " << getFeatureDef(featureName).nbDimensions << ", got " << values.size(); res.reset(); break; } for (double val : values) (*res)[i++] = val; } return res; } static SOM::InputVector getInputVectorWeights(const FeatureSettingsMap& featureSettingsMap, std::size_t nbDimensions) { SOM::InputVector weights {nbDimensions}; std::size_t index {}; for (const auto& [featureName, featureSettings] : featureSettingsMap) { const std::size_t featureNbDimensions {getFeatureDef(featureName).nbDimensions}; for (std::size_t i {}; i < featureNbDimensions; ++i) weights[index++] = (1. / featureNbDimensions * featureSettings.weight); } assert(index == nbDimensions); return weights; } bool FeaturesClassifier::loadFromTraining(Database::Session& session, const TrainSettings& trainSettings, const ProgressCallback& progressCallback) { LMS_LOG(RECOMMENDATION, INFO) << "Constructing features classifier..."; std::unordered_set featureNames; std::transform(std::cbegin(trainSettings.featureSettingsMap), std::cend(trainSettings.featureSettingsMap), std::inserter(featureNames, std::begin(featureNames)), [](const auto& itFeatureSetting) { return itFeatureSetting.first; }); const std::size_t nbDimensions {std::accumulate(std::cbegin(featureNames), std::cend(featureNames), std::size_t {0}, [](std::size_t sum, const FeatureName& featureName) { return sum + getFeatureDef(featureName).nbDimensions; })}; LMS_LOG(RECOMMENDATION, DEBUG) << "Features dimension = " << nbDimensions; std::vector trackIds; { auto transaction {session.createSharedTransaction()}; LMS_LOG(RECOMMENDATION, DEBUG) << "Getting Tracks with features..."; trackIds = Database::Track::getAllIdsWithFeatures(session); LMS_LOG(RECOMMENDATION, DEBUG) << "Getting Tracks with features DONE (found " << trackIds.size() << " tracks)"; } std::vector samples; std::vector samplesTrackIds; samples.reserve(trackIds.size()); samplesTrackIds.reserve(trackIds.size()); LMS_LOG(RECOMMENDATION, DEBUG) << "Extracting features..."; for (Database::IdType trackId : trackIds) { if (_loadCancelled) return false; std::optional featureValuesMap; if (_featuresFetchFunc) featureValuesMap = getTrackFeatureValues(_featuresFetchFunc, trackId, featureNames); else featureValuesMap = getTrackFeatureValuesFromDb(session, trackId, featureNames); if (!featureValuesMap) continue; std::optional inputVector {convertFeatureValuesMapToInputVector(*featureValuesMap, nbDimensions)}; if (!inputVector) continue; samples.emplace_back(std::move(*inputVector)); samplesTrackIds.emplace_back(trackId); } LMS_LOG(RECOMMENDATION, DEBUG) << "Extracting features DONE"; if (samples.empty()) { LMS_LOG(RECOMMENDATION, INFO) << "Nothing to classify!"; return false; } LMS_LOG(RECOMMENDATION, DEBUG) << "Normalizing data..."; SOM::DataNormalizer dataNormalizer {nbDimensions}; dataNormalizer.computeNormalizationFactors(samples); for (auto& sample : samples) dataNormalizer.normalizeData(sample); const SOM::Coordinate size {static_cast(std::sqrt(samples.size() / trainSettings.sampleCountPerNeuron))}; LMS_LOG(RECOMMENDATION, INFO) << "Found " << samples.size() << " tracks, constructing a " << size << "*" << size << " network"; SOM::Network network {size, size, nbDimensions}; SOM::InputVector weights {getInputVectorWeights(trainSettings.featureSettingsMap, nbDimensions)}; network.setDataWeights(weights); auto somProgressCallback{[&](const SOM::Network::CurrentIteration& iter) { LMS_LOG(RECOMMENDATION, DEBUG) << "Current pass = " << iter.idIteration << " / " << iter.iterationCount; progressCallback(Progress {iter.idIteration, iter.iterationCount}); }}; LMS_LOG(RECOMMENDATION, DEBUG) << "Training network..."; network.train(samples, trainSettings.iterationCount, progressCallback ? somProgressCallback : SOM::Network::ProgressCallback {}, [this] { return _loadCancelled; }); LMS_LOG(RECOMMENDATION, DEBUG) << "Training network DONE"; if (_loadCancelled) return false; LMS_LOG(RECOMMENDATION, DEBUG) << "Classifying tracks..."; ObjectPositions trackPositions; for (std::size_t i {}; i < samples.size(); ++i) { if (_loadCancelled) return false; const SOM::Position position {network.getClosestRefVectorPosition(samples[i])}; trackPositions[samplesTrackIds[i]].insert(position); } LMS_LOG(RECOMMENDATION, DEBUG) << "Classifying tracks DONE"; return load(session, std::move(network), std::move(trackPositions)); } bool FeaturesClassifier::loadFromCache(Database::Session& session, const FeaturesClassifierCache& cache) { LMS_LOG(RECOMMENDATION, INFO) << "Constructing features classifier from cache..."; return load(session, std::move(cache._network), cache._trackPositions); } std::unordered_set FeaturesClassifier::getSimilarTracksFromTrackList(Database::Session& session, Database::IdType trackListId, std::size_t maxCount) const { const std::unordered_set trackIds {[&] { std::unordered_set res; auto transaction {session.createSharedTransaction()}; const Database::TrackList::pointer trackList {Database::TrackList::getById(session, trackListId)}; if (trackList) { const std::vector orderedTrackIds {trackList->getTrackIds()}; res = std::unordered_set(std::cbegin(orderedTrackIds), std::cend(orderedTrackIds)); } return res; }()}; return getSimilarTracks(session, trackIds, maxCount); } std::unordered_set FeaturesClassifier::getSimilarTracks(Database::Session& session, const std::unordered_set& tracksIds, std::size_t maxCount) const { auto similarTrackIds {getSimilarObjects(tracksIds, _tracksMap, _trackPositions, maxCount)}; if (!similarTrackIds.empty()) { // Report only existing ids auto transaction {session.createSharedTransaction()}; for (auto it {std::begin(similarTrackIds)}; it != std::end(similarTrackIds);) { const Database::IdType trackId {*it}; if (!Database::Track::getById(session, trackId)) it = similarTrackIds.erase(it); else it++; } } return similarTrackIds; } std::unordered_set FeaturesClassifier::getSimilarReleases(Database::Session& session, Database::IdType releaseId, std::size_t maxCount) const { auto similarReleaseIds {getSimilarObjects({releaseId}, _releasesMap, _releasePositions, maxCount)}; if (!similarReleaseIds.empty()) { // Report only existing ids auto transaction {session.createSharedTransaction()}; for (auto it {std::begin(similarReleaseIds)}; it != std::end(similarReleaseIds);) { const Database::IdType releaseId {*it}; if (!Database::Release::getById(session, releaseId)) it = similarReleaseIds.erase(it); else it++; } } return similarReleaseIds; } std::unordered_set FeaturesClassifier::getSimilarArtists(Database::Session& session, Database::IdType artistId, std::size_t maxCount) const { auto similarArtistIds {getSimilarObjects({artistId}, _artistsMap, _artistPositions, maxCount)}; if (!similarArtistIds.empty()) { // Report only existing ids auto transaction {session.createSharedTransaction()}; for (auto it {std::begin(similarArtistIds)}; it != std::end(similarArtistIds);) { const Database::IdType artistId {*it}; if (!Database::Release::getById(session, artistId)) it = similarArtistIds.erase(it); else it++; } } return similarArtistIds; } FeaturesClassifierCache FeaturesClassifier::toCache() const { return FeaturesClassifierCache {*_network, _trackPositions}; } bool FeaturesClassifier::load(Database::Session& session, bool forceReload, const ProgressCallback& progressCallback) { if (forceReload) { FeaturesClassifierCache::invalidate(); } else { const std::optional cache {FeaturesClassifierCache::read()}; if (cache) return loadFromCache(session, *cache); } TrainSettings trainSettings; trainSettings.featureSettingsMap = getDefaultTrainFeatureSettings(); const bool res {loadFromTraining(session, trainSettings, progressCallback)}; if (res) toCache().write(); return res; } void FeaturesClassifier::requestCancelLoad() { LMS_LOG(RECOMMENDATION, DEBUG) << "Requesting init cancellation"; _loadCancelled = true; } bool FeaturesClassifier::load(Database::Session& session, SOM::Network network, const ObjectPositions& tracksPosition) { _networkRefVectorsDistanceMedian = network.computeRefVectorsDistanceMedian(); LMS_LOG(RECOMMENDATION, DEBUG) << "Median distance betweend ref vectors = " << _networkRefVectorsDistanceMedian; const SOM::Coordinate width {network.getWidth()}; const SOM::Coordinate height {network.getHeight()}; _artistsMap = MatrixOfObjects {width, height}; _releasesMap = MatrixOfObjects {width, height}; _tracksMap = MatrixOfObjects {width, height}; LMS_LOG(RECOMMENDATION, DEBUG) << "Constructing maps..."; for (auto itTrackCoord : tracksPosition) { if (_loadCancelled) return false; auto transaction {session.createSharedTransaction()}; Database::IdType trackId {itTrackCoord.first}; const std::unordered_set& positionSet {itTrackCoord.second}; const Database::Track::pointer track {Database::Track::getById(session, trackId)}; if (!track) continue; for (const SOM::Position& position : positionSet) { _tracksMap[position].insert(trackId); _trackPositions[trackId].insert(position); if (track->getRelease()) { _releasePositions[track->getRelease().id()].insert(position); _releasesMap[position].insert(track->getRelease().id()); } for (const auto& artist : track->getArtists()) { _artistPositions[artist.id()].insert(position); _artistsMap[position].insert(artist.id()); } } } _network = std::make_unique(std::move(network)); LMS_LOG(RECOMMENDATION, INFO) << "Classifier successfully loaded!"; return true; } std::unordered_set FeaturesClassifier::getMatchingRefVectorsPosition(const std::unordered_set& ids, const ObjectPositions& objectPositions) { std::unordered_set res; if (ids.empty()) return res; for (auto id : ids) { auto it = objectPositions.find(id); if (it == objectPositions.end()) continue; for (const auto& position : it->second) res.insert(position); } return res; } std::unordered_set FeaturesClassifier::getObjectsIds(const std::unordered_set& positionSet, const MatrixOfObjects& objectsMap) { std::unordered_set res; for (const auto& position : positionSet) { for (auto id : objectsMap.get(position)) res.insert(id); } return res; } std::unordered_set FeaturesClassifier::getSimilarObjects(const std::unordered_set& ids, const MatrixOfObjects& objectsMap, const ObjectPositions& objectPosition, std::size_t maxCount) const { std::unordered_set res; std::unordered_set searchedRefVectorsPosition {getMatchingRefVectorsPosition(ids, objectPosition)}; if (searchedRefVectorsPosition.empty()) return res; while (1) { std::unordered_set closestObjectIds {getObjectsIds(searchedRefVectorsPosition, objectsMap)}; // Remove objects that are already in input or already reported for (auto id : ids) closestObjectIds.erase(id); for (auto it {std::cbegin(closestObjectIds)}; it != std::cend(closestObjectIds); ++it) { if (res.size() == maxCount) break; res.insert(*it); } if (res.size() == maxCount) break; // If there is not enough objects, try again with closest neighbour until there is too much distance const std::optional closestRefVectorPosition {_network->getClosestRefVectorPosition(searchedRefVectorsPosition, _networkRefVectorsDistanceMedian * 0.75)}; if (!closestRefVectorPosition) break; searchedRefVectorsPosition.insert(closestRefVectorPosition.value()); } return res; } } // ns Recommendation