transcription2tex.java

编辑视频文件

/*
 * File:     Transcription2TeX.java
 * Project:  MPI Linguistic Application
 * Date:     02 May 2007
 *
 * Copyright (C) 2001-2007  Max Planck Institute for Psycholinguistics
 *
 * 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 2 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, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

/* 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 2 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, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
package mpi.eudico.client.util;

import mpi.eudico.server.corpora.clom.Annotation;
import mpi.eudico.server.corpora.clom.Transcription;

import mpi.eudico.server.corpora.clomimpl.abstr.TierImpl;

import mpi.eudico.util.TimeRelation;

import java.io.BufferedWriter;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStreamWriter;

import java.util.ArrayList;
import java.util.List;


/**
 * $Id: Transcription2TeX.java,v 1.7 2006/12/06 16:06:07 klasal Exp $
 *
 * export annotation values and their dependencies into a tree, using the
 * LaTeX-pstree format
 *
 * @author $Author: klasal $
 * @version $Revision: 1.7 $
 * @version Aug 2005 Identity removed
 */
public class Transcription2TeX {
    /**
     * Export annotations in tier and annotations in dependent tiers as tree For
     * each tier maximal one direct dependent tier can be selected (otherwise
     * tree structure wouldn't be meaningful)
     *
     * @param transcription
     * @param tierNames
     * @param exportFile
     * @throws IOException
     */
    static public void exportTiers(Transcription transcription,
        String[] tierNames, File exportFile) throws IOException {
        exportTiers(transcription, tierNames, exportFile, 0, Long.MAX_VALUE);
    }

    /**
     * Exports annotations that overlapp with specified time interval
     *
     * @param transcription
     * @param tierNames
     * @param exportFile
     * @param beginTime
     * @param endTime
     * @throws IOException
     */
    static public void exportTiers(Transcription transcription,
        String[] tierNames, File exportFile, long beginTime, long endTime)
        throws IOException {
        if (exportFile == null) {
            return;
        }

        List rootTiers = new ArrayList();

        for (int i = 0; i < tierNames.length; i++) {
            rootTiers.add(transcription.getTierWithId(tierNames[i]));
        }

        if (!hasOnlyLinearDependencies(rootTiers)) {
            throw new IOException("Export.TeX.TierSelectionException");
        }

        removeDependentTiers(rootTiers);

        FileOutputStream out = new FileOutputStream(exportFile);
        BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(out,
                    "UTF-8"));

        writer.write("\\documentclass{article}\n");
        writer.write("\\usepackage{pstricks,pst-node,pst-tree}\n");
        writer.write("\\begin{document}\n");
        writer.write("\\begin{center}\n");

        for (int i = 0; i < rootTiers.size(); i++) {
            writer.write(((TierImpl) rootTiers.get(i)).getName() + "\\\\\n");

            List annotations = ((TierImpl) rootTiers.get(i)).getAnnotations();

            int j = 0;

            while (j < annotations.size()) {
                if (annotations.get(j) instanceof Annotation &&
                        TimeRelation.overlaps((Annotation) annotations.get(j),
                            beginTime, endTime)) {
                    j++;
                } else {
                    annotations.remove(j);
                }
            }

            exportAnnotations(writer, tierNames, annotations, exportFile);
        }

        writer.write("\\end{center}\n");
        writer.write("\\end{document}\n");
        writer.close();
    }

    /**
     * filters all tiers, that have an ancestor in the selected set
     *
     * @param rootTiers
     */
    private static void removeDependentTiers(List rootTiers) {
        TierImpl tier1;
        TierImpl tier2;

        for (int i = 0; i < (rootTiers.size() - 1); i++) {
            tier1 = (TierImpl) rootTiers.get(i);

            for (int j = i + 1; j < rootTiers.size(); j++) {
                tier2 = (TierImpl) rootTiers.get(j);

                if (tier2.hasAncestor(tier1)) {
                    rootTiers.remove(tier2);
                    j--;
                }

                if (tier1.hasAncestor(tier2)) {
                    rootTiers.remove(tier1);
                    j--;
                    i--;
                }
            }
        }
    }

    /**
     * check if each selected tier has maximal one direct child tier
     *
     * @param rootTiers
     * @throws Exception
     */
    private static boolean hasOnlyLinearDependencies(List rootTiers) {
        TierImpl tier1;
        TierImpl tier2;

        for (int i = 0; i < (rootTiers.size() - 1); i++) {
            tier1 = (TierImpl) rootTiers.get(i);

            for (int j = i + 1; j < rootTiers.size(); j++) {
                tier2 = (TierImpl) rootTiers.get(j);

                if ((tier1.getParentTier() == tier2.getParentTier()) &&
                        rootTiers.contains(tier1.getParentTier())) {
                    return false;
                }
            }
        }

        return true;
    }

    /**
     * Exports a List of AnnotationCores to Tab limited text
     *
     * @param annotations
     * @param exportFile
     * @throws IOException
     */
    static private void exportAnnotations(BufferedWriter writer,
        String[] tierNames, List annotations, File exportFile)
        throws IOException {
        if (exportFile == null) {
            return;
        }

        for (int i = 0; i < annotations.size(); i++) {
            if (annotations.get(i) instanceof Annotation) {
                // writer.write("\\pstree[nodesep=2pt,levelsep=20pt]\n");
                writer.write(getTeXTree(tierNames,
                        (Annotation) annotations.get(i)) + "\\\\[5mm]\n");
            }
        }
    }

    /**
     * construcs tex tree for a single annotation (and its dependent
     * annotations)
     *
     * @param tierNames
     *            list of tier names; only children annotations in those tiers
     *            are used
     * @param annotation
     *            "root" or starting annotation (has not to be root in the
     *            complete ACM)
     *
     * @return String contains a tree in LaTeX-pstree format for the given
     *         annotation
     */
    static private String getTeXTree(String[] tierNames, Annotation annotation) {
        StringBuffer sb = new StringBuffer();
        TierImpl tier = (TierImpl) annotation.getTier();
        List childrenTiers = tier.getChildTiers();
        StringBuffer childrenTree = new StringBuffer();

        try {
            for (int k = 0; k < childrenTiers.size(); k++) {
                String childrenTierName = ((TierImpl) childrenTiers.get(k)).getName();

                for (int j = 0; j < tierNames.length; j++) {
                    if (tierNames[j].equals(childrenTierName)) {
                        List children = annotation.getChildrenOnTier((TierImpl) childrenTiers.get(
                                    k));

                        if (children.size() > 0) {
                            for (int i = 0; i < children.size(); i++) {
                                childrenTree.append(getTeXTree(tierNames,
                                        (Annotation) children.get(i)));
                            }
                        }

                        break;
                    }
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }

        String annotationValue = annotation.getValue();

        if ((annotationValue != null) && !annotationValue.equals("")) {
            if (childrenTree.length() > 0) {
                sb.append("\\pstree");
            }

            sb.append("{\\TR{" + annotationValue + "}}\n");

            if (childrenTree.length() > 0) {
                sb.append("{" + childrenTree + "}");
            }
        }

        return sb.toString();
    }
}