sample_set.cpp

Go to the documentation of this file.

/*
    Genesis - A toolkit for working with phylogenetic data.
    Copyright (C) 2014-2018 Lucas Czech and HITS gGmbH

    This program 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.

    This program 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 this program.  If not, see <http://www.gnu.org/licenses/>.

    Contact:
    Lucas Czech <lucas.czech@h-its.org>
    Exelixis Lab, Heidelberg Institute for Theoretical Studies
    Schloss-Wolfsbrunnenweg 35, D-69118 Heidelberg, Germany
*/

#include "genesis/placement/function/sample_set.hpp"

#include "genesis/placement/function/functions.hpp"
#include "genesis/placement/function/operators.hpp"
#include "genesis/tree/default/functions.hpp"
#include "genesis/tree/function/tree_set.hpp"
#include "genesis/tree/tree_set.hpp"

#include <ostream>

namespace genesis {
namespace placement {

// =================================================================================================
//     Sample Set Functions
// =================================================================================================

Sample* find_sample( SampleSet& sample_set, std::string const& name )
{
    for (auto& nsmp : sample_set) {
        if( nsmp.name == name ) {
            return &nsmp.sample;
        }
    }
    return nullptr;
}

Sample const* find_sample( SampleSet const& sample_set, std::string const& name )
{
    for (auto& nsmp : sample_set) {
        if( nsmp.name == name ) {
            return &nsmp.sample;
        }
    }
    return nullptr;
}

Sample merge_all( SampleSet const& sample_set )
{
    // The following operations do a lot of traversals on all trees: first some for the
    // average_branch_length_tree, then for the merging again. This could be turned into
    // less traversals by copying code and doing all in one run. However, at the current point, this
    // method will be called once in the beginning of a program run, and thus it is not necessary to
    // optimize for speed. Instead, we opt for clean, separated and easy code here.

    if( sample_set.size() == 0 ) {
        return Sample();
    }

    // Create a new Sample and initialize it with the average branch length tree of all
    // maps in this set, but without any placements.
    auto res = Sample( average_branch_length_tree( sample_set ));

    // Copy the rest of the data from the first tree to the averaged tree.
    // This is necessary, because the tree copy constructor does not do this for us.
    // TODO fix this!
    for (size_t i = 0; i < res.tree().node_count(); ++i) {
        res.tree().node_at(i).data<PlacementNodeData>().name
            = sample_set[0].sample.tree().node_at(i).data<PlacementNodeData>().name;
    }
    for (size_t i = 0; i < res.tree().edge_count(); ++i) {
        res.tree().edge_at(i).data<PlacementEdgeData>().reset_edge_num(
            sample_set[0].sample.tree().edge_at(i).data<PlacementEdgeData>().edge_num()
        );
    }

    // Add the placements from all maps of this set.
    // In the merge method, we also check for identical topology (again), but mainly for identical
    // taxa names and edge_nums, which is important for correct merging.
    for (auto& smp : sample_set) {
        copy_pqueries( smp.sample, res );
    }

    return res;
}

size_t total_pquery_count( SampleSet const& sample_set )
{
    size_t s = 0;
    for( auto const& sample : sample_set ) {
        s += sample.sample.size();
    }
    return s;
}

// =================================================================================================
//     Tree Functions
// =================================================================================================

tree::Tree average_branch_length_tree( SampleSet const& sample_set )
{
    return average_branch_length_tree( tree_set( sample_set ));
}

bool all_identical_trees( SampleSet const& sample_set )
{
    auto node_comparator = [] (
        PlacementTreeNode const& node_l,
        PlacementTreeNode const& node_r
    ) {
        auto l_ptr = dynamic_cast< PlacementNodeData const* >( node_l.data_ptr() );
        auto r_ptr = dynamic_cast< PlacementNodeData const* >( node_r.data_ptr() );
        if( l_ptr == nullptr || r_ptr == nullptr ) {
            return false;
        }
        return l_ptr->name    == r_ptr->name &&
               node_l.index() == node_r.index();
    };

    auto edge_comparator = [] (
        PlacementTreeEdge const& edge_l,
        PlacementTreeEdge const& edge_r
    ) {
        auto l_ptr = dynamic_cast< PlacementEdgeData const* >( edge_l.data_ptr() );
        auto r_ptr = dynamic_cast< PlacementEdgeData const* >( edge_r.data_ptr() );
        if( l_ptr == nullptr || r_ptr == nullptr ) {
            return false;
        }
        return l_ptr->edge_num()               == r_ptr->edge_num()               &&
               edge_l.primary_node().index()   == edge_r.primary_node().index()   &&
               edge_l.secondary_node().index() == edge_r.secondary_node().index();
    };

    return all_equal( tree_set( sample_set ), node_comparator, edge_comparator );
}

tree::TreeSet tree_set( SampleSet const& sample_set )
{
    tree::TreeSet tset;
    for( auto const& smp : sample_set ) {
        tset.add( smp.name, smp.sample.tree() );
    }
    return tset;
}

void adjust_branch_lengths( SampleSet& sample_set, tree::Tree const& source )
{
    for( auto& smp : sample_set ) {
        adjust_branch_lengths( smp.sample, source );
    }
}

void adjust_to_average_branch_lengths( SampleSet& sample_set )
{
    adjust_branch_lengths( sample_set, average_branch_length_tree( sample_set ));
}

// =================================================================================================
//     Output
// =================================================================================================

std::ostream& operator << ( std::ostream& out, SampleSet const& sample_set )
{
    // TODO this was meant for full output. turn it into a printer instead!
    bool full = false;

    size_t i = 0;
    for( auto const& cm : sample_set ) {
        out << std::to_string(i) << ": " << cm.name << "\n";
        if (full) {
            out << cm.sample << "\n";
        }
        ++i;
    }
    return out;
}

} // namespace placement
} // namespace genesis