/** * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.apache.mahout.classifier.df.tools; import java.lang.reflect.Method; import java.util.List; import org.apache.commons.cli2.CommandLine; import org.apache.commons.cli2.Group; import org.apache.commons.cli2.Option; import org.apache.commons.cli2.builder.ArgumentBuilder; import org.apache.commons.cli2.builder.DefaultOptionBuilder; import org.apache.commons.cli2.builder.GroupBuilder; import org.apache.commons.cli2.commandline.Parser; import org.apache.hadoop.conf.Configuration; import org.apache.hadoop.fs.Path; import org.apache.mahout.classifier.df.DecisionForest; import org.apache.mahout.classifier.df.data.Dataset; import org.apache.mahout.classifier.df.node.Node; import org.apache.mahout.common.CommandLineUtil; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * This tool is to visualize the Decision Forest */ public final class ForestVisualizer { private static final Logger log = LoggerFactory.getLogger(ForestVisualizer.class); private ForestVisualizer() { } public static String toString(DecisionForest forest, Dataset dataset, String[] attrNames) throws Exception { Method getTrees = forest.getClass().getDeclaredMethod("getTrees"); getTrees.setAccessible(true); @SuppressWarnings("unchecked") List<Node> trees = (List<Node>) getTrees.invoke(forest); int cnt = 1; StringBuilder buff = new StringBuilder(); for (Node tree : trees) { buff.append("Tree[" + cnt + "]:"); buff.append(TreeVisualizer.toString(tree, dataset, attrNames)); buff.append('\n'); cnt++; } return buff.toString(); } /** * Decision Forest to String * @param forestPath * path to the Decision Forest * @param datasetPath * dataset path * @param attrNames * attribute names */ public static String toString(String forestPath, String datasetPath, String[] attrNames) throws Exception { Configuration conf = new Configuration(); DecisionForest forest = DecisionForest.load(conf, new Path(forestPath)); Dataset dataset = Dataset.load(conf, new Path(datasetPath)); return toString(forest, dataset, attrNames); } /** * Print Decision Forest * @param forestPath * path to the Decision Forest * @param datasetPath * dataset path * @param attrNames * attribute names */ public static void print(String forestPath, String datasetPath, String[] attrNames) throws Exception { System.out.println(toString(forestPath, datasetPath, attrNames)); } public static void main(String[] args) { DefaultOptionBuilder obuilder = new DefaultOptionBuilder(); ArgumentBuilder abuilder = new ArgumentBuilder(); GroupBuilder gbuilder = new GroupBuilder(); Option datasetOpt = obuilder.withLongName("dataset").withShortName("ds").withRequired(true) .withArgument(abuilder.withName("dataset").withMinimum(1).withMaximum(1).create()) .withDescription("Dataset path").create(); Option modelOpt = obuilder.withLongName("model").withShortName("m").withRequired(true) .withArgument(abuilder.withName("path").withMinimum(1).withMaximum(1).create()) .withDescription("Path to the Decision Forest").create(); Option attrNamesOpt = obuilder.withLongName("names").withShortName("n").withRequired(false) .withArgument(abuilder.withName("names").withMinimum(1).create()) .withDescription("Optional, Attribute names").create(); Option helpOpt = obuilder.withLongName("help").withShortName("h") .withDescription("Print out help").create(); Group group = gbuilder.withName("Options").withOption(datasetOpt).withOption(modelOpt) .withOption(attrNamesOpt).withOption(helpOpt).create(); try { Parser parser = new Parser(); parser.setGroup(group); CommandLine cmdLine = parser.parse(args); if (cmdLine.hasOption("help")) { CommandLineUtil.printHelp(group); return; } String datasetName = cmdLine.getValue(datasetOpt).toString(); String modelName = cmdLine.getValue(modelOpt).toString(); String[] attrNames = null; if (cmdLine.hasOption(attrNamesOpt)) { List<String> names = (List<String>) cmdLine.getValues(attrNamesOpt); if (!names.isEmpty()) { attrNames = new String[names.size()]; names.toArray(attrNames); } } print(modelName, datasetName, attrNames); } catch (Exception e) { log.error("Exception", e); CommandLineUtil.printHelp(group); } } }