inprogress
[jalview.git] / forester / java / src / org / forester / archaeopteryx / Configuration.java
1 // $Id:
2 // FORESTER -- software libraries and applications
3 // for evolutionary biology research and applications.
4 //
5 // Copyright (C) 2008-2009 Christian M. Zmasek
6 // Copyright (C) 2008-2009 Burnham Institute for Medical Research
7 // Copyright (C) 2000-2001 Washington University School of Medicine
8 // and Howard Hughes Medical Institute
9 // Copyright (C) 2003-2007 Ethalinda K.S. Cannon
10 // All rights reserved
11 //
12 // This library is free software; you can redistribute it and/or
13 // modify it under the terms of the GNU Lesser General Public
14 // License as published by the Free Software Foundation; either
15 // version 2.1 of the License, or (at your option) any later version.
16 //
17 // This library is distributed in the hope that it will be useful,
18 // but WITHOUT ANY WARRANTY; without even the implied warranty of
19 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 // Lesser General Public License for more details.
21 //
22 // You should have received a copy of the GNU Lesser General Public
23 // License along with this library; if not, write to the Free Software
24 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
25 //
26 // Contact: phylosoft @ gmail . com
27 // WWW: https://sites.google.com/site/cmzmasek/home/software/forester
28
29 package org.forester.archaeopteryx;
30
31 import java.awt.Color;
32 import java.io.BufferedReader;
33 import java.io.File;
34 import java.io.FileReader;
35 import java.io.IOException;
36 import java.io.InputStreamReader;
37 import java.net.URL;
38 import java.util.Arrays;
39 import java.util.Hashtable;
40 import java.util.Map;
41 import java.util.SortedMap;
42 import java.util.StringTokenizer;
43 import java.util.TreeMap;
44
45 import org.forester.archaeopteryx.Options.CLADOGRAM_TYPE;
46 import org.forester.archaeopteryx.Options.NODE_LABEL_DIRECTION;
47 import org.forester.archaeopteryx.Options.OVERVIEW_PLACEMENT_TYPE;
48 import org.forester.archaeopteryx.Options.PHYLOGENY_GRAPHICS_TYPE;
49 import org.forester.io.parsers.nhx.NHXParser.TAXONOMY_EXTRACTION;
50 import org.forester.phylogeny.data.NodeData.NODE_DATA;
51 import org.forester.phylogeny.data.NodeVisualization;
52 import org.forester.phylogeny.data.NodeVisualization.NodeFill;
53 import org.forester.phylogeny.data.NodeVisualization.NodeShape;
54 import org.forester.util.ForesterUtil;
55
56 public final class Configuration {
57
58     final static int                        add_new_node                                           = 14;
59     final static int                        blast                                                  = 9;
60     final static String                     clickto_options[][]                                    = {
61             { "Display Node Data", "display" }, { "Collapse/Uncollapse", "display" }, { "Root/Reroot", "display" },
62             { "Sub/Super Tree", "display" }, { "Swap Descendants", "display" },
63             { "Colorize Subtree/Node(s)", "display" }, { "Open Sequence DB", "display" }, { "Open PDB", "display" },
64             { "Open Taxonomy DB", "display" }, { "Blast", "display" }, { "Cut Subtree", "display" },
65             { "Copy Subtree", "display" }, { "Paste Subtree", "display" }, { "Delete Subtree/Node", "display" },
66             { "Add New Node", "display" }, { "Edit Node Data", "display" }, { "Sort Descendants", "display" },
67             { "Return", "display" }, { "Select Node(s)", "display" }                              };
68     final static int                        collapse_uncollapse                                    = 1;
69     final static int                        color_according_to_annotation                          = 19;
70     final static int                        color_according_to_species                             = 6;
71     final static int                        color_branches                                         = 7;
72     final static int                        color_subtree                                          = 5;
73     final static int                        copy_subtree                                           = 11;
74     final static int                        cut_subtree                                            = 10;
75     final static int                        delete_subtree_or_node                                 = 13;
76     final static int                        display_as_phylogram                                   = 0;
77     final static int                        display_internal_data                                  = 15;
78     // ------------------
79     // Click-to options
80     // ------------------
81     final static int                        display_node_data                                      = 0;
82     final static String                     display_options[][]                                    = {
83             { "Phylogram", "display", "?" }, { "Node Name", "display", "yes" }, { "Taxonomy Code", "display", "yes" },
84             { "Seq Annotations", "nodisplay", "no" }, { "Confidence Values", "display", "?" },
85             { "Node Events", "display", "?" }, { "Colorize by Taxonomy", "display", "no" },
86             { "Use Branch Colors", "display", "no" }, { "Use Branch Widths", "display", "no" },
87             { "Show Custom Nodes", "display", "yes" }, { "Protein Domains", "nodisplay", "no" },
88             { "Binary Characters", "nodisplay", "no" }, { "Binary Char Counts", "nodisplay", "no" },
89             { "Seq Name", "display", "yes" }, { "Seq Accession", "display", "no" },
90             { "Show Internal Data", "display", "yes" }, { "Dyna Hide", "display", "yes" },
91             { "Taxonomy Scientific", "display", "yes" }, { "Taxonomy Common", "display", "no" },
92             { "Colorize by Annotation", "nodisplay", "no" }, { "Seq Symbol", "display", "yes" },
93             { "Rollover", "display", "yes" }, { "Relation Confidence", "nodisplay", "no" },
94             { "Vector Data", "nodisplay", "no" }, { "Taxonomy Images", "display", "no" },
95             { "Properties", "nodisplay", "no" }, { "Gene Name", "display", "yes" }                };
96     final static int                        dynamically_hide_data                                  = 16;
97     final static int                        edit_node_data                                         = 15;
98     final static int                        get_ext_desc_data                                      = 17;
99     final static int                        node_data_popup                                        = 21;
100     final static int                        open_pdb_web                                           = 7;
101     final static int                        open_seq_web                                           = 6;
102     final static int                        open_tax_web                                           = 8;
103     final static int                        paste_subtree                                          = 12;
104     final static int                        reroot                                                 = 2;
105     final static int                        select_nodes                                           = 18;
106     final static int                        show_annotation                                        = 3;
107     final static int                        show_binary_character_counts                           = 12;
108     final static int                        show_binary_characters                                 = 11;
109     final static int                        show_custom_node_shapes                                = 9;
110     final static int                        show_domain_architectures                              = 10;
111     final static int                        show_gene_names                                        = 26;
112     final static int                        show_node_names                                        = 1;
113     final static int                        show_properties                                        = 25;
114     final static int                        show_relation_confidence                               = 22;
115     final static int                        show_seq_names                                         = 13;
116     final static int                        show_seq_symbols                                       = 20;
117     final static int                        show_sequence_acc                                      = 14;
118     final static int                        show_tax_code                                          = 2;
119     final static int                        show_taxonomy_common_names                             = 18;
120     final static int                        show_taxonomy_images                                   = 24;
121     final static int                        show_taxonomy_scientific_names                         = 17;
122     final static int                        show_vector_data                                       = 23;
123     final static int                        sort_descendents                                       = 16;
124     final static int                        subtree                                                = 3;
125     final static int                        swap                                                   = 4;
126     static final String                     VALIDATE_AGAINST_PHYLOXML_XSD_SCHEMA                   = "validate_against_phyloxml_xsd_schema";
127     final static int                        width_branches                                         = 8;
128     final static int                        write_confidence_values                                = 4;
129     final static int                        write_events                                           = 5;
130     // ----------------
131     // Function colors
132     // ----------------
133     private static Hashtable<String, Color> _annotation_colors;
134     // ----------------
135     // Domain colors
136     // ----------------
137     private static Hashtable<String, Color> _domain_colors;
138     // ----------------
139     // Species colors
140     // ----------------
141     private static Hashtable<String, Color> _species_colors;
142     private static String                   DEFAULT_FONT_FAMILY                                    = "";
143     private static final int                DEPRECATED                                             = -2;
144     private static final String             DISPLAY_COLOR_KEY                                      = "display_color";
145     // ---------------------------
146     // Display options for trees
147     // ---------------------------
148     // ---------------------------------
149     // Pertaining to the config itself
150     // ---------------------------------
151     // Full path to config (may be URL)
152     String                                  config_filename;
153     // This option is selected in the dropdown
154     int                                     default_clickto                                        = Configuration.display_node_data;
155     String                                  default_config_filename                                = Constants.DEFAULT_CONFIGURATION_FILE_NAME;
156     // --------------
157     // Color set
158     // --------------
159     TreeColorSet                            tree_color_set;
160     // -------
161     // Fonts
162     // -------
163     TreeFontSet                             tree_font_set;
164     boolean                                 verbose                                                = Constants.VERBOSE_DEFAULT;
165     private boolean                         _abbreviate_scientific_names                           = false;
166     private boolean                         _antialias_screen                                      = true;
167     private boolean                         _background_color_gradient                             = false;
168     private String                          _base_font_family_name                                 = "";
169     private int                             _base_font_size                                        = -1;
170     private CLADOGRAM_TYPE                  _cladogram_type                                        = Constants.CLADOGRAM_TYPE_DEFAULT;
171     private boolean                         _color_labels_same_as_parent_branch                    = false;
172     private int                             _default_bootstrap_samples                             = -1;
173     private NodeFill                        _default_node_fill                                     = NodeFill.SOLID;
174     private NodeShape                       _default_node_shape                                    = NodeShape.RECTANGLE;
175     private short                           _default_node_shape_size                               = Constants.DEFAULT_NODE_SHAPE_SIZE_DEFAULT;
176     private SortedMap<String, Color>        _display_colors                                        = null;
177     private boolean                         _display_sequence_relations                            = false;
178     private Color                           _domain_structure_base_color                           = Constants.DOMAIN_STRUCTURE_BASE_COLOR_DEFAULT;
179     private Color                           _domain_structure_font_color                           = Constants.DOMAIN_STRUCTURE_FONT_COLOR_DEFAULT;
180     private boolean                         _editable                                              = true;
181     private NODE_DATA                       _ext_desc_data_to_return                               = NODE_DATA.UNKNOWN;
182     private EXT_NODE_DATA_RETURN_ON         _ext_node_data_return_on                               = EXT_NODE_DATA_RETURN_ON.WINODW;
183     private int                             _frame_x_size;
184     private int                             _frame_y_size;
185     private int                             _graphics_export_x                                     = -1;
186     private int                             _graphics_export_y                                     = -1;
187     private Color                           _gui_background_color                                  = Constants.GUI_BACKGROUND_DEFAULT;
188     private Color                           _gui_button_background_color                           = Constants.BUTTON_BACKGROUND_COLOR_DEFAULT;
189     private Color                           _gui_button_border_color                               = Constants.BUTTON_BORDER_COLOR_DEFAULT;
190     private Color                           _gui_button_text_color                                 = Constants.BUTTON_TEXT_COLOR_DEFAULT;
191     private Color                           _gui_checkbox_and_button_active_color                  = Constants.CHECKBOX_AND_BUTTON_ACTIVE_COLOR_DEFAULT;
192     private Color                           _gui_checkbox_text_color                               = Constants.CHECKBOX_TEXT_COLOR_DEFAULT;
193     private Color                           _gui_menu_background_color                             = Constants.MENU_BACKGROUND_COLOR_DEFAULT;
194     private Color                           _gui_menu_text_color                                   = Constants.MENU_TEXT_COLOR_DEFAULT;
195     private boolean                         _hide_controls_and_menus                               = false;
196     private boolean                         _internal_number_are_confidence_for_nh_parsing         = false;
197     private String                          _label_for_get_ext_descendents_data                    = "";
198     private int                             _max_base_font_size                                    = 20;
199     private boolean                         _midpoint_root                                         = false;
200     private int                             _min_base_font_size                                    = 2;
201     private double                          _min_confidence_value                                  = Options.MIN_CONFIDENCE_DEFAULT;
202     private boolean                         _nh_parsing_replace_underscores                        = false;
203     private NODE_LABEL_DIRECTION            _node_label_direction                                  = NODE_LABEL_DIRECTION.HORIZONTAL;
204     private short                           _number_of_digits_after_comma_for_branch_length_values = Constants.NUMBER_OF_DIGITS_AFTER_COMMA_FOR_BRANCH_LENGTH_VALUES_DEFAULT;
205     private short                           _number_of_digits_after_comma_for_confidence_values    = Constants.NUMBER_OF_DIGITS_AFTER_COMMA_FOR_CONFIDENCE_VALUES_DEFAULT;
206     private short                           _ov_max_height                                         = 80;
207     private short                           _ov_max_width                                          = 80;
208     private OVERVIEW_PLACEMENT_TYPE         _ov_placement                                          = OVERVIEW_PLACEMENT_TYPE.UPPER_LEFT;
209     private File                            _path_to_local_fastme                                  = null;
210     private File                            _path_to_local_mafft                                   = null;
211     private File                            _path_to_local_raxml                                   = null;
212     private PHYLOGENY_GRAPHICS_TYPE         _phylogeny_graphics_type                               = PHYLOGENY_GRAPHICS_TYPE.RECTANGULAR;
213     private float                           _print_line_width                                      = Constants.PDF_LINE_WIDTH_DEFAULT;
214     private boolean                         _show_annotation_ref_source                            = true;
215     private boolean                         _show_branch_length_values                             = false;
216     private boolean                         _show_default_node_shapes_external                     = false;
217     private boolean                         _show_default_node_shapes_internal                     = false;
218     private boolean                         _show_domain_labels                                    = true;
219     private boolean                         _show_overview                                         = true;
220     private boolean                         _show_scale                                            = false;
221     private TAXONOMY_EXTRACTION             _taxonomy_extraction                                   = TAXONOMY_EXTRACTION.NO;
222     private UI                              _ui                                                    = UI.UNKNOWN;
223     private boolean                         _use_tabbed_display                                    = false;
224     private boolean                         _validate_against_phyloxml_xsd_schema                  = Constants.VALIDATE_AGAINST_PHYLOXML_XSD_SCJEMA_DEFAULT;
225     static {
226         for( final String font_name : Constants.DEFAULT_FONT_CHOICES ) {
227             if ( Arrays.binarySearch( AptxUtil.getAvailableFontFamiliesSorted(), font_name ) >= 0 ) {
228                 DEFAULT_FONT_FAMILY = font_name;
229                 break;
230             }
231         }
232         if ( ForesterUtil.isEmpty( DEFAULT_FONT_FAMILY ) ) {
233             DEFAULT_FONT_FAMILY = Constants.DEFAULT_FONT_CHOICES[ Constants.DEFAULT_FONT_CHOICES.length - 1 ];
234         }
235     }
236
237     public Configuration() {
238         this( null, false, false, false );
239     }
240
241     public Configuration( final String cf, final boolean is_url, final boolean is_applet, final boolean verbose ) {
242         if ( ForesterUtil.isEmpty( cf ) ) {
243             config_filename = default_config_filename;
244         }
245         else {
246             config_filename = cf;
247         }
248         setDisplayColors( new TreeMap<String, Color>() );
249         config_filename = config_filename.trim();
250         URL u = null;
251         if ( is_url ) {
252             // If URL, open accordingly
253             try {
254                 u = new URL( config_filename );
255                 try {
256                     final InputStreamReader isr = new InputStreamReader( u.openStream() );
257                     final BufferedReader bf = new BufferedReader( isr );
258                     readConfig( bf );
259                     bf.close();
260                     ForesterUtil.programMessage( Constants.PRG_NAME, "successfully read from configuration url ["
261                             + config_filename + "]" );
262                 }
263                 catch ( final Exception e ) {
264                     ForesterUtil.printWarningMessage( Constants.PRG_NAME, "failed to read configuration from ["
265                             + config_filename + "]: " + e.getLocalizedMessage() );
266                 }
267             }
268             catch ( final Exception e ) {
269                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "cannot find or open configuration url ["
270                         + config_filename + "]" );
271             }
272         }
273         else {
274             // Otherwise, open as a file
275             File f = new File( config_filename );
276             if ( !f.exists() ) {
277                 f = new File( config_filename + ".txt" );
278             }
279             if ( f.exists() && f.canRead() ) {
280                 try {
281                     final BufferedReader bf = new BufferedReader( new FileReader( f ) );
282                     readConfig( bf );
283                     bf.close();
284                 }
285                 catch ( final Exception e ) {
286                     if ( verbose ) {
287                         ForesterUtil.printWarningMessage( Constants.PRG_NAME, "failed to read configuration from ["
288                                 + config_filename + "]: " + e );
289                     }
290                 }
291             }
292             else {
293                 if ( verbose ) {
294                     ForesterUtil.printWarningMessage( Constants.PRG_NAME, "cannot find or open configuration file ["
295                             + config_filename + "]" );
296                 }
297             }
298         }
299     }
300
301     public String getBaseFontFamilyName() {
302         return _base_font_family_name;
303     }
304
305     public int getDefaultBootstrapSamples() {
306         return _default_bootstrap_samples;
307     }
308
309     public NodeFill getDefaultNodeFill() {
310         return _default_node_fill;
311     }
312
313     public NodeShape getDefaultNodeShape() {
314         return _default_node_shape;
315     }
316
317     public short getDefaultNodeShapeSize() {
318         return _default_node_shape_size;
319     }
320
321     public Color getDomainStructureBaseColor() {
322         return _domain_structure_base_color;
323     }
324
325     public Color getDomainStructureFontColor() {
326         return _domain_structure_font_color;
327     }
328
329     public NODE_DATA getExtDescNodeDataToReturn() {
330         return _ext_desc_data_to_return;
331     }
332
333     public EXT_NODE_DATA_RETURN_ON getExtNodeDataReturnOn() {
334         return _ext_node_data_return_on;
335     }
336
337     public int getFrameXSize() {
338         return _frame_x_size;
339     }
340
341     public int getFrameYSize() {
342         return _frame_y_size;
343     }
344
345     public String getLabelForGetExtDescendentsData() {
346         return _label_for_get_ext_descendents_data;
347     }
348
349     public File getPathToLocalFastme() {
350         return _path_to_local_fastme;
351     }
352
353     public File getpathToLocalMafft() {
354         return _path_to_local_mafft;
355     }
356
357     public File getPathToLocalRaxml() {
358         return _path_to_local_raxml;
359     }
360
361     public boolean isAbbreviateScientificTaxonNames() {
362         return _abbreviate_scientific_names;
363     }
364
365     public boolean isBackgroundColorGradient() {
366         return _background_color_gradient;
367     }
368
369     public boolean isColorByTaxonomicGroup() {
370         return false;
371     }
372
373     public boolean isColorLabelsSameAsParentBranch() {
374         return _color_labels_same_as_parent_branch;
375     }
376
377     public boolean isMidpointReroot() {
378         return _midpoint_root;
379     }
380
381     public boolean isShowAnnotationRefSource() {
382         return _show_annotation_ref_source;
383     }
384
385     public boolean isShowDefaultNodeShapesExternal() {
386         return _show_default_node_shapes_external;
387     }
388
389     public boolean isShowDefaultNodeShapesInternal() {
390         return _show_default_node_shapes_internal;
391     }
392
393     public boolean isShowDomainLabels() {
394         return _show_domain_labels;
395     }
396
397     public void putDisplayColors( final String key, final Color color ) {
398         getDisplayColors().put( key, color );
399     }
400
401     public void setAbbreviateScientificTaxonNames( final boolean abbreviate_scientific_names ) {
402         _abbreviate_scientific_names = abbreviate_scientific_names;
403     }
404
405     public void setBackgroundColorGradient( final boolean background_color_gradient ) {
406         _background_color_gradient = background_color_gradient;
407     }
408
409     public void setBaseFontFamilyName( final String base_font_family_name ) {
410         _base_font_family_name = base_font_family_name;
411     }
412
413     public void setBaseFontSize( final int base_font_size ) {
414         _base_font_size = base_font_size;
415     }
416
417     public void setColorizeBranches( final boolean b ) {
418         display_options[ color_branches ][ 2 ] = b ? "yes" : "no";
419     }
420
421     public void setColorLabelsSameAsParentBranch( final boolean color_labels_same_as_parent_branch ) {
422         _color_labels_same_as_parent_branch = color_labels_same_as_parent_branch;
423     }
424
425     public void setDefaultNodeFill( final NodeFill default_node_fill ) {
426         _default_node_fill = default_node_fill;
427     }
428
429     public void setDefaultNodeShape( final NodeShape default_node_shape ) {
430         _default_node_shape = default_node_shape;
431     }
432
433     public void setDefaultNodeShapeSize( final short default_node_shape_size ) {
434         _default_node_shape_size = default_node_shape_size;
435     }
436
437     public void setDisplayAsPhylogram( final boolean b ) {
438         display_options[ display_as_phylogram ][ 2 ] = b ? "yes" : "no";
439     }
440
441     public void setDisplayColors( final SortedMap<String, Color> display_colors ) {
442         _display_colors = display_colors;
443     }
444
445     public void setDisplayConfidenceValues( final boolean b ) {
446         display_options[ write_confidence_values ][ 2 ] = b ? "yes" : "no";
447     }
448
449     public void setDisplayInternalData( final boolean b ) {
450         display_options[ display_internal_data ][ 2 ] = b ? "yes" : "no";
451     }
452
453     public void setDisplayNodeNames( final boolean b ) {
454         display_options[ show_node_names ][ 2 ] = b ? "yes" : "no";
455     }
456
457     public void setDisplaySequenceAcc( final boolean b ) {
458         display_options[ show_sequence_acc ][ 2 ] = b ? "yes" : "no";
459     }
460
461     public void setDisplaySequenceNames( final boolean b ) {
462         display_options[ show_seq_names ][ 2 ] = b ? "yes" : "no";
463     }
464
465     public void setDisplaySequenceRelations( final boolean display_sequence_relations ) {
466         _display_sequence_relations = display_sequence_relations;
467     }
468
469     public void setDisplaySequenceSymbols( final boolean b ) {
470         display_options[ show_seq_symbols ][ 2 ] = b ? "yes" : "no";
471     }
472
473     public void setDisplayTaxonomyCode( final boolean b ) {
474         display_options[ show_tax_code ][ 2 ] = b ? "yes" : "no";
475     }
476
477     public void setDisplayTaxonomyCommonNames( final boolean b ) {
478         display_options[ show_taxonomy_common_names ][ 2 ] = b ? "yes" : "no";
479     }
480
481     public void setDisplayTaxonomyImages( final boolean b ) {
482         display_options[ show_taxonomy_images ][ 2 ] = b ? "yes" : "no";
483     }
484
485     public void setDisplayTaxonomyScientificNames( final boolean b ) {
486         display_options[ show_taxonomy_scientific_names ][ 2 ] = b ? "yes" : "no";
487     }
488
489     public void setDynamicallyHideData( final boolean b ) {
490         display_options[ dynamically_hide_data ][ 2 ] = b ? "yes" : "no";
491     }
492
493     public void setExtDescNodeDataToReturn( final NODE_DATA ext_desc_data_to_return ) {
494         _ext_desc_data_to_return = ext_desc_data_to_return;
495     }
496
497     public void setFrameXSize( final int frame_x_size ) {
498         _frame_x_size = frame_x_size;
499     }
500
501     public void setFrameYSize( final int frame_y_size ) {
502         _frame_y_size = frame_y_size;
503     }
504
505     public void setMidpointReroot( final boolean midpoint_root ) {
506         _midpoint_root = midpoint_root;
507     }
508
509     public void setMinConfidenceValue( final double min_confidence_value ) {
510         _min_confidence_value = min_confidence_value;
511     }
512
513     public void setNodeLabelDirection( final NODE_LABEL_DIRECTION node_label_direction ) {
514         _node_label_direction = node_label_direction;
515     }
516
517     public void setNumberOfDigitsAfterCommaForBranchLengthValue( final short number_of_digits_after_comma_for_branch_length_values ) {
518         _number_of_digits_after_comma_for_branch_length_values = number_of_digits_after_comma_for_branch_length_values;
519     }
520
521     public void setNumberOfDigitsAfterCommaForConfidenceValues( final short number_of_digits_after_comma_for_confidence_values ) {
522         _number_of_digits_after_comma_for_confidence_values = number_of_digits_after_comma_for_confidence_values;
523     }
524
525     public void setPhylogenyGraphicsType( final PHYLOGENY_GRAPHICS_TYPE phylogeny_graphics_type ) {
526         _phylogeny_graphics_type = phylogeny_graphics_type;
527     }
528
529     public void setPrintLineWidth( final float print_line_width ) {
530         _print_line_width = print_line_width;
531     }
532
533     public void setReplaceUnderscoresInNhParsing( final boolean nh_parsing_replace_underscores ) {
534         _nh_parsing_replace_underscores = nh_parsing_replace_underscores;
535     }
536
537     public void setShowBranchLengthValues( final boolean show_branch_length_values ) {
538         _show_branch_length_values = show_branch_length_values;
539     }
540
541     public void setShowDefaultNodeShapesExternal( final boolean show_default_node_shapes_external ) {
542         _show_default_node_shapes_external = show_default_node_shapes_external;
543     }
544
545     public void setShowDefaultNodeShapesInternal( final boolean show_default_node_shapes_internal ) {
546         _show_default_node_shapes_internal = show_default_node_shapes_internal;
547     }
548
549     public void setShowDomainLabels( final boolean show_domain_labels ) {
550         _show_domain_labels = show_domain_labels;
551     }
552
553     public void setShowScale( final boolean show_scale ) {
554         _show_scale = show_scale;
555     }
556
557     public void setTaxonomyColorize( final boolean b ) {
558         display_options[ color_according_to_species ][ 2 ] = b ? "yes" : "no";
559     }
560
561     public void setUseBranchesWidths( final boolean b ) {
562         display_options[ width_branches ][ 2 ] = b ? "yes" : "no";
563     }
564
565     boolean displaySequenceRelations() {
566         return _display_sequence_relations;
567     }
568
569     boolean doCheckOption( final int which ) {
570         return ( display_options[ which ][ 2 ].equalsIgnoreCase( "yes" ) )
571                 || ( display_options[ which ][ 2 ].equalsIgnoreCase( "true" ) );
572     }
573
574     boolean doDisplayClickToOption( final int which ) {
575         return clickto_options[ which ][ 1 ].equalsIgnoreCase( "display" );
576     }
577
578     boolean doDisplayOption( final int which ) {
579         return display_options[ which ][ 1 ].equalsIgnoreCase( "display" );
580     }
581
582     /**
583      * Will attempt to use the phylogeny to determine whether to check
584      * this or not (e.g. phylogram)
585      * 
586      */
587     boolean doGuessCheckOption( final int which ) {
588         return display_options[ which ][ 2 ].equals( "?" );
589     }
590
591     Map<String, Color> getAnnotationColors() {
592         if ( _annotation_colors == null ) {
593             _annotation_colors = new Hashtable<String, Color>();
594         }
595         return _annotation_colors;
596     }
597
598     int getBaseFontSize() {
599         return _base_font_size;
600     }
601
602     CLADOGRAM_TYPE getCladogramType() {
603         return _cladogram_type;
604     }
605
606     int getClickToOptionsCount() {
607         return clickto_options.length;
608     }
609
610     String getClickToTitle( final int which ) {
611         return clickto_options[ which ][ 0 ];
612     }
613
614     int getDefaultDisplayClicktoOption() {
615         return default_clickto;
616     }
617
618     SortedMap<String, Color> getDisplayColors() {
619         return _display_colors;
620     }
621
622     String getDisplayTitle( final int which ) {
623         return display_options[ which ][ 0 ];
624     }
625
626     Map<String, Color> getDomainColors() {
627         if ( _domain_colors == null ) {
628             _domain_colors = new Hashtable<String, Color>();
629         }
630         return _domain_colors;
631     }
632
633     int getGraphicsExportX() {
634         return _graphics_export_x;
635     }
636
637     int getGraphicsExportY() {
638         return _graphics_export_y;
639     }
640
641     Color getGuiBackgroundColor() {
642         return _gui_background_color;
643     }
644
645     Color getGuiButtonBackgroundColor() {
646         return _gui_button_background_color;
647     }
648
649     Color getGuiButtonBorderColor() {
650         return _gui_button_border_color;
651     }
652
653     Color getGuiButtonTextColor() {
654         return _gui_button_text_color;
655     }
656
657     Color getGuiCheckboxAndButtonActiveColor() {
658         return _gui_checkbox_and_button_active_color;
659     }
660
661     Color getGuiCheckboxTextColor() {
662         return _gui_checkbox_text_color;
663     }
664
665     Color getGuiMenuBackgroundColor() {
666         return _gui_menu_background_color;
667     }
668
669     Color getGuiMenuTextColor() {
670         return _gui_menu_text_color;
671     }
672
673     int getMaxBaseFontSize() {
674         return _max_base_font_size;
675     }
676
677     int getMinBaseFontSize() {
678         return _min_base_font_size;
679     }
680
681     double getMinConfidenceValue() {
682         return _min_confidence_value;
683     }
684
685     NODE_LABEL_DIRECTION getNodeLabelDirection() {
686         return _node_label_direction;
687     }
688
689     short getNumberOfDigitsAfterCommaForBranchLengthValues() {
690         return _number_of_digits_after_comma_for_branch_length_values;
691     }
692
693     short getNumberOfDigitsAfterCommaForConfidenceValues() {
694         return _number_of_digits_after_comma_for_confidence_values;
695     }
696
697     short getOvMaxHeight() {
698         return _ov_max_height;
699     }
700
701     short getOvMaxWidth() {
702         return _ov_max_width;
703     }
704
705     OVERVIEW_PLACEMENT_TYPE getOvPlacement() {
706         return _ov_placement;
707     }
708
709     PHYLOGENY_GRAPHICS_TYPE getPhylogenyGraphicsType() {
710         return _phylogeny_graphics_type;
711     }
712
713     float getPrintLineWidth() {
714         return _print_line_width;
715     }
716
717     Hashtable<String, Color> getSpeciesColors() {
718         if ( _species_colors == null ) {
719             _species_colors = new Hashtable<String, Color>();
720         }
721         return _species_colors;
722     }
723
724     final TAXONOMY_EXTRACTION getTaxonomyExtraction() {
725         return _taxonomy_extraction;
726     }
727
728     boolean isAntialiasScreen() {
729         if ( ForesterUtil.isMac() ) {
730             //Apple Macintosh graphics are slow, turn off anti-alias.
731             return false;
732         }
733         return _antialias_screen;
734     }
735
736     /**
737      * Convenience method.
738      * 
739      * @return true if value in configuration file was 'yes'
740      */
741     boolean isDrawAsPhylogram() {
742         return doCheckOption( display_as_phylogram );
743     }
744
745     boolean isEditable() {
746         return _editable;
747     }
748
749     /**
750      * Only used by ArchaeoptryxE.
751      *
752      */
753     boolean isHideControlPanelAndMenubar() {
754         return _hide_controls_and_menus;
755     }
756
757     boolean isInternalNumberAreConfidenceForNhParsing() {
758         return _internal_number_are_confidence_for_nh_parsing;
759     }
760
761     boolean isReplaceUnderscoresInNhParsing() {
762         return _nh_parsing_replace_underscores;
763     }
764
765     boolean isShowBranchLengthValues() {
766         return _show_branch_length_values;
767     }
768
769     boolean isShowOverview() {
770         return _show_overview;
771     }
772
773     boolean isShowScale() {
774         return _show_scale;
775     }
776
777     final boolean isUseNativeUI() {
778         if ( ( _ui == UI.UNKNOWN ) && ForesterUtil.isMac() ) {
779             _ui = UI.NATIVE;
780         }
781         return _ui == UI.NATIVE;
782     }
783
784     /**
785      * Only used by ArchaeoptryxE.
786      *
787      */
788     boolean isUseTabbedDisplay() {
789         return _use_tabbed_display;
790     }
791
792     boolean isValidatePhyloXmlAgainstSchema() {
793         return _validate_against_phyloxml_xsd_schema;
794     }
795
796     final void setTaxonomyExtraction( final TAXONOMY_EXTRACTION taxonomy_extraction ) {
797         _taxonomy_extraction = taxonomy_extraction;
798     }
799
800     private int getClickToIndex( final String name ) {
801         int index = -1;
802         if ( name.equals( "edit_info" ) ) {
803             index = Configuration.display_node_data;
804             ForesterUtil
805                     .printWarningMessage( Constants.PRG_NAME,
806                                           "configuration key [edit_info] is deprecated, use [display node data] instead" );
807         }
808         else if ( name.equals( "display_node_data" ) ) {
809             index = Configuration.display_node_data;
810         }
811         else if ( name.equals( "collapse_uncollapse" ) ) {
812             index = Configuration.collapse_uncollapse;
813         }
814         else if ( name.equals( "reroot" ) ) {
815             index = Configuration.reroot;
816         }
817         else if ( name.equals( "subtree" ) ) {
818             index = Configuration.subtree;
819         }
820         else if ( name.equals( "swap" ) ) {
821             index = Configuration.swap;
822         }
823         else if ( name.equals( "sort_descendants" ) ) {
824             index = Configuration.sort_descendents;
825         }
826         else if ( name.equals( "get_ext_descendents_data" ) ) {
827             index = Configuration.get_ext_desc_data;
828         }
829         else if ( name.equals( "display_sequences" ) ) {
830             ForesterUtil
831                     .printWarningMessage( Constants.PRG_NAME, "configuration key [display_sequences] is deprecated" );
832             return DEPRECATED;
833         }
834         else if ( name.equals( "open_seq_web" ) ) {
835             index = Configuration.open_seq_web;
836         }
837         else if ( name.equals( "open_pdb_web" ) ) {
838             index = Configuration.open_pdb_web;
839         }
840         else if ( name.equals( "open_tax_web" ) ) {
841             index = Configuration.open_tax_web;
842         }
843         else if ( name.equals( "blast" ) ) {
844             index = Configuration.blast;
845         }
846         else if ( name.equals( "cut_subtree" ) ) {
847             index = Configuration.cut_subtree;
848         }
849         else if ( name.equals( "copy_subtree" ) ) {
850             index = Configuration.copy_subtree;
851         }
852         else if ( name.equals( "paste_subtree" ) ) {
853             index = Configuration.paste_subtree;
854         }
855         else if ( name.equals( "delete" ) ) {
856             index = Configuration.delete_subtree_or_node;
857         }
858         else if ( name.equals( "add_new_node" ) ) {
859             index = Configuration.add_new_node;
860         }
861         else if ( name.equals( "edit_node_data" ) ) {
862             index = Configuration.edit_node_data;
863         }
864         else if ( name.equals( "select_nodes" ) ) {
865             index = Configuration.select_nodes;
866         }
867         else if ( name.equals( "display_node_popup" ) ) {
868             ForesterUtil.printWarningMessage( Constants.PRG_NAME,
869                                               "configuration key [display_node_popup] is deprecated" );
870             return DEPRECATED;
871         }
872         else if ( name.equals( "custom_option" ) ) {
873             ForesterUtil.printWarningMessage( Constants.PRG_NAME, "configuration key [custom_option] is deprecated" );
874             return DEPRECATED;
875         }
876         else if ( name.equals( "color_subtree" ) ) {
877             index = Configuration.color_subtree;
878         }
879         return index;
880     }
881
882     private boolean parseBoolean( final String str ) {
883         final String my_str = str.trim().toLowerCase();
884         if ( my_str.equals( "yes" ) || my_str.equals( "true" ) ) {
885             return true;
886         }
887         else if ( my_str.equals( "no" ) || my_str.equals( "false" ) ) {
888             return false;
889         }
890         else {
891             ForesterUtil.printWarningMessage( Constants.PRG_NAME, "could not parse boolean value from [" + str + "]" );
892             return false;
893         }
894     }
895
896     private double parseDouble( final String str ) {
897         double d = 0.0;
898         try {
899             d = Double.parseDouble( str.trim() );
900         }
901         catch ( final Exception e ) {
902             ForesterUtil.printWarningMessage( Constants.PRG_NAME, "could not parse double from [" + str + "]" );
903             d = 0.0;
904         }
905         return d;
906     }
907
908     private float parseFloat( final String str ) {
909         float f = 0.0f;
910         try {
911             f = Float.parseFloat( str.trim() );
912         }
913         catch ( final Exception e ) {
914             ForesterUtil.printWarningMessage( Constants.PRG_NAME, "could not parse float from [" + str + "]" );
915             f = 0.0f;
916         }
917         return f;
918     }
919
920     private int parseInt( final String str ) {
921         int i = -1;
922         try {
923             i = Integer.parseInt( str.trim() );
924         }
925         catch ( final Exception e ) {
926             ForesterUtil.printWarningMessage( Constants.PRG_NAME, "could not parse integer from [" + str + "]" );
927             i = -1;
928         }
929         return i;
930     }
931
932     private short parseShort( final String str ) {
933         short i = -1;
934         try {
935             i = Short.parseShort( str.trim() );
936         }
937         catch ( final Exception e ) {
938             ForesterUtil.printWarningMessage( Constants.PRG_NAME, "could not parse short from [" + str + "]" );
939             i = -1;
940         }
941         return i;
942     }
943
944     private void processFontFamily( final StringTokenizer st ) {
945         setBaseFontFamilyName( "" );
946         final String font_str = ( ( String ) st.nextElement() ).trim();
947         final String[] fonts = font_str.split( ",+" );
948         for( String font : fonts ) {
949             font = font.replace( '_', ' ' ).trim();
950             if ( Arrays.binarySearch( AptxUtil.getAvailableFontFamiliesSorted(), font ) >= 0 ) {
951                 setBaseFontFamilyName( font );
952                 break;
953             }
954         }
955     }
956
957     /**
958      * read each line of config file, process non-comment lines
959      * @throws IOException 
960      */
961     private void readConfig( final BufferedReader conf_in ) throws IOException {
962         String line;
963         do {
964             line = conf_in.readLine();
965             if ( line != null ) {
966                 line = line.trim();
967                 // skip comments and blank lines
968                 if ( !line.startsWith( "#" ) && ( !ForesterUtil.isEmpty( line ) ) ) {
969                     // convert runs of spaces to tabs
970                     line = line.replaceAll( "\\s+", "\t" );
971                     final StringTokenizer st = new StringTokenizer( line, "\t" );
972                     setKeyValue( st );
973                 }
974             }
975         } while ( line != null );
976     }
977
978     private void setAntialiasScreen( final boolean antialias_screen ) {
979         _antialias_screen = antialias_screen;
980     }
981
982     private void setCladogramType( final CLADOGRAM_TYPE cladogram_type ) {
983         _cladogram_type = cladogram_type;
984     }
985
986     private void setDefaultBootstrapSamples( final int default_bootstrap_samples ) {
987         _default_bootstrap_samples = default_bootstrap_samples;
988     }
989
990     private void setEditable( final boolean editable ) {
991         _editable = editable;
992     }
993
994     private void setExtNodeDataReturnOn( final EXT_NODE_DATA_RETURN_ON ext_node_data_return_on ) {
995         _ext_node_data_return_on = ext_node_data_return_on;
996     }
997
998     private void setGraphicsExportX( final int graphics_export_x ) {
999         _graphics_export_x = graphics_export_x;
1000     }
1001
1002     private void setGraphicsExportY( final int graphics_export_y ) {
1003         _graphics_export_y = graphics_export_y;
1004     }
1005
1006     private void setInternalNumberAreConfidenceForNhParsing( final boolean internal_number_are_confidence_for_nh_parsing ) {
1007         _internal_number_are_confidence_for_nh_parsing = internal_number_are_confidence_for_nh_parsing;
1008     }
1009
1010     /**
1011      * Set a key-value(s) tuple
1012      */
1013     private void setKeyValue( final StringTokenizer st ) {
1014         final String key = ( ( String ) st.nextElement() ).replace( ':', ' ' ).trim().toLowerCase();
1015         if ( !st.hasMoreElements() ) {
1016             return;
1017         }
1018         // Handle single value settings first:
1019         if ( key.equals( "default_click_to" ) ) {
1020             final String clickto_name = ( String ) st.nextElement();
1021             default_clickto = getClickToIndex( clickto_name );
1022             if ( default_clickto == -1 ) {
1023                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "invalid value [" + clickto_name
1024                         + "] for [default_click_to]" );
1025                 default_clickto = 0;
1026             }
1027             else if ( default_clickto == DEPRECATED ) {
1028                 // Deprecated.
1029             }
1030         }
1031         else if ( key.equals( "native_ui" ) ) {
1032             final String my_str = ( ( String ) st.nextElement() ).trim().toLowerCase();
1033             if ( my_str.equals( "yes" ) || my_str.equals( "true" ) ) {
1034                 _ui = UI.NATIVE;
1035             }
1036             else if ( my_str.equals( "no" ) || my_str.equals( "false" ) ) {
1037                 _ui = UI.CROSSPLATFORM;
1038             }
1039             else if ( my_str.equals( "?" ) ) {
1040                 _ui = UI.UNKNOWN;
1041             }
1042             else {
1043                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "could not parse yes/no/? value from [" + my_str
1044                         + "]" );
1045                 _ui = UI.UNKNOWN;
1046             }
1047         }
1048         else if ( key.equals( VALIDATE_AGAINST_PHYLOXML_XSD_SCHEMA ) ) {
1049             setValidatePhyloXmlAgainstSchema( parseBoolean( ( String ) st.nextElement() ) );
1050         }
1051         else if ( key.equals( "antialias_screen" ) ) {
1052             setAntialiasScreen( parseBoolean( ( String ) st.nextElement() ) );
1053         }
1054         else if ( key.equals( "phylogeny_graphics_type" ) ) {
1055             final String type_str = ( ( String ) st.nextElement() ).trim();
1056             if ( type_str.equalsIgnoreCase( PHYLOGENY_GRAPHICS_TYPE.CONVEX.toString() ) ) {
1057                 setPhylogenyGraphicsType( PHYLOGENY_GRAPHICS_TYPE.CONVEX );
1058             }
1059             else if ( type_str.equalsIgnoreCase( PHYLOGENY_GRAPHICS_TYPE.CURVED.toString() ) ) {
1060                 setPhylogenyGraphicsType( PHYLOGENY_GRAPHICS_TYPE.CURVED );
1061             }
1062             else if ( type_str.equalsIgnoreCase( PHYLOGENY_GRAPHICS_TYPE.EURO_STYLE.toString() ) ) {
1063                 setPhylogenyGraphicsType( PHYLOGENY_GRAPHICS_TYPE.EURO_STYLE );
1064             }
1065             else if ( type_str.equalsIgnoreCase( PHYLOGENY_GRAPHICS_TYPE.ROUNDED.toString() ) ) {
1066                 setPhylogenyGraphicsType( PHYLOGENY_GRAPHICS_TYPE.ROUNDED );
1067             }
1068             else if ( type_str.equalsIgnoreCase( PHYLOGENY_GRAPHICS_TYPE.RECTANGULAR.toString() ) ) {
1069                 setPhylogenyGraphicsType( PHYLOGENY_GRAPHICS_TYPE.RECTANGULAR );
1070             }
1071             else if ( type_str.equalsIgnoreCase( PHYLOGENY_GRAPHICS_TYPE.TRIANGULAR.toString() ) ) {
1072                 setPhylogenyGraphicsType( PHYLOGENY_GRAPHICS_TYPE.TRIANGULAR );
1073             }
1074             else if ( type_str.equalsIgnoreCase( PHYLOGENY_GRAPHICS_TYPE.UNROOTED.toString() ) ) {
1075                 setPhylogenyGraphicsType( PHYLOGENY_GRAPHICS_TYPE.UNROOTED );
1076             }
1077             else if ( type_str.equalsIgnoreCase( PHYLOGENY_GRAPHICS_TYPE.CIRCULAR.toString() ) ) {
1078                 setPhylogenyGraphicsType( PHYLOGENY_GRAPHICS_TYPE.CIRCULAR );
1079             }
1080             else {
1081                 setPhylogenyGraphicsType( PHYLOGENY_GRAPHICS_TYPE.RECTANGULAR );
1082                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown value [" + type_str
1083                         + "] for [phylogeny_graphics_type]" );
1084             }
1085         }
1086         else if ( key.equals( "min_confidence_value" ) ) {
1087             final String mcv_str = ( ( String ) st.nextElement() ).trim();
1088             final double d = parseDouble( mcv_str );
1089             setMinConfidenceValue( d );
1090         }
1091         else if ( key.equals( "font_family" ) ) {
1092             processFontFamily( st );
1093         }
1094         else if ( key.equals( "font_size" ) ) {
1095             final String size_str = ( ( String ) st.nextElement() ).trim();
1096             final int i = parseInt( size_str );
1097             if ( i > 0 ) {
1098                 setBaseFontSize( i );
1099             }
1100         }
1101         else if ( key.equals( "font_size_min" ) ) {
1102             final String size_str = ( ( String ) st.nextElement() ).trim();
1103             final int i = parseInt( size_str );
1104             if ( i > 0 ) {
1105                 setMinBaseFontSize( i );
1106             }
1107         }
1108         else if ( key.equals( "font_size_max" ) ) {
1109             final String size_str = ( ( String ) st.nextElement() ).trim();
1110             final int i = parseInt( size_str );
1111             if ( i > 1 ) {
1112                 setMaxBaseFontSize( i );
1113             }
1114         }
1115         else if ( key.equals( "graphics_export_x" ) ) {
1116             final String str = ( ( String ) st.nextElement() ).trim();
1117             final int i = parseInt( str );
1118             if ( i > 0 ) {
1119                 setGraphicsExportX( i );
1120             }
1121         }
1122         else if ( key.equals( "graphics_export_y" ) ) {
1123             final String str = ( ( String ) st.nextElement() ).trim();
1124             final int i = parseInt( str );
1125             if ( i > 0 ) {
1126                 setGraphicsExportY( i );
1127             }
1128         }
1129         else if ( key.equals( "pdf_export_line_width" ) ) {
1130             final String str = ( ( String ) st.nextElement() ).trim();
1131             final float f = parseFloat( str );
1132             if ( f > 0 ) {
1133                 setPrintLineWidth( f );
1134             }
1135             else {
1136                 ForesterUtil.printWarningMessage( Constants.PRG_NAME,
1137                                                   "value for [pdf_export_line_width] cannot be zero or negative" );
1138             }
1139         }
1140         else if ( key.equals( "window_initial_size_x" ) ) {
1141             final String str = ( ( String ) st.nextElement() ).trim();
1142             final int i = parseInt( str );
1143             if ( i > 0 ) {
1144                 setFrameXSize( i );
1145             }
1146         }
1147         else if ( key.equals( "window_initial_size_y" ) ) {
1148             final String str = ( ( String ) st.nextElement() ).trim();
1149             final int i = parseInt( str );
1150             if ( i > 0 ) {
1151                 setFrameYSize( i );
1152             }
1153         }
1154         else if ( key.equals( "default_number_of_bootstrap_resamples" ) ) {
1155             final String str = ( ( String ) st.nextElement() ).trim();
1156             final int i = parseInt( str );
1157             if ( i >= 0 ) {
1158                 setDefaultBootstrapSamples( i );
1159             }
1160             else {
1161                 ForesterUtil
1162                         .printWarningMessage( Constants.PRG_NAME,
1163                                               "value for [default_number_of_bootstrap_resamples] cannot be negative" );
1164             }
1165         }
1166         else if ( key.equals( "mafft_local" ) ) {
1167             final String str = ( ( String ) st.nextElement() ).trim();
1168             if ( !ForesterUtil.isEmpty( str ) ) {
1169                 setPathToLocalMafft( new File( str ) );
1170             }
1171         }
1172         else if ( key.equals( "fastme_local" ) ) {
1173             final String str = ( ( String ) st.nextElement() ).trim();
1174             if ( !ForesterUtil.isEmpty( str ) ) {
1175                 setPathToLocalFastme( new File( str ) );
1176             }
1177         }
1178         else if ( key.equals( "raxml_local" ) ) {
1179             final String str = ( ( String ) st.nextElement() ).trim();
1180             if ( !ForesterUtil.isEmpty( str ) ) {
1181                 setPathToLocalRaxml( new File( str ) );
1182             }
1183         }
1184         else if ( key.equals( "show_scale" ) ) {
1185             setShowScale( parseBoolean( ( String ) st.nextElement() ) );
1186         }
1187         else if ( key.equals( "show_overview" ) ) {
1188             setShowOverview( parseBoolean( ( String ) st.nextElement() ) );
1189         }
1190         else if ( key.equals( "show_branch_length_values" ) ) {
1191             setShowBranchLengthValues( parseBoolean( ( String ) st.nextElement() ) );
1192         }
1193         else if ( key.equals( "background_gradient" ) ) {
1194             setBackgroundColorGradient( parseBoolean( ( String ) st.nextElement() ) );
1195         }
1196         else if ( key.equals( "color_labels_same_as_branch_length_values" ) ) {
1197             setColorLabelsSameAsParentBranch( parseBoolean( ( String ) st.nextElement() ) );
1198         }
1199         else if ( key.equals( "show_domain_labels" ) ) {
1200             setShowDomainLabels( parseBoolean( ( String ) st.nextElement() ) );
1201         }
1202         else if ( key.equals( "show_seq_annotation_ref_sources" ) ) {
1203             setShowAnnotationRefSource( parseBoolean( ( String ) st.nextElement() ) );
1204         }
1205         else if ( key.equals( "abbreviate_scientific_names" ) ) {
1206             setAbbreviateScientificTaxonNames( parseBoolean( ( String ) st.nextElement() ) );
1207         }
1208         else if ( key.equals( "cladogram_type" ) ) {
1209             final String type_str = ( ( String ) st.nextElement() ).trim();
1210             if ( type_str.equalsIgnoreCase( Options.CLADOGRAM_TYPE.NON_LINED_UP.toString() ) ) {
1211                 setCladogramType( Options.CLADOGRAM_TYPE.NON_LINED_UP );
1212             }
1213             else if ( type_str.equalsIgnoreCase( Options.CLADOGRAM_TYPE.EXT_NODE_SUM_DEP.toString() ) ) {
1214                 setCladogramType( Options.CLADOGRAM_TYPE.EXT_NODE_SUM_DEP );
1215             }
1216             else if ( type_str.equalsIgnoreCase( Options.CLADOGRAM_TYPE.TOTAL_NODE_SUM_DEP.toString() ) ) {
1217                 setCladogramType( Options.CLADOGRAM_TYPE.TOTAL_NODE_SUM_DEP );
1218             }
1219             else {
1220                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown value [" + type_str
1221                         + "] for [cladogram_type]" );
1222             }
1223         }
1224         else if ( key.equals( "non_lined_up_cladogram" ) ) {
1225             ForesterUtil
1226                     .printWarningMessage( Constants.PRG_NAME,
1227                                           "configuration key [non_lined_up_cladogram] is deprecated, use [cladogram_type] instead" );
1228         }
1229         else if ( key.equals( "hide_controls_and_menus" ) ) {
1230             _hide_controls_and_menus = parseBoolean( ( String ) st.nextElement() );
1231         }
1232         else if ( key.equals( "use_tabbed_display" ) ) {
1233             _use_tabbed_display = parseBoolean( ( String ) st.nextElement() );
1234         }
1235         else if ( key.equals( "overview_width" ) ) {
1236             final short i = parseShort( ( ( String ) st.nextElement() ) );
1237             setOvMaxWidth( i );
1238         }
1239         else if ( key.equals( "overview_height" ) ) {
1240             final short i = parseShort( ( ( String ) st.nextElement() ) );
1241             setOvMaxHeight( i );
1242         }
1243         else if ( key.equals( "overview_placement_type" ) ) {
1244             final String type_str = ( ( String ) st.nextElement() ).trim();
1245             if ( type_str.equalsIgnoreCase( OVERVIEW_PLACEMENT_TYPE.UPPER_LEFT.toTag() ) ) {
1246                 setOvPlacement( OVERVIEW_PLACEMENT_TYPE.UPPER_LEFT );
1247             }
1248             else if ( type_str.equalsIgnoreCase( OVERVIEW_PLACEMENT_TYPE.UPPER_RIGHT.toTag() ) ) {
1249                 setOvPlacement( OVERVIEW_PLACEMENT_TYPE.UPPER_RIGHT );
1250             }
1251             else if ( type_str.equalsIgnoreCase( OVERVIEW_PLACEMENT_TYPE.LOWER_LEFT.toTag() ) ) {
1252                 setOvPlacement( OVERVIEW_PLACEMENT_TYPE.LOWER_LEFT );
1253             }
1254             else if ( type_str.equalsIgnoreCase( OVERVIEW_PLACEMENT_TYPE.LOWER_RIGHT.toTag() ) ) {
1255                 setOvPlacement( OVERVIEW_PLACEMENT_TYPE.LOWER_RIGHT );
1256             }
1257             else {
1258                 setOvPlacement( OVERVIEW_PLACEMENT_TYPE.UPPER_LEFT );
1259                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown value [" + type_str
1260                         + "] for [overview_placement_type]" );
1261             }
1262         }
1263         else if ( key.equals( "node_label_direction" ) ) {
1264             final String type_str = ( ( String ) st.nextElement() ).trim();
1265             if ( type_str.equalsIgnoreCase( NODE_LABEL_DIRECTION.HORIZONTAL.toString() ) ) {
1266                 setNodeLabelDirection( NODE_LABEL_DIRECTION.HORIZONTAL );
1267             }
1268             else if ( type_str.equalsIgnoreCase( NODE_LABEL_DIRECTION.RADIAL.toString() ) ) {
1269                 setNodeLabelDirection( NODE_LABEL_DIRECTION.RADIAL );
1270             }
1271             else {
1272                 setNodeLabelDirection( NODE_LABEL_DIRECTION.HORIZONTAL );
1273                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown value [" + type_str
1274                         + "] for [node_label_direction]" );
1275             }
1276         }
1277         else if ( key.equals( "branch_length_value_digits" ) ) {
1278             final short i = parseShort( ( ( String ) st.nextElement() ).trim() );
1279             if ( i >= 0 ) {
1280                 setNumberOfDigitsAfterCommaForBranchLengthValue( i );
1281             }
1282             else {
1283                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "illegal value [" + i
1284                         + "] for [branch_length_value_digits]" );
1285             }
1286         }
1287         else if ( key.equals( "confidence_value_digits" ) ) {
1288             final short i = parseShort( ( ( String ) st.nextElement() ).trim() );
1289             if ( i >= 0 ) {
1290                 setNumberOfDigitsAfterCommaForConfidenceValues( i );
1291             }
1292             else {
1293                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "illegal value [" + i
1294                         + "] for [confidence_value_digits]" );
1295             }
1296         }
1297         else if ( key.equals( "allow_editing" ) ) {
1298             setEditable( parseBoolean( ( String ) st.nextElement() ) );
1299         }
1300         else if ( key.equals( "display_sequence_relations" ) ) {
1301             setDisplaySequenceRelations( parseBoolean( ( String ) st.nextElement() ) );
1302         }
1303         else if ( key.equals( "replace_underscores_in_nh_parsing" ) ) {
1304             final boolean r = parseBoolean( ( String ) st.nextElement() );
1305             if ( r && ( getTaxonomyExtraction() != TAXONOMY_EXTRACTION.NO ) ) {
1306                 ForesterUtil
1307                         .printWarningMessage( Constants.PRG_NAME,
1308                                               "attempt to extract taxonomies and replace underscores at the same time" );
1309             }
1310             else {
1311                 setReplaceUnderscoresInNhParsing( r );
1312             }
1313         }
1314         else if ( key.equals( "taxonomy_extraction_in_nh_parsing" ) ) {
1315             final String s = ( String ) st.nextElement();
1316             if ( s.equalsIgnoreCase( "no" ) ) {
1317                 setTaxonomyExtraction( TAXONOMY_EXTRACTION.NO );
1318             }
1319             else if ( s.equalsIgnoreCase( "pfam_relaxed" ) ) {
1320                 setTaxonomyExtraction( TAXONOMY_EXTRACTION.PFAM_STYLE_RELAXED );
1321             }
1322             else if ( s.equalsIgnoreCase( "pfam_strict" ) ) {
1323                 setTaxonomyExtraction( TAXONOMY_EXTRACTION.PFAM_STYLE_STRICT );
1324             }
1325             else if ( s.equalsIgnoreCase( "aggressive" ) ) {
1326                 setTaxonomyExtraction( TAXONOMY_EXTRACTION.AGGRESSIVE );
1327             }
1328             else {
1329                 ForesterUtil
1330                         .printWarningMessage( Constants.PRG_NAME,
1331                                               "unknown value for \"taxonomy_extraction_in_nh_parsing\": "
1332                                                       + s
1333                                                       + " (must be either: no, pfam_relaxed, pfam_strict, or aggressive)" );
1334             }
1335             if ( ( getTaxonomyExtraction() != TAXONOMY_EXTRACTION.NO ) && isReplaceUnderscoresInNhParsing() ) {
1336                 ForesterUtil
1337                         .printWarningMessage( Constants.PRG_NAME,
1338                                               "attempt to extract taxonomies and replace underscores at the same time" );
1339             }
1340         }
1341         else if ( key.equals( "internal_labels_are_confidence_values" ) ) {
1342             setInternalNumberAreConfidenceForNhParsing( parseBoolean( ( String ) st.nextElement() ) );
1343         }
1344         else if ( key.equals( "gui_background_color" ) ) {
1345             _gui_background_color = Color.decode( ( String ) st.nextElement() );
1346         }
1347         else if ( key.equals( "gui_checkbox_text_color" ) ) {
1348             _gui_checkbox_text_color = Color.decode( ( String ) st.nextElement() );
1349         }
1350         else if ( key.equals( "gui_checkbox_and_button_active_color" ) ) {
1351             _gui_checkbox_and_button_active_color = Color.decode( ( String ) st.nextElement() );
1352         }
1353         else if ( key.equals( "gui_button_text_color" ) ) {
1354             _gui_button_text_color = Color.decode( ( String ) st.nextElement() );
1355         }
1356         else if ( key.equals( "gui_button_background_color" ) ) {
1357             _gui_button_background_color = Color.decode( ( String ) st.nextElement() );
1358         }
1359         else if ( key.equals( "gui_menu_background_color" ) ) {
1360             _gui_menu_background_color = Color.decode( ( String ) st.nextElement() );
1361         }
1362         else if ( key.equals( "gui_menu_text_color" ) ) {
1363             _gui_menu_text_color = Color.decode( ( String ) st.nextElement() );
1364         }
1365         else if ( key.equals( "gui_button_border_color" ) ) {
1366             _gui_button_border_color = Color.decode( ( String ) st.nextElement() );
1367         }
1368         else if ( key.equals( "domain_structure_font_color" ) ) {
1369             _domain_structure_font_color = Color.decode( ( String ) st.nextElement() );
1370         }
1371         else if ( key.equals( "domain_structure_base_color" ) ) {
1372             _domain_structure_base_color = Color.decode( ( String ) st.nextElement() );
1373         }
1374         else if ( key.equals( "show_default_node_shapes" ) ) {
1375             ForesterUtil
1376                     .printWarningMessage( Constants.PRG_NAME,
1377                                           "configuration key [show_default_node_shapes] is deprecated, use [show_default_node_shapes_internal] and [show_default_node_shapes_external] instead" );
1378             final boolean b = parseBoolean( ( ( String ) st.nextElement() ).trim() );
1379             setShowDefaultNodeShapesInternal( b );
1380             setShowDefaultNodeShapesExternal( b );
1381         }
1382         else if ( key.equals( "show_default_node_shapes_internal" ) ) {
1383             setShowDefaultNodeShapesInternal( parseBoolean( ( ( String ) st.nextElement() ).trim() ) );
1384         }
1385         else if ( key.equals( "show_default_node_shapes_external" ) ) {
1386             setShowDefaultNodeShapesExternal( parseBoolean( ( ( String ) st.nextElement() ).trim() ) );
1387         }
1388         else if ( key.equals( "default_node_size" ) ) {
1389             final short i = parseShort( ( ( String ) st.nextElement() ).trim() );
1390             setDefaultNodeShapeSize( i );
1391         }
1392         else if ( key.equals( "default_node_fill" ) ) {
1393             final String fill_str = ( ( String ) st.nextElement() ).trim();
1394             if ( fill_str.equalsIgnoreCase( NodeVisualization.NodeFill.NONE.toString() ) ) {
1395                 setDefaultNodeFill( NodeFill.NONE );
1396             }
1397             else if ( fill_str.equalsIgnoreCase( NodeVisualization.NodeFill.GRADIENT.toString() ) ) {
1398                 setDefaultNodeFill( NodeFill.GRADIENT );
1399             }
1400             else if ( fill_str.equalsIgnoreCase( NodeVisualization.NodeFill.SOLID.toString() ) ) {
1401                 setDefaultNodeFill( NodeFill.SOLID );
1402             }
1403             else {
1404                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown value [" + fill_str
1405                         + "] for [default_node_fill]" );
1406             }
1407         }
1408         else if ( key.equals( "default_node_shape" ) ) {
1409             final String shape_str = ( ( String ) st.nextElement() ).trim();
1410             if ( shape_str.equalsIgnoreCase( NodeVisualization.NodeShape.CIRCLE.toString() ) ) {
1411                 setDefaultNodeShape( NodeShape.CIRCLE );
1412             }
1413             else if ( shape_str.equalsIgnoreCase( NodeVisualization.NodeShape.RECTANGLE.toString() ) ) {
1414                 setDefaultNodeShape( NodeShape.RECTANGLE );
1415             }
1416             else {
1417                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown value [" + shape_str
1418                         + "] for [default_node_shape]" );
1419             }
1420         }
1421         else if ( key.equals( "midpoint_reroot" ) ) {
1422             setMidpointReroot( parseBoolean( ( String ) st.nextElement() ) );
1423         }
1424         else if ( key.equals( "ext_descendents_data_to_return" ) ) {
1425             final String s = ( ( String ) st.nextElement() ).trim();
1426             if ( s.equalsIgnoreCase( "node_name" ) ) {
1427                 setExtDescNodeDataToReturn( NODE_DATA.NODE_NAME );
1428             }
1429             else if ( s.equalsIgnoreCase( "sequence_acc" ) ) {
1430                 setExtDescNodeDataToReturn( NODE_DATA.SEQUENCE_ACC );
1431             }
1432             else if ( s.equalsIgnoreCase( "sequence_mol_seq_fasta" ) ) {
1433                 setExtDescNodeDataToReturn( NODE_DATA.SEQUENCE_MOL_SEQ_FASTA );
1434             }
1435             else if ( s.equalsIgnoreCase( "sequence_mol_seq" ) ) {
1436                 setExtDescNodeDataToReturn( NODE_DATA.SEQUENCE_MOL_SEQ );
1437             }
1438             else if ( s.equalsIgnoreCase( "sequence_name" ) ) {
1439                 setExtDescNodeDataToReturn( NODE_DATA.SEQUENCE_NAME );
1440             }
1441             else if ( s.equalsIgnoreCase( "gene_name" ) ) {
1442                 setExtDescNodeDataToReturn( NODE_DATA.GENE_NAME );
1443             }
1444             else if ( s.equalsIgnoreCase( "sequence_symbol" ) ) {
1445                 setExtDescNodeDataToReturn( NODE_DATA.SEQUENCE_SYMBOL );
1446             }
1447             else if ( s.equalsIgnoreCase( "taxonomy_scientific_name" ) ) {
1448                 setExtDescNodeDataToReturn( NODE_DATA.TAXONOMY_SCIENTIFIC_NAME );
1449             }
1450             else if ( s.equalsIgnoreCase( "taxonomy_code" ) ) {
1451                 setExtDescNodeDataToReturn( NODE_DATA.TAXONOMY_CODE );
1452             }
1453             else if ( s.equalsIgnoreCase( "taxonomy_common_name" ) ) {
1454                 setExtDescNodeDataToReturn( NODE_DATA.TAXONOMY_COMM0N_NAME );
1455             }
1456             else if ( s.equalsIgnoreCase( "user_selected" ) ) {
1457                 setExtDescNodeDataToReturn( NODE_DATA.UNKNOWN );
1458             }
1459             else {
1460                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown value [" + s
1461                         + "] for [ext_descendents_data_to_return]" );
1462             }
1463         }
1464         else if ( key.equals( "label_for_get_ext_descendents_data" ) ) {
1465             final String s = ( ( String ) st.nextElement() ).trim();
1466             if ( ForesterUtil.isEmpty( s ) || ( s.length() < 2 ) ) {
1467                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "illegal value [" + s
1468                         + "] for [label_for_get_ext_descendents_data]" );
1469             }
1470             else {
1471                 setLabelForGetExtDescendentsData( s.replaceAll( "_", " " ) );
1472             }
1473         }
1474         else if ( key.equals( "ext_descendents_data_to_return_on" ) ) {
1475             final String s = ( ( String ) st.nextElement() ).trim().toLowerCase();
1476             if ( s.equals( "console" ) ) {
1477                 setExtNodeDataReturnOn( EXT_NODE_DATA_RETURN_ON.CONSOLE );
1478             }
1479             else if ( s.equals( "window" ) ) {
1480                 setExtNodeDataReturnOn( EXT_NODE_DATA_RETURN_ON.WINODW );
1481             }
1482             else if ( s.equals( "buffer_only" ) ) {
1483                 setExtNodeDataReturnOn( EXT_NODE_DATA_RETURN_ON.BUFFER_ONLY );
1484             }
1485             else {
1486                 ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown value [" + s
1487                         + "] for [ext_descendents_data_to_return_on]" );
1488             }
1489         }
1490         else if ( st.countTokens() >= 2 ) { // counts the tokens that are not
1491             // yet retrieved!
1492             int key_index = -1;
1493             if ( key.equals( "phylogram" ) ) {
1494                 key_index = Configuration.display_as_phylogram;
1495             }
1496             else if ( key.equals( "rollover" ) ) {
1497                 key_index = Configuration.node_data_popup;
1498             }
1499             else if ( key.equals( "color_according_to_species" ) ) {
1500                 key_index = Configuration.color_according_to_species;
1501             }
1502             else if ( key.equals( "show_node_names" ) ) {
1503                 key_index = Configuration.show_node_names;
1504             }
1505             else if ( key.equals( "show_taxonomy_code" ) ) {
1506                 key_index = Configuration.show_tax_code;
1507             }
1508             else if ( key.equals( "write_confidence_values" ) ) {
1509                 key_index = Configuration.write_confidence_values;
1510             }
1511             else if ( key.equals( "write_events" ) ) {
1512                 key_index = Configuration.write_events;
1513             }
1514             else if ( key.equals( "color_branches" ) ) {
1515                 key_index = Configuration.color_branches;
1516             }
1517             else if ( key.equals( "width_branches" ) ) {
1518                 key_index = Configuration.width_branches;
1519             }
1520             else if ( key.equals( "show_domain_architectures" ) ) {
1521                 key_index = Configuration.show_domain_architectures;
1522             }
1523             else if ( key.equals( "show_annotations" ) ) {
1524                 key_index = Configuration.show_annotation;
1525             }
1526             else if ( key.equals( "show_binary_characters" ) ) {
1527                 key_index = Configuration.show_binary_characters;
1528             }
1529             else if ( key.equals( "show_binary_character_counts" ) ) {
1530                 key_index = Configuration.show_binary_character_counts;
1531             }
1532             else if ( key.equals( "show_seq_names" ) ) {
1533                 key_index = Configuration.show_seq_names;
1534             }
1535             else if ( key.equals( "show_gene_names" ) ) {
1536                 key_index = Configuration.show_gene_names;
1537             }
1538             else if ( key.equals( "show_seq_symbols" ) ) {
1539                 key_index = Configuration.show_seq_symbols;
1540             }
1541             else if ( key.equals( "show_seq_acc" ) ) {
1542                 key_index = Configuration.show_sequence_acc;
1543             }
1544             else if ( key.equals( "display_internal_data" ) ) {
1545                 key_index = Configuration.display_internal_data;
1546             }
1547             else if ( key.equals( "dynamically_hide_data" ) ) {
1548                 key_index = Configuration.dynamically_hide_data;
1549             }
1550             else if ( key.equals( "show_taxonomy_scientific_names" ) ) {
1551                 key_index = Configuration.show_taxonomy_scientific_names;
1552             }
1553             else if ( key.equals( "show_taxonomy_common_names" ) ) {
1554                 key_index = Configuration.show_taxonomy_common_names;
1555             }
1556             else if ( key.equals( "show_taxonomy_images" ) ) {
1557                 key_index = Configuration.show_taxonomy_images;
1558             }
1559             else if ( key.equals( "color_according_to_annotation" ) ) {
1560                 key_index = Configuration.color_according_to_annotation;
1561             }
1562             else if ( key.equals( "show_vector_data" ) ) {
1563                 key_index = Configuration.show_vector_data;
1564             }
1565             else if ( key.equals( "show_properties" ) ) {
1566                 key_index = Configuration.show_properties;
1567             }
1568             else if ( key.equals( "show_relation_confidence" ) ) {
1569                 key_index = Configuration.show_relation_confidence;
1570             }
1571             else if ( key.equals( "show_custom_node_shapes" ) ) {
1572                 key_index = Configuration.show_custom_node_shapes;
1573             }
1574             // If we've found the key, set the values
1575             if ( key_index >= 0 ) {
1576                 display_options[ key_index ][ 1 ] = ( String ) st.nextElement();
1577                 display_options[ key_index ][ 2 ] = ( String ) st.nextElement();
1578                 // otherwise, keep looking
1579             }
1580             else {
1581                 if ( key_index == DEPRECATED ) {
1582                     // Deprecated.
1583                 }
1584                 else if ( key.equals( "click_to" ) ) {
1585                     final String click_to_name = ( String ) st.nextElement();
1586                     key_index = getClickToIndex( click_to_name );
1587                     if ( key_index >= 0 ) {
1588                         clickto_options[ key_index ][ 1 ] = ( String ) st.nextElement();
1589                     }
1590                     else if ( key_index == DEPRECATED ) {
1591                         // Deprecated.
1592                     }
1593                     else {
1594                         ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown click-to option: "
1595                                 + click_to_name );
1596                     }
1597                 }
1598                 else if ( key.equals( "species_color" ) ) {
1599                     getSpeciesColors().put( ( ( String ) st.nextElement() ).replace( '_', ' ' ),
1600                                             Color.decode( ( String ) st.nextElement() ) );
1601                 }
1602                 else if ( key.equals( "domain_color" ) ) {
1603                     getDomainColors().put( ( String ) st.nextElement(), Color.decode( ( String ) st.nextElement() ) );
1604                 }
1605                 else if ( key.equals( "annotation_color" ) ) {
1606                     getAnnotationColors()
1607                             .put( ( String ) st.nextElement(), Color.decode( ( String ) st.nextElement() ) );
1608                 }
1609                 else if ( key.equals( "function_color" ) ) {
1610                     ForesterUtil.printWarningMessage( Constants.PRG_NAME,
1611                                                       "configuration key [function_color] is deprecated" );
1612                 }
1613                 else if ( key.equals( DISPLAY_COLOR_KEY ) ) {
1614                     putDisplayColors( ( String ) st.nextElement(), Color.decode( ( String ) st.nextElement() ) );
1615                 }
1616                 else {
1617                     ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown configuration key [" + key
1618                             + "] in: " + config_filename );
1619                 }
1620             }
1621         }
1622         else {
1623             ForesterUtil.printWarningMessage( Constants.PRG_NAME, "unknown configuration key [" + key + "] in: "
1624                     + config_filename );
1625         }
1626     }
1627
1628     private void setLabelForGetExtDescendentsData( final String label_for_get_ext_descendents_data ) {
1629         _label_for_get_ext_descendents_data = label_for_get_ext_descendents_data;
1630     }
1631
1632     private void setMaxBaseFontSize( final int max_base_font_size ) {
1633         _max_base_font_size = max_base_font_size;
1634     }
1635
1636     private void setMinBaseFontSize( final int min_base_font_size ) {
1637         _min_base_font_size = min_base_font_size;
1638     }
1639
1640     private void setOvMaxHeight( final short ov_max_height ) {
1641         _ov_max_height = ov_max_height;
1642     }
1643
1644     private void setOvMaxWidth( final short ov_max_width ) {
1645         _ov_max_width = ov_max_width;
1646     }
1647
1648     private void setOvPlacement( final OVERVIEW_PLACEMENT_TYPE ov_placement ) {
1649         _ov_placement = ov_placement;
1650     }
1651
1652     private void setPathToLocalFastme( final File path_to_local_fastme ) {
1653         _path_to_local_fastme = path_to_local_fastme;
1654     }
1655
1656     private void setPathToLocalMafft( final File path_to_local_mafft ) {
1657         _path_to_local_mafft = path_to_local_mafft;
1658     }
1659
1660     private void setPathToLocalRaxml( final File path_to_local_raxml ) {
1661         _path_to_local_raxml = path_to_local_raxml;
1662     }
1663
1664     private void setShowAnnotationRefSource( final boolean b ) {
1665         _show_annotation_ref_source = b;
1666     }
1667
1668     private void setShowOverview( final boolean show_overview ) {
1669         _show_overview = show_overview;
1670     }
1671
1672     private void setValidatePhyloXmlAgainstSchema( final boolean validate_against_phyloxml_xsd_schema ) {
1673         _validate_against_phyloxml_xsd_schema = validate_against_phyloxml_xsd_schema;
1674     }
1675
1676     static String getDefaultFontFamilyName() {
1677         return DEFAULT_FONT_FAMILY;
1678     }
1679
1680     public enum EXT_NODE_DATA_RETURN_ON {
1681         BUFFER_ONLY, CONSOLE, WINODW;
1682     }
1683
1684     public enum UI {
1685         CROSSPLATFORM, NATIVE, NIMBUS, UNKNOWN
1686     }
1687
1688     static enum TRIPLET {
1689         FALSE, TRUE, UNKNOWN
1690     }
1691 }