2 * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3 * Copyright (C) $$Year-Rel$$ The Jalview Authors
5 * This file is part of Jalview.
7 * Jalview is free software: you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation, either version 3
10 * of the License, or (at your option) any later version.
12 * Jalview is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty
14 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15 * PURPOSE. See the GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
19 * The Jalview Authors are detailed in the 'AUTHORS' file.
23 import jalview.analysis.Conservation;
24 import jalview.api.FeatureColourI;
25 import jalview.api.ViewStyleI;
26 import jalview.api.structures.JalviewStructureDisplayI;
27 import jalview.bin.Cache;
28 import jalview.datamodel.AlignedCodonFrame;
29 import jalview.datamodel.Alignment;
30 import jalview.datamodel.AlignmentAnnotation;
31 import jalview.datamodel.AlignmentI;
32 import jalview.datamodel.GraphLine;
33 import jalview.datamodel.PDBEntry;
34 import jalview.datamodel.RnaViewerModel;
35 import jalview.datamodel.SequenceFeature;
36 import jalview.datamodel.SequenceGroup;
37 import jalview.datamodel.SequenceI;
38 import jalview.datamodel.StructureViewerModel;
39 import jalview.datamodel.StructureViewerModel.StructureData;
40 import jalview.datamodel.features.FeatureMatcher;
41 import jalview.datamodel.features.FeatureMatcherI;
42 import jalview.datamodel.features.FeatureMatcherSet;
43 import jalview.datamodel.features.FeatureMatcherSetI;
44 import jalview.ext.varna.RnaModel;
45 import jalview.gui.StructureViewer.ViewerType;
46 import jalview.io.DataSourceType;
47 import jalview.io.FileFormat;
48 import jalview.renderer.ResidueShaderI;
49 import jalview.schemabinding.version2.AlcodMap;
50 import jalview.schemabinding.version2.AlcodonFrame;
51 import jalview.schemabinding.version2.Annotation;
52 import jalview.schemabinding.version2.AnnotationColours;
53 import jalview.schemabinding.version2.AnnotationElement;
54 import jalview.schemabinding.version2.CalcIdParam;
55 import jalview.schemabinding.version2.CompoundMatcher;
56 import jalview.schemabinding.version2.DBRef;
57 import jalview.schemabinding.version2.Features;
58 import jalview.schemabinding.version2.Group;
59 import jalview.schemabinding.version2.HiddenColumns;
60 import jalview.schemabinding.version2.JGroup;
61 import jalview.schemabinding.version2.JSeq;
62 import jalview.schemabinding.version2.JalviewModel;
63 import jalview.schemabinding.version2.JalviewModelSequence;
64 import jalview.schemabinding.version2.MapListFrom;
65 import jalview.schemabinding.version2.MapListTo;
66 import jalview.schemabinding.version2.Mapping;
67 import jalview.schemabinding.version2.MappingChoice;
68 import jalview.schemabinding.version2.MatchCondition;
69 import jalview.schemabinding.version2.MatcherSet;
70 import jalview.schemabinding.version2.OtherData;
71 import jalview.schemabinding.version2.PdbentryItem;
72 import jalview.schemabinding.version2.Pdbids;
73 import jalview.schemabinding.version2.Property;
74 import jalview.schemabinding.version2.RnaViewer;
75 import jalview.schemabinding.version2.SecondaryStructure;
76 import jalview.schemabinding.version2.Sequence;
77 import jalview.schemabinding.version2.SequenceSet;
78 import jalview.schemabinding.version2.SequenceSetProperties;
79 import jalview.schemabinding.version2.Setting;
80 import jalview.schemabinding.version2.StructureState;
81 import jalview.schemabinding.version2.ThresholdLine;
82 import jalview.schemabinding.version2.Tree;
83 import jalview.schemabinding.version2.UserColours;
84 import jalview.schemabinding.version2.Viewport;
85 import jalview.schemabinding.version2.types.ColourThreshTypeType;
86 import jalview.schemabinding.version2.types.FeatureMatcherByType;
87 import jalview.schemabinding.version2.types.NoValueColour;
88 import jalview.schemes.AnnotationColourGradient;
89 import jalview.schemes.ColourSchemeI;
90 import jalview.schemes.ColourSchemeProperty;
91 import jalview.schemes.FeatureColour;
92 import jalview.schemes.ResidueProperties;
93 import jalview.schemes.UserColourScheme;
94 import jalview.structure.StructureSelectionManager;
95 import jalview.structures.models.AAStructureBindingModel;
96 import jalview.util.Format;
97 import jalview.util.MessageManager;
98 import jalview.util.Platform;
99 import jalview.util.StringUtils;
100 import jalview.util.jarInputStreamProvider;
101 import jalview.util.matcher.Condition;
102 import jalview.viewmodel.AlignmentViewport;
103 import jalview.viewmodel.ViewportRanges;
104 import jalview.viewmodel.seqfeatures.FeatureRendererSettings;
105 import jalview.viewmodel.seqfeatures.FeaturesDisplayed;
106 import jalview.ws.jws2.Jws2Discoverer;
107 import jalview.ws.jws2.dm.AAConSettings;
108 import jalview.ws.jws2.jabaws2.Jws2Instance;
109 import jalview.ws.params.ArgumentI;
110 import jalview.ws.params.AutoCalcSetting;
111 import jalview.ws.params.WsParamSetI;
113 import java.awt.Color;
114 import java.awt.Rectangle;
115 import java.io.BufferedReader;
116 import java.io.DataInputStream;
117 import java.io.DataOutputStream;
119 import java.io.FileInputStream;
120 import java.io.FileOutputStream;
121 import java.io.IOException;
122 import java.io.InputStreamReader;
123 import java.io.OutputStreamWriter;
124 import java.io.PrintWriter;
125 import java.lang.reflect.InvocationTargetException;
126 import java.net.MalformedURLException;
128 import java.util.ArrayList;
129 import java.util.Arrays;
130 import java.util.Collections;
131 import java.util.Enumeration;
132 import java.util.HashMap;
133 import java.util.HashSet;
134 import java.util.Hashtable;
135 import java.util.IdentityHashMap;
136 import java.util.Iterator;
137 import java.util.LinkedHashMap;
138 import java.util.List;
139 import java.util.Map;
140 import java.util.Map.Entry;
141 import java.util.Set;
142 import java.util.Vector;
143 import java.util.jar.JarEntry;
144 import java.util.jar.JarInputStream;
145 import java.util.jar.JarOutputStream;
147 import javax.swing.JInternalFrame;
148 import javax.swing.SwingUtilities;
150 import org.exolab.castor.xml.Marshaller;
151 import org.exolab.castor.xml.Unmarshaller;
154 * Write out the current jalview desktop state as a Jalview XML stream.
156 * Note: the vamsas objects referred to here are primitive versions of the
157 * VAMSAS project schema elements - they are not the same and most likely never
161 * @version $Revision: 1.134 $
163 public class Jalview2XML
165 private static final String VIEWER_PREFIX = "viewer_";
167 private static final String RNA_PREFIX = "rna_";
169 private static final String UTF_8 = "UTF-8";
171 // use this with nextCounter() to make unique names for entities
172 private int counter = 0;
175 * SequenceI reference -> XML ID string in jalview XML. Populated as XML reps
176 * of sequence objects are created.
178 IdentityHashMap<SequenceI, String> seqsToIds = null;
181 * jalview XML Sequence ID to jalview sequence object reference (both dataset
182 * and alignment sequences. Populated as XML reps of sequence objects are
185 Map<String, SequenceI> seqRefIds = null;
187 Map<String, SequenceI> incompleteSeqs = null;
189 List<SeqFref> frefedSequence = null;
191 boolean raiseGUI = true; // whether errors are raised in dialog boxes or not
194 * Map of reconstructed AlignFrame objects that appear to have come from
195 * SplitFrame objects (have a dna/protein complement view).
197 private Map<Viewport, AlignFrame> splitFrameCandidates = new HashMap<>();
200 * Map from displayed rna structure models to their saved session state jar
203 private Map<RnaModel, String> rnaSessions = new HashMap<>();
206 * create/return unique hash string for sq
209 * @return new or existing unique string for sq
211 String seqHash(SequenceI sq)
213 if (seqsToIds == null)
217 if (seqsToIds.containsKey(sq))
219 return seqsToIds.get(sq);
223 // create sequential key
224 String key = "sq" + (seqsToIds.size() + 1);
225 key = makeHashCode(sq, key); // check we don't have an external reference
227 seqsToIds.put(sq, key);
234 if (seqsToIds == null)
236 seqsToIds = new IdentityHashMap<>();
238 if (seqRefIds == null)
240 seqRefIds = new HashMap<>();
242 if (incompleteSeqs == null)
244 incompleteSeqs = new HashMap<>();
246 if (frefedSequence == null)
248 frefedSequence = new ArrayList<>();
256 public Jalview2XML(boolean raiseGUI)
258 this.raiseGUI = raiseGUI;
262 * base class for resolving forward references to sequences by their ID
267 abstract class SeqFref
273 public SeqFref(String _sref, String type)
279 public String getSref()
284 public SequenceI getSrefSeq()
286 return seqRefIds.get(sref);
289 public boolean isResolvable()
291 return seqRefIds.get(sref) != null;
294 public SequenceI getSrefDatasetSeq()
296 SequenceI sq = seqRefIds.get(sref);
299 while (sq.getDatasetSequence() != null)
301 sq = sq.getDatasetSequence();
308 * @return true if the forward reference was fully resolved
310 abstract boolean resolve();
313 public String toString()
315 return type + " reference to " + sref;
320 * create forward reference for a mapping
326 public SeqFref newMappingRef(final String sref,
327 final jalview.datamodel.Mapping _jmap)
329 SeqFref fref = new SeqFref(sref, "Mapping")
331 public jalview.datamodel.Mapping jmap = _jmap;
336 SequenceI seq = getSrefDatasetSeq();
348 public SeqFref newAlcodMapRef(final String sref,
349 final AlignedCodonFrame _cf,
350 final jalview.datamodel.Mapping _jmap)
353 SeqFref fref = new SeqFref(sref, "Codon Frame")
355 AlignedCodonFrame cf = _cf;
357 public jalview.datamodel.Mapping mp = _jmap;
360 public boolean isResolvable()
362 return super.isResolvable() && mp.getTo() != null;
368 SequenceI seq = getSrefDatasetSeq();
373 cf.addMap(seq, mp.getTo(), mp.getMap());
380 public void resolveFrefedSequences()
382 Iterator<SeqFref> nextFref = frefedSequence.iterator();
383 int toresolve = frefedSequence.size();
384 int unresolved = 0, failedtoresolve = 0;
385 while (nextFref.hasNext())
387 SeqFref ref = nextFref.next();
388 if (ref.isResolvable())
400 } catch (Exception x)
403 "IMPLEMENTATION ERROR: Failed to resolve forward reference for sequence "
416 System.err.println("Jalview Project Import: There were " + unresolved
417 + " forward references left unresolved on the stack.");
419 if (failedtoresolve > 0)
421 System.err.println("SERIOUS! " + failedtoresolve
422 + " resolvable forward references failed to resolve.");
424 if (incompleteSeqs != null && incompleteSeqs.size() > 0)
427 "Jalview Project Import: There are " + incompleteSeqs.size()
428 + " sequences which may have incomplete metadata.");
429 if (incompleteSeqs.size() < 10)
431 for (SequenceI s : incompleteSeqs.values())
433 System.err.println(s.toString());
439 "Too many to report. Skipping output of incomplete sequences.");
445 * This maintains a map of viewports, the key being the seqSetId. Important to
446 * set historyItem and redoList for multiple views
448 Map<String, AlignViewport> viewportsAdded = new HashMap<>();
450 Map<String, AlignmentAnnotation> annotationIds = new HashMap<>();
452 String uniqueSetSuffix = "";
455 * List of pdbfiles added to Jar
457 List<String> pdbfiles = null;
459 // SAVES SEVERAL ALIGNMENT WINDOWS TO SAME JARFILE
460 public void saveState(File statefile)
462 FileOutputStream fos = null;
465 fos = new FileOutputStream(statefile);
466 JarOutputStream jout = new JarOutputStream(fos);
469 } catch (Exception e)
471 // TODO: inform user of the problem - they need to know if their data was
473 if (errorMessage == null)
475 errorMessage = "Couldn't write Jalview Archive to output file '"
476 + statefile + "' - See console error log for details";
480 errorMessage += "(output file was '" + statefile + "')";
490 } catch (IOException e)
500 * Writes a jalview project archive to the given Jar output stream.
504 public void saveState(JarOutputStream jout)
506 AlignFrame[] frames = Desktop.getAlignFrames();
512 saveAllFrames(Arrays.asList(frames), jout);
516 * core method for storing state for a set of AlignFrames.
519 * - frames involving all data to be exported (including containing
522 * - project output stream
524 private void saveAllFrames(List<AlignFrame> frames, JarOutputStream jout)
526 Hashtable<String, AlignFrame> dsses = new Hashtable<>();
529 * ensure cached data is clear before starting
531 // todo tidy up seqRefIds, seqsToIds initialisation / reset
533 splitFrameCandidates.clear();
538 // NOTE UTF-8 MUST BE USED FOR WRITING UNICODE CHARS
539 // //////////////////////////////////////////////////
541 List<String> shortNames = new ArrayList<>();
542 List<String> viewIds = new ArrayList<>();
545 for (int i = frames.size() - 1; i > -1; i--)
547 AlignFrame af = frames.get(i);
549 if (skipList != null && skipList
550 .containsKey(af.getViewport().getSequenceSetId()))
555 String shortName = makeFilename(af, shortNames);
557 int ap, apSize = af.alignPanels.size();
559 for (ap = 0; ap < apSize; ap++)
561 AlignmentPanel apanel = af.alignPanels.get(ap);
562 String fileName = apSize == 1 ? shortName : ap + shortName;
563 if (!fileName.endsWith(".xml"))
565 fileName = fileName + ".xml";
568 saveState(apanel, fileName, jout, viewIds);
570 String dssid = getDatasetIdRef(
571 af.getViewport().getAlignment().getDataset());
572 if (!dsses.containsKey(dssid))
574 dsses.put(dssid, af);
579 writeDatasetFor(dsses, "" + jout.hashCode() + " " + uniqueSetSuffix,
585 } catch (Exception foo)
590 } catch (Exception ex)
592 // TODO: inform user of the problem - they need to know if their data was
594 if (errorMessage == null)
596 errorMessage = "Couldn't write Jalview Archive - see error output for details";
598 ex.printStackTrace();
603 * Generates a distinct file name, based on the title of the AlignFrame, by
604 * appending _n for increasing n until an unused name is generated. The new
605 * name (without its extension) is added to the list.
609 * @return the generated name, with .xml extension
611 protected String makeFilename(AlignFrame af, List<String> namesUsed)
613 String shortName = af.getTitle();
615 if (shortName.indexOf(File.separatorChar) > -1)
617 shortName = shortName
618 .substring(shortName.lastIndexOf(File.separatorChar) + 1);
623 while (namesUsed.contains(shortName))
625 if (shortName.endsWith("_" + (count - 1)))
627 shortName = shortName.substring(0, shortName.lastIndexOf("_"));
630 shortName = shortName.concat("_" + count);
634 namesUsed.add(shortName);
636 if (!shortName.endsWith(".xml"))
638 shortName = shortName + ".xml";
643 // USE THIS METHOD TO SAVE A SINGLE ALIGNMENT WINDOW
644 public boolean saveAlignment(AlignFrame af, String jarFile,
649 FileOutputStream fos = new FileOutputStream(jarFile);
650 JarOutputStream jout = new JarOutputStream(fos);
651 List<AlignFrame> frames = new ArrayList<>();
653 // resolve splitframes
654 if (af.getViewport().getCodingComplement() != null)
656 frames = ((SplitFrame) af.getSplitViewContainer()).getAlignFrames();
662 saveAllFrames(frames, jout);
666 } catch (Exception foo)
672 } catch (Exception ex)
674 errorMessage = "Couldn't Write alignment view to Jalview Archive - see error output for details";
675 ex.printStackTrace();
680 private void writeDatasetFor(Hashtable<String, AlignFrame> dsses,
681 String fileName, JarOutputStream jout)
684 for (String dssids : dsses.keySet())
686 AlignFrame _af = dsses.get(dssids);
687 String jfileName = fileName + " Dataset for " + _af.getTitle();
688 if (!jfileName.endsWith(".xml"))
690 jfileName = jfileName + ".xml";
692 saveState(_af.alignPanel, jfileName, true, jout, null);
697 * create a JalviewModel from an alignment view and marshall it to a
701 * panel to create jalview model for
703 * name of alignment panel written to output stream
710 public JalviewModel saveState(AlignmentPanel ap, String fileName,
711 JarOutputStream jout, List<String> viewIds)
713 return saveState(ap, fileName, false, jout, viewIds);
717 * create a JalviewModel from an alignment view and marshall it to a
721 * panel to create jalview model for
723 * name of alignment panel written to output stream
725 * when true, only write the dataset for the alignment, not the data
726 * associated with the view.
732 public JalviewModel saveState(AlignmentPanel ap, String fileName,
733 boolean storeDS, JarOutputStream jout, List<String> viewIds)
737 viewIds = new ArrayList<>();
742 List<UserColourScheme> userColours = new ArrayList<>();
744 AlignViewport av = ap.av;
745 ViewportRanges vpRanges = av.getRanges();
747 JalviewModel object = new JalviewModel();
748 object.setVamsasModel(new jalview.schemabinding.version2.VamsasModel());
750 object.setCreationDate(new java.util.Date(System.currentTimeMillis()));
752 jalview.bin.Cache.getDefault("VERSION", "Development Build"));
755 * rjal is full height alignment, jal is actual alignment with full metadata
756 * but excludes hidden sequences.
758 jalview.datamodel.AlignmentI rjal = av.getAlignment(), jal = rjal;
760 if (av.hasHiddenRows())
762 rjal = jal.getHiddenSequences().getFullAlignment();
765 SequenceSet vamsasSet = new SequenceSet();
767 JalviewModelSequence jms = new JalviewModelSequence();
769 vamsasSet.setGapChar(jal.getGapCharacter() + "");
771 if (jal.getDataset() != null)
773 // dataset id is the dataset's hashcode
774 vamsasSet.setDatasetId(getDatasetIdRef(jal.getDataset()));
777 // switch jal and the dataset
778 jal = jal.getDataset();
782 if (jal.getProperties() != null)
784 Enumeration en = jal.getProperties().keys();
785 while (en.hasMoreElements())
787 String key = en.nextElement().toString();
788 SequenceSetProperties ssp = new SequenceSetProperties();
790 ssp.setValue(jal.getProperties().get(key).toString());
791 vamsasSet.addSequenceSetProperties(ssp);
796 Set<String> calcIdSet = new HashSet<>();
797 // record the set of vamsas sequence XML POJO we create.
798 HashMap<String, Sequence> vamsasSetIds = new HashMap<>();
800 for (final SequenceI jds : rjal.getSequences())
802 final SequenceI jdatasq = jds.getDatasetSequence() == null ? jds
803 : jds.getDatasetSequence();
804 String id = seqHash(jds);
805 if (vamsasSetIds.get(id) == null)
807 if (seqRefIds.get(id) != null && !storeDS)
809 // This happens for two reasons: 1. multiple views are being
811 // 2. the hashCode has collided with another sequence's code. This
813 // HAPPEN! (PF00072.15.stk does this)
814 // JBPNote: Uncomment to debug writing out of files that do not read
815 // back in due to ArrayOutOfBoundExceptions.
816 // System.err.println("vamsasSeq backref: "+id+"");
817 // System.err.println(jds.getName()+"
818 // "+jds.getStart()+"-"+jds.getEnd()+" "+jds.getSequenceAsString());
819 // System.err.println("Hashcode: "+seqHash(jds));
820 // SequenceI rsq = (SequenceI) seqRefIds.get(id + "");
821 // System.err.println(rsq.getName()+"
822 // "+rsq.getStart()+"-"+rsq.getEnd()+" "+rsq.getSequenceAsString());
823 // System.err.println("Hashcode: "+seqHash(rsq));
827 vamsasSeq = createVamsasSequence(id, jds);
828 vamsasSet.addSequence(vamsasSeq);
829 vamsasSetIds.put(id, vamsasSeq);
830 seqRefIds.put(id, jds);
834 jseq.setStart(jds.getStart());
835 jseq.setEnd(jds.getEnd());
836 jseq.setColour(av.getSequenceColour(jds).getRGB());
838 jseq.setId(id); // jseq id should be a string not a number
841 // Store any sequences this sequence represents
842 if (av.hasHiddenRows())
844 // use rjal, contains the full height alignment
846 av.getAlignment().getHiddenSequences().isHidden(jds));
848 if (av.isHiddenRepSequence(jds))
850 jalview.datamodel.SequenceI[] reps = av
851 .getRepresentedSequences(jds).getSequencesInOrder(rjal);
853 for (int h = 0; h < reps.length; h++)
857 jseq.addHiddenSequences(rjal.findIndex(reps[h]));
862 // mark sequence as reference - if it is the reference for this view
865 jseq.setViewreference(jds == jal.getSeqrep());
869 // TODO: omit sequence features from each alignment view's XML dump if we
870 // are storing dataset
871 List<jalview.datamodel.SequenceFeature> sfs = jds
872 .getSequenceFeatures();
873 for (SequenceFeature sf : sfs)
875 Features features = new Features();
877 features.setBegin(sf.getBegin());
878 features.setEnd(sf.getEnd());
879 features.setDescription(sf.getDescription());
880 features.setType(sf.getType());
881 features.setFeatureGroup(sf.getFeatureGroup());
882 features.setScore(sf.getScore());
883 if (sf.links != null)
885 for (int l = 0; l < sf.links.size(); l++)
887 OtherData keyValue = new OtherData();
888 keyValue.setKey("LINK_" + l);
889 keyValue.setValue(sf.links.elementAt(l).toString());
890 features.addOtherData(keyValue);
893 if (sf.otherDetails != null)
896 * save feature attributes, which may be simple strings or
897 * map valued (have sub-attributes)
899 for (Entry<String, Object> entry : sf.otherDetails.entrySet())
901 String key = entry.getKey();
902 Object value = entry.getValue();
903 if (value instanceof Map<?, ?>)
905 for (Entry<String, Object> subAttribute : ((Map<String, Object>) value)
908 OtherData otherData = new OtherData();
909 otherData.setKey(key);
910 otherData.setKey2(subAttribute.getKey());
911 otherData.setValue(subAttribute.getValue().toString());
912 features.addOtherData(otherData);
917 OtherData otherData = new OtherData();
918 otherData.setKey(key);
919 otherData.setValue(value.toString());
920 features.addOtherData(otherData);
925 jseq.addFeatures(features);
928 if (jdatasq.getAllPDBEntries() != null)
930 Enumeration en = jdatasq.getAllPDBEntries().elements();
931 while (en.hasMoreElements())
933 Pdbids pdb = new Pdbids();
934 jalview.datamodel.PDBEntry entry = (jalview.datamodel.PDBEntry) en
937 String pdbId = entry.getId();
939 pdb.setType(entry.getType());
942 * Store any structure views associated with this sequence. This
943 * section copes with duplicate entries in the project, so a dataset
944 * only view *should* be coped with sensibly.
946 // This must have been loaded, is it still visible?
947 JInternalFrame[] frames = Desktop.desktop.getAllFrames();
948 String matchedFile = null;
949 for (int f = frames.length - 1; f > -1; f--)
951 if (frames[f] instanceof StructureViewerBase)
953 StructureViewerBase viewFrame = (StructureViewerBase) frames[f];
954 matchedFile = saveStructureState(ap, jds, pdb, entry, viewIds,
955 matchedFile, viewFrame);
957 * Only store each structure viewer's state once in the project
958 * jar. First time through only (storeDS==false)
960 String viewId = viewFrame.getViewId();
961 if (!storeDS && !viewIds.contains(viewId))
966 String viewerState = viewFrame.getStateInfo();
967 writeJarEntry(jout, getViewerJarEntryName(viewId),
968 viewerState.getBytes());
969 } catch (IOException e)
972 "Error saving viewer state: " + e.getMessage());
978 if (matchedFile != null || entry.getFile() != null)
980 if (entry.getFile() != null)
983 matchedFile = entry.getFile();
985 pdb.setFile(matchedFile); // entry.getFile());
986 if (pdbfiles == null)
988 pdbfiles = new ArrayList<>();
991 if (!pdbfiles.contains(pdbId))
994 copyFileToJar(jout, matchedFile, pdbId);
998 Enumeration<String> props = entry.getProperties();
999 if (props.hasMoreElements())
1001 PdbentryItem item = new PdbentryItem();
1002 while (props.hasMoreElements())
1004 Property prop = new Property();
1005 String key = props.nextElement();
1007 prop.setValue(entry.getProperty(key).toString());
1008 item.addProperty(prop);
1010 pdb.addPdbentryItem(item);
1013 jseq.addPdbids(pdb);
1017 saveRnaViewers(jout, jseq, jds, viewIds, ap, storeDS);
1022 if (!storeDS && av.hasHiddenRows())
1024 jal = av.getAlignment();
1028 if (storeDS && jal.getCodonFrames() != null)
1030 List<AlignedCodonFrame> jac = jal.getCodonFrames();
1031 for (AlignedCodonFrame acf : jac)
1033 AlcodonFrame alc = new AlcodonFrame();
1034 if (acf.getProtMappings() != null
1035 && acf.getProtMappings().length > 0)
1037 boolean hasMap = false;
1038 SequenceI[] dnas = acf.getdnaSeqs();
1039 jalview.datamodel.Mapping[] pmaps = acf.getProtMappings();
1040 for (int m = 0; m < pmaps.length; m++)
1042 AlcodMap alcmap = new AlcodMap();
1043 alcmap.setDnasq(seqHash(dnas[m]));
1045 createVamsasMapping(pmaps[m], dnas[m], null, false));
1046 alc.addAlcodMap(alcmap);
1051 vamsasSet.addAlcodonFrame(alc);
1054 // TODO: delete this ? dead code from 2.8.3->2.9 ?
1056 // AlcodonFrame alc = new AlcodonFrame();
1057 // vamsasSet.addAlcodonFrame(alc);
1058 // for (int p = 0; p < acf.aaWidth; p++)
1060 // Alcodon cmap = new Alcodon();
1061 // if (acf.codons[p] != null)
1063 // // Null codons indicate a gapped column in the translated peptide
1065 // cmap.setPos1(acf.codons[p][0]);
1066 // cmap.setPos2(acf.codons[p][1]);
1067 // cmap.setPos3(acf.codons[p][2]);
1069 // alc.addAlcodon(cmap);
1071 // if (acf.getProtMappings() != null
1072 // && acf.getProtMappings().length > 0)
1074 // SequenceI[] dnas = acf.getdnaSeqs();
1075 // jalview.datamodel.Mapping[] pmaps = acf.getProtMappings();
1076 // for (int m = 0; m < pmaps.length; m++)
1078 // AlcodMap alcmap = new AlcodMap();
1079 // alcmap.setDnasq(seqHash(dnas[m]));
1080 // alcmap.setMapping(createVamsasMapping(pmaps[m], dnas[m], null,
1082 // alc.addAlcodMap(alcmap);
1089 // /////////////////////////////////
1090 if (!storeDS && av.getCurrentTree() != null)
1092 // FIND ANY ASSOCIATED TREES
1093 // NOT IMPLEMENTED FOR HEADLESS STATE AT PRESENT
1094 if (Desktop.desktop != null)
1096 JInternalFrame[] frames = Desktop.desktop.getAllFrames();
1098 for (int t = 0; t < frames.length; t++)
1100 if (frames[t] instanceof TreePanel)
1102 TreePanel tp = (TreePanel) frames[t];
1104 if (tp.getTreeCanvas().getViewport().getAlignment() == jal)
1106 Tree tree = new Tree();
1107 tree.setTitle(tp.getTitle());
1108 tree.setCurrentTree((av.getCurrentTree() == tp.getTree()));
1109 tree.setNewick(tp.getTree().print());
1110 tree.setThreshold(tp.getTreeCanvas().getThreshold());
1112 tree.setFitToWindow(tp.fitToWindow.getState());
1113 tree.setFontName(tp.getTreeFont().getName());
1114 tree.setFontSize(tp.getTreeFont().getSize());
1115 tree.setFontStyle(tp.getTreeFont().getStyle());
1116 tree.setMarkUnlinked(tp.placeholdersMenu.getState());
1118 tree.setShowBootstrap(tp.bootstrapMenu.getState());
1119 tree.setShowDistances(tp.distanceMenu.getState());
1121 tree.setHeight(tp.getHeight());
1122 tree.setWidth(tp.getWidth());
1123 tree.setXpos(tp.getX());
1124 tree.setYpos(tp.getY());
1125 tree.setId(makeHashCode(tp, null));
1135 * store forward refs from an annotationRow to any groups
1137 IdentityHashMap<SequenceGroup, String> groupRefs = new IdentityHashMap<>();
1140 for (SequenceI sq : jal.getSequences())
1142 // Store annotation on dataset sequences only
1143 AlignmentAnnotation[] aa = sq.getAnnotation();
1144 if (aa != null && aa.length > 0)
1146 storeAlignmentAnnotation(aa, groupRefs, av, calcIdSet, storeDS,
1153 if (jal.getAlignmentAnnotation() != null)
1155 // Store the annotation shown on the alignment.
1156 AlignmentAnnotation[] aa = jal.getAlignmentAnnotation();
1157 storeAlignmentAnnotation(aa, groupRefs, av, calcIdSet, storeDS,
1162 if (jal.getGroups() != null)
1164 JGroup[] groups = new JGroup[jal.getGroups().size()];
1166 for (jalview.datamodel.SequenceGroup sg : jal.getGroups())
1168 JGroup jGroup = new JGroup();
1169 groups[++i] = jGroup;
1171 jGroup.setStart(sg.getStartRes());
1172 jGroup.setEnd(sg.getEndRes());
1173 jGroup.setName(sg.getName());
1174 if (groupRefs.containsKey(sg))
1176 // group has references so set its ID field
1177 jGroup.setId(groupRefs.get(sg));
1179 ColourSchemeI colourScheme = sg.getColourScheme();
1180 if (colourScheme != null)
1182 ResidueShaderI groupColourScheme = sg.getGroupColourScheme();
1183 if (groupColourScheme.conservationApplied())
1185 jGroup.setConsThreshold(groupColourScheme.getConservationInc());
1187 if (colourScheme instanceof jalview.schemes.UserColourScheme)
1190 setUserColourScheme(colourScheme, userColours, jms));
1194 jGroup.setColour(colourScheme.getSchemeName());
1197 else if (colourScheme instanceof jalview.schemes.AnnotationColourGradient)
1199 jGroup.setColour("AnnotationColourGradient");
1200 jGroup.setAnnotationColours(constructAnnotationColours(
1201 (jalview.schemes.AnnotationColourGradient) colourScheme,
1204 else if (colourScheme instanceof jalview.schemes.UserColourScheme)
1207 setUserColourScheme(colourScheme, userColours, jms));
1211 jGroup.setColour(colourScheme.getSchemeName());
1214 jGroup.setPidThreshold(groupColourScheme.getThreshold());
1217 jGroup.setOutlineColour(sg.getOutlineColour().getRGB());
1218 jGroup.setDisplayBoxes(sg.getDisplayBoxes());
1219 jGroup.setDisplayText(sg.getDisplayText());
1220 jGroup.setColourText(sg.getColourText());
1221 jGroup.setTextCol1(sg.textColour.getRGB());
1222 jGroup.setTextCol2(sg.textColour2.getRGB());
1223 jGroup.setTextColThreshold(sg.thresholdTextColour);
1224 jGroup.setShowUnconserved(sg.getShowNonconserved());
1225 jGroup.setIgnoreGapsinConsensus(sg.getIgnoreGapsConsensus());
1226 jGroup.setShowConsensusHistogram(sg.isShowConsensusHistogram());
1227 jGroup.setShowSequenceLogo(sg.isShowSequenceLogo());
1228 jGroup.setNormaliseSequenceLogo(sg.isNormaliseSequenceLogo());
1229 for (SequenceI seq : sg.getSequences())
1231 jGroup.addSeq(seqHash(seq));
1235 jms.setJGroup(groups);
1239 // /////////SAVE VIEWPORT
1240 Viewport view = new Viewport();
1241 view.setTitle(ap.alignFrame.getTitle());
1242 view.setSequenceSetId(
1243 makeHashCode(av.getSequenceSetId(), av.getSequenceSetId()));
1244 view.setId(av.getViewId());
1245 if (av.getCodingComplement() != null)
1247 view.setComplementId(av.getCodingComplement().getViewId());
1249 view.setViewName(av.getViewName());
1250 view.setGatheredViews(av.isGatherViewsHere());
1252 Rectangle size = ap.av.getExplodedGeometry();
1253 Rectangle position = size;
1256 size = ap.alignFrame.getBounds();
1257 if (av.getCodingComplement() != null)
1259 position = ((SplitFrame) ap.alignFrame.getSplitViewContainer())
1267 view.setXpos(position.x);
1268 view.setYpos(position.y);
1270 view.setWidth(size.width);
1271 view.setHeight(size.height);
1273 view.setStartRes(vpRanges.getStartRes());
1274 view.setStartSeq(vpRanges.getStartSeq());
1276 if (av.getGlobalColourScheme() instanceof jalview.schemes.UserColourScheme)
1278 view.setBgColour(setUserColourScheme(av.getGlobalColourScheme(),
1282 .getGlobalColourScheme() instanceof jalview.schemes.AnnotationColourGradient)
1284 AnnotationColours ac = constructAnnotationColours(
1285 (jalview.schemes.AnnotationColourGradient) av
1286 .getGlobalColourScheme(),
1289 view.setAnnotationColours(ac);
1290 view.setBgColour("AnnotationColourGradient");
1294 view.setBgColour(ColourSchemeProperty
1295 .getColourName(av.getGlobalColourScheme()));
1298 ResidueShaderI vcs = av.getResidueShading();
1299 ColourSchemeI cs = av.getGlobalColourScheme();
1303 if (vcs.conservationApplied())
1305 view.setConsThreshold(vcs.getConservationInc());
1306 if (cs instanceof jalview.schemes.UserColourScheme)
1308 view.setBgColour(setUserColourScheme(cs, userColours, jms));
1311 view.setPidThreshold(vcs.getThreshold());
1314 view.setConservationSelected(av.getConservationSelected());
1315 view.setPidSelected(av.getAbovePIDThreshold());
1316 view.setFontName(av.font.getName());
1317 view.setFontSize(av.font.getSize());
1318 view.setFontStyle(av.font.getStyle());
1319 view.setScaleProteinAsCdna(av.getViewStyle().isScaleProteinAsCdna());
1320 view.setRenderGaps(av.isRenderGaps());
1321 view.setShowAnnotation(av.isShowAnnotation());
1322 view.setShowBoxes(av.getShowBoxes());
1323 view.setShowColourText(av.getColourText());
1324 view.setShowFullId(av.getShowJVSuffix());
1325 view.setRightAlignIds(av.isRightAlignIds());
1326 view.setShowSequenceFeatures(av.isShowSequenceFeatures());
1327 view.setShowText(av.getShowText());
1328 view.setShowUnconserved(av.getShowUnconserved());
1329 view.setWrapAlignment(av.getWrapAlignment());
1330 view.setTextCol1(av.getTextColour().getRGB());
1331 view.setTextCol2(av.getTextColour2().getRGB());
1332 view.setTextColThreshold(av.getThresholdTextColour());
1333 view.setShowConsensusHistogram(av.isShowConsensusHistogram());
1334 view.setShowSequenceLogo(av.isShowSequenceLogo());
1335 view.setNormaliseSequenceLogo(av.isNormaliseSequenceLogo());
1336 view.setShowGroupConsensus(av.isShowGroupConsensus());
1337 view.setShowGroupConservation(av.isShowGroupConservation());
1338 view.setShowNPfeatureTooltip(av.isShowNPFeats());
1339 view.setShowDbRefTooltip(av.isShowDBRefs());
1340 view.setFollowHighlight(av.isFollowHighlight());
1341 view.setFollowSelection(av.followSelection);
1342 view.setIgnoreGapsinConsensus(av.isIgnoreGapsConsensus());
1343 if (av.getFeaturesDisplayed() != null)
1345 jalview.schemabinding.version2.FeatureSettings fs = new jalview.schemabinding.version2.FeatureSettings();
1347 FeatureRenderer fr = ap.getSeqPanel().seqCanvas
1348 .getFeatureRenderer();
1349 String[] renderOrder = fr.getRenderOrder().toArray(new String[0]);
1351 Vector<String> settingsAdded = new Vector<>();
1352 if (renderOrder != null)
1354 for (String featureType : renderOrder)
1356 Setting setting = new Setting();
1357 setting.setType(featureType);
1360 * save any filter for the feature type
1362 FeatureMatcherSetI filter = fr.getFeatureFilter(featureType);
1363 if (filter != null) {
1364 Iterator<FeatureMatcherI> filters = filter.getMatchers().iterator();
1365 FeatureMatcherI firstFilter = filters.next();
1366 setting.setMatcherSet(Jalview2XML.marshalFilter(
1367 firstFilter, filters, filter.isAnded()));
1371 * save colour scheme for the feature type
1373 FeatureColourI fcol = fr.getFeatureStyle(featureType);
1374 if (!fcol.isSimpleColour())
1376 setting.setColour(fcol.getMaxColour().getRGB());
1377 setting.setMincolour(fcol.getMinColour().getRGB());
1378 setting.setMin(fcol.getMin());
1379 setting.setMax(fcol.getMax());
1380 setting.setColourByLabel(fcol.isColourByLabel());
1381 if (fcol.isColourByAttribute())
1383 setting.setAttributeName(fcol.getAttributeName());
1385 setting.setAutoScale(fcol.isAutoScaled());
1386 setting.setThreshold(fcol.getThreshold());
1387 Color noColour = fcol.getNoColour();
1388 if (noColour == null)
1390 setting.setNoValueColour(NoValueColour.NONE);
1392 else if (noColour.equals(fcol.getMaxColour()))
1394 setting.setNoValueColour(NoValueColour.MAX);
1398 setting.setNoValueColour(NoValueColour.MIN);
1400 // -1 = No threshold, 0 = Below, 1 = Above
1401 setting.setThreshstate(fcol.isAboveThreshold() ? 1
1402 : (fcol.isBelowThreshold() ? 0 : -1));
1406 setting.setColour(fcol.getColour().getRGB());
1410 av.getFeaturesDisplayed().isVisible(featureType));
1412 .getOrder(featureType);
1415 setting.setOrder(rorder);
1417 fs.addSetting(setting);
1418 settingsAdded.addElement(featureType);
1422 // is groups actually supposed to be a map here ?
1423 Iterator<String> en = fr.getFeatureGroups().iterator();
1424 Vector<String> groupsAdded = new Vector<>();
1425 while (en.hasNext())
1427 String grp = en.next();
1428 if (groupsAdded.contains(grp))
1432 Group g = new Group();
1434 g.setDisplay(((Boolean) fr.checkGroupVisibility(grp, false))
1437 groupsAdded.addElement(grp);
1439 jms.setFeatureSettings(fs);
1442 if (av.hasHiddenColumns())
1444 jalview.datamodel.HiddenColumns hidden = av.getAlignment()
1445 .getHiddenColumns();
1448 warn("REPORT BUG: avoided null columnselection bug (DMAM reported). Please contact Jim about this.");
1452 Iterator<int[]> hiddenRegions = hidden.iterator();
1453 while (hiddenRegions.hasNext())
1455 int[] region = hiddenRegions.next();
1456 HiddenColumns hc = new HiddenColumns();
1457 hc.setStart(region[0]);
1458 hc.setEnd(region[1]);
1459 view.addHiddenColumns(hc);
1463 if (calcIdSet.size() > 0)
1465 for (String calcId : calcIdSet)
1467 if (calcId.trim().length() > 0)
1469 CalcIdParam cidp = createCalcIdParam(calcId, av);
1470 // Some calcIds have no parameters.
1473 view.addCalcIdParam(cidp);
1479 jms.addViewport(view);
1481 object.setJalviewModelSequence(jms);
1482 object.getVamsasModel().addSequenceSet(vamsasSet);
1484 if (jout != null && fileName != null)
1486 // We may not want to write the object to disk,
1487 // eg we can copy the alignViewport to a new view object
1488 // using save and then load
1491 System.out.println("Writing jar entry " + fileName);
1492 JarEntry entry = new JarEntry(fileName);
1493 jout.putNextEntry(entry);
1494 PrintWriter pout = new PrintWriter(
1495 new OutputStreamWriter(jout, UTF_8));
1496 Marshaller marshaller = new Marshaller(pout);
1497 marshaller.marshal(object);
1500 } catch (Exception ex)
1502 // TODO: raise error in GUI if marshalling failed.
1503 ex.printStackTrace();
1510 * Save any Varna viewers linked to this sequence. Writes an rnaViewer element
1511 * for each viewer, with
1513 * <li>viewer geometry (position, size, split pane divider location)</li>
1514 * <li>index of the selected structure in the viewer (currently shows gapped
1516 * <li>the id of the annotation holding RNA secondary structure</li>
1517 * <li>(currently only one SS is shown per viewer, may be more in future)</li>
1519 * Varna viewer state is also written out (in native Varna XML) to separate
1520 * project jar entries. A separate entry is written for each RNA structure
1521 * displayed, with the naming convention
1523 * <li>rna_viewId_sequenceId_annotationId_[gapped|trimmed]</li>
1531 * @param storeDataset
1533 protected void saveRnaViewers(JarOutputStream jout, JSeq jseq,
1534 final SequenceI jds, List<String> viewIds, AlignmentPanel ap,
1535 boolean storeDataset)
1537 if (Desktop.desktop == null)
1541 JInternalFrame[] frames = Desktop.desktop.getAllFrames();
1542 for (int f = frames.length - 1; f > -1; f--)
1544 if (frames[f] instanceof AppVarna)
1546 AppVarna varna = (AppVarna) frames[f];
1548 * link the sequence to every viewer that is showing it and is linked to
1549 * its alignment panel
1551 if (varna.isListeningFor(jds) && ap == varna.getAlignmentPanel())
1553 String viewId = varna.getViewId();
1554 RnaViewer rna = new RnaViewer();
1555 rna.setViewId(viewId);
1556 rna.setTitle(varna.getTitle());
1557 rna.setXpos(varna.getX());
1558 rna.setYpos(varna.getY());
1559 rna.setWidth(varna.getWidth());
1560 rna.setHeight(varna.getHeight());
1561 rna.setDividerLocation(varna.getDividerLocation());
1562 rna.setSelectedRna(varna.getSelectedIndex());
1563 jseq.addRnaViewer(rna);
1566 * Store each Varna panel's state once in the project per sequence.
1567 * First time through only (storeDataset==false)
1569 // boolean storeSessions = false;
1570 // String sequenceViewId = viewId + seqsToIds.get(jds);
1571 // if (!storeDataset && !viewIds.contains(sequenceViewId))
1573 // viewIds.add(sequenceViewId);
1574 // storeSessions = true;
1576 for (RnaModel model : varna.getModels())
1578 if (model.seq == jds)
1581 * VARNA saves each view (sequence or alignment secondary
1582 * structure, gapped or trimmed) as a separate XML file
1584 String jarEntryName = rnaSessions.get(model);
1585 if (jarEntryName == null)
1588 String varnaStateFile = varna.getStateInfo(model.rna);
1589 jarEntryName = RNA_PREFIX + viewId + "_" + nextCounter();
1590 copyFileToJar(jout, varnaStateFile, jarEntryName);
1591 rnaSessions.put(model, jarEntryName);
1593 SecondaryStructure ss = new SecondaryStructure();
1594 String annotationId = varna.getAnnotation(jds).annotationId;
1595 ss.setAnnotationId(annotationId);
1596 ss.setViewerState(jarEntryName);
1597 ss.setGapped(model.gapped);
1598 ss.setTitle(model.title);
1599 rna.addSecondaryStructure(ss);
1608 * Copy the contents of a file to a new entry added to the output jar
1612 * @param jarEntryName
1614 protected void copyFileToJar(JarOutputStream jout, String infilePath,
1615 String jarEntryName)
1617 DataInputStream dis = null;
1620 File file = new File(infilePath);
1621 if (file.exists() && jout != null)
1623 dis = new DataInputStream(new FileInputStream(file));
1624 byte[] data = new byte[(int) file.length()];
1625 dis.readFully(data);
1626 writeJarEntry(jout, jarEntryName, data);
1628 } catch (Exception ex)
1630 ex.printStackTrace();
1638 } catch (IOException e)
1647 * Write the data to a new entry of given name in the output jar file
1650 * @param jarEntryName
1652 * @throws IOException
1654 protected void writeJarEntry(JarOutputStream jout, String jarEntryName,
1655 byte[] data) throws IOException
1659 System.out.println("Writing jar entry " + jarEntryName);
1660 jout.putNextEntry(new JarEntry(jarEntryName));
1661 DataOutputStream dout = new DataOutputStream(jout);
1662 dout.write(data, 0, data.length);
1669 * Save the state of a structure viewer
1674 * the archive XML element under which to save the state
1677 * @param matchedFile
1681 protected String saveStructureState(AlignmentPanel ap, SequenceI jds,
1682 Pdbids pdb, PDBEntry entry, List<String> viewIds,
1683 String matchedFile, StructureViewerBase viewFrame)
1685 final AAStructureBindingModel bindingModel = viewFrame.getBinding();
1688 * Look for any bindings for this viewer to the PDB file of interest
1689 * (including part matches excluding chain id)
1691 for (int peid = 0; peid < bindingModel.getPdbCount(); peid++)
1693 final PDBEntry pdbentry = bindingModel.getPdbEntry(peid);
1694 final String pdbId = pdbentry.getId();
1695 if (!pdbId.equals(entry.getId())
1696 && !(entry.getId().length() > 4 && entry.getId().toLowerCase()
1697 .startsWith(pdbId.toLowerCase())))
1700 * not interested in a binding to a different PDB entry here
1704 if (matchedFile == null)
1706 matchedFile = pdbentry.getFile();
1708 else if (!matchedFile.equals(pdbentry.getFile()))
1711 "Probably lost some PDB-Sequence mappings for this structure file (which apparently has same PDB Entry code): "
1712 + pdbentry.getFile());
1716 // can get at it if the ID
1717 // match is ambiguous (e.g.
1720 for (int smap = 0; smap < viewFrame.getBinding()
1721 .getSequence()[peid].length; smap++)
1723 // if (jal.findIndex(jmol.jmb.sequence[peid][smap]) > -1)
1724 if (jds == viewFrame.getBinding().getSequence()[peid][smap])
1726 StructureState state = new StructureState();
1727 state.setVisible(true);
1728 state.setXpos(viewFrame.getX());
1729 state.setYpos(viewFrame.getY());
1730 state.setWidth(viewFrame.getWidth());
1731 state.setHeight(viewFrame.getHeight());
1732 final String viewId = viewFrame.getViewId();
1733 state.setViewId(viewId);
1734 state.setAlignwithAlignPanel(viewFrame.isUsedforaligment(ap));
1735 state.setColourwithAlignPanel(viewFrame.isUsedforcolourby(ap));
1736 state.setColourByJmol(viewFrame.isColouredByViewer());
1737 state.setType(viewFrame.getViewerType().toString());
1738 pdb.addStructureState(state);
1746 * Populates the AnnotationColours xml for save. This captures the settings of
1747 * the options in the 'Colour by Annotation' dialog.
1750 * @param userColours
1754 private AnnotationColours constructAnnotationColours(
1755 AnnotationColourGradient acg, List<UserColourScheme> userColours,
1756 JalviewModelSequence jms)
1758 AnnotationColours ac = new AnnotationColours();
1759 ac.setAboveThreshold(acg.getAboveThreshold());
1760 ac.setThreshold(acg.getAnnotationThreshold());
1761 // 2.10.2 save annotationId (unique) not annotation label
1762 ac.setAnnotation(acg.getAnnotation().annotationId);
1763 if (acg.getBaseColour() instanceof UserColourScheme)
1766 setUserColourScheme(acg.getBaseColour(), userColours, jms));
1771 ColourSchemeProperty.getColourName(acg.getBaseColour()));
1774 ac.setMaxColour(acg.getMaxColour().getRGB());
1775 ac.setMinColour(acg.getMinColour().getRGB());
1776 ac.setPerSequence(acg.isSeqAssociated());
1777 ac.setPredefinedColours(acg.isPredefinedColours());
1781 private void storeAlignmentAnnotation(AlignmentAnnotation[] aa,
1782 IdentityHashMap<SequenceGroup, String> groupRefs,
1783 AlignmentViewport av, Set<String> calcIdSet, boolean storeDS,
1784 SequenceSet vamsasSet)
1787 for (int i = 0; i < aa.length; i++)
1789 Annotation an = new Annotation();
1791 AlignmentAnnotation annotation = aa[i];
1792 if (annotation.annotationId != null)
1794 annotationIds.put(annotation.annotationId, annotation);
1797 an.setId(annotation.annotationId);
1799 an.setVisible(annotation.visible);
1801 an.setDescription(annotation.description);
1803 if (annotation.sequenceRef != null)
1805 // 2.9 JAL-1781 xref on sequence id rather than name
1806 an.setSequenceRef(seqsToIds.get(annotation.sequenceRef));
1808 if (annotation.groupRef != null)
1810 String groupIdr = groupRefs.get(annotation.groupRef);
1811 if (groupIdr == null)
1813 // make a locally unique String
1814 groupRefs.put(annotation.groupRef,
1815 groupIdr = ("" + System.currentTimeMillis()
1816 + annotation.groupRef.getName()
1817 + groupRefs.size()));
1819 an.setGroupRef(groupIdr.toString());
1822 // store all visualization attributes for annotation
1823 an.setGraphHeight(annotation.graphHeight);
1824 an.setCentreColLabels(annotation.centreColLabels);
1825 an.setScaleColLabels(annotation.scaleColLabel);
1826 an.setShowAllColLabels(annotation.showAllColLabels);
1827 an.setBelowAlignment(annotation.belowAlignment);
1829 if (annotation.graph > 0)
1832 an.setGraphType(annotation.graph);
1833 an.setGraphGroup(annotation.graphGroup);
1834 if (annotation.getThreshold() != null)
1836 ThresholdLine line = new ThresholdLine();
1837 line.setLabel(annotation.getThreshold().label);
1838 line.setValue(annotation.getThreshold().value);
1839 line.setColour(annotation.getThreshold().colour.getRGB());
1840 an.setThresholdLine(line);
1848 an.setLabel(annotation.label);
1850 if (annotation == av.getAlignmentQualityAnnot()
1851 || annotation == av.getAlignmentConservationAnnotation()
1852 || annotation == av.getAlignmentConsensusAnnotation()
1853 || annotation.autoCalculated)
1855 // new way of indicating autocalculated annotation -
1856 an.setAutoCalculated(annotation.autoCalculated);
1858 if (annotation.hasScore())
1860 an.setScore(annotation.getScore());
1863 if (annotation.getCalcId() != null)
1865 calcIdSet.add(annotation.getCalcId());
1866 an.setCalcId(annotation.getCalcId());
1868 if (annotation.hasProperties())
1870 for (String pr : annotation.getProperties())
1872 Property prop = new Property();
1874 prop.setValue(annotation.getProperty(pr));
1875 an.addProperty(prop);
1879 AnnotationElement ae;
1880 if (annotation.annotations != null)
1882 an.setScoreOnly(false);
1883 for (int a = 0; a < annotation.annotations.length; a++)
1885 if ((annotation == null) || (annotation.annotations[a] == null))
1890 ae = new AnnotationElement();
1891 if (annotation.annotations[a].description != null)
1893 ae.setDescription(annotation.annotations[a].description);
1895 if (annotation.annotations[a].displayCharacter != null)
1897 ae.setDisplayCharacter(
1898 annotation.annotations[a].displayCharacter);
1901 if (!Float.isNaN(annotation.annotations[a].value))
1903 ae.setValue(annotation.annotations[a].value);
1907 if (annotation.annotations[a].secondaryStructure > ' ')
1909 ae.setSecondaryStructure(
1910 annotation.annotations[a].secondaryStructure + "");
1913 if (annotation.annotations[a].colour != null
1914 && annotation.annotations[a].colour != java.awt.Color.black)
1916 ae.setColour(annotation.annotations[a].colour.getRGB());
1919 an.addAnnotationElement(ae);
1920 if (annotation.autoCalculated)
1922 // only write one non-null entry into the annotation row -
1923 // sufficient to get the visualization attributes necessary to
1931 an.setScoreOnly(true);
1933 if (!storeDS || (storeDS && !annotation.autoCalculated))
1935 // skip autocalculated annotation - these are only provided for
1937 vamsasSet.addAnnotation(an);
1943 private CalcIdParam createCalcIdParam(String calcId, AlignViewport av)
1945 AutoCalcSetting settings = av.getCalcIdSettingsFor(calcId);
1946 if (settings != null)
1948 CalcIdParam vCalcIdParam = new CalcIdParam();
1949 vCalcIdParam.setCalcId(calcId);
1950 vCalcIdParam.addServiceURL(settings.getServiceURI());
1951 // generic URI allowing a third party to resolve another instance of the
1952 // service used for this calculation
1953 for (String urls : settings.getServiceURLs())
1955 vCalcIdParam.addServiceURL(urls);
1957 vCalcIdParam.setVersion("1.0");
1958 if (settings.getPreset() != null)
1960 WsParamSetI setting = settings.getPreset();
1961 vCalcIdParam.setName(setting.getName());
1962 vCalcIdParam.setDescription(setting.getDescription());
1966 vCalcIdParam.setName("");
1967 vCalcIdParam.setDescription("Last used parameters");
1969 // need to be able to recover 1) settings 2) user-defined presets or
1970 // recreate settings from preset 3) predefined settings provided by
1971 // service - or settings that can be transferred (or discarded)
1972 vCalcIdParam.setParameters(
1973 settings.getWsParamFile().replace("\n", "|\\n|"));
1974 vCalcIdParam.setAutoUpdate(settings.isAutoUpdate());
1975 // todo - decide if updateImmediately is needed for any projects.
1977 return vCalcIdParam;
1982 private boolean recoverCalcIdParam(CalcIdParam calcIdParam,
1985 if (calcIdParam.getVersion().equals("1.0"))
1987 Jws2Instance service = Jws2Discoverer.getDiscoverer()
1988 .getPreferredServiceFor(calcIdParam.getServiceURL());
1989 if (service != null)
1991 WsParamSetI parmSet = null;
1994 parmSet = service.getParamStore().parseServiceParameterFile(
1995 calcIdParam.getName(), calcIdParam.getDescription(),
1996 calcIdParam.getServiceURL(),
1997 calcIdParam.getParameters().replace("|\\n|", "\n"));
1998 } catch (IOException x)
2000 warn("Couldn't parse parameter data for "
2001 + calcIdParam.getCalcId(), x);
2004 List<ArgumentI> argList = null;
2005 if (calcIdParam.getName().length() > 0)
2007 parmSet = service.getParamStore()
2008 .getPreset(calcIdParam.getName());
2009 if (parmSet != null)
2011 // TODO : check we have a good match with settings in AACon -
2012 // otherwise we'll need to create a new preset
2017 argList = parmSet.getArguments();
2020 AAConSettings settings = new AAConSettings(
2021 calcIdParam.isAutoUpdate(), service, parmSet, argList);
2022 av.setCalcIdSettingsFor(calcIdParam.getCalcId(), settings,
2023 calcIdParam.isNeedsUpdate());
2028 warn("Cannot resolve a service for the parameters used in this project. Try configuring a JABAWS server.");
2032 throw new Error(MessageManager.formatMessage(
2033 "error.unsupported_version_calcIdparam", new Object[]
2034 { calcIdParam.toString() }));
2038 * External mapping between jalview objects and objects yielding a valid and
2039 * unique object ID string. This is null for normal Jalview project IO, but
2040 * non-null when a jalview project is being read or written as part of a
2043 IdentityHashMap jv2vobj = null;
2046 * Construct a unique ID for jvobj using either existing bindings or if none
2047 * exist, the result of the hashcode call for the object.
2050 * jalview data object
2051 * @return unique ID for referring to jvobj
2053 private String makeHashCode(Object jvobj, String altCode)
2055 if (jv2vobj != null)
2057 Object id = jv2vobj.get(jvobj);
2060 return id.toString();
2062 // check string ID mappings
2063 if (jvids2vobj != null && jvobj instanceof String)
2065 id = jvids2vobj.get(jvobj);
2069 return id.toString();
2071 // give up and warn that something has gone wrong
2072 warn("Cannot find ID for object in external mapping : " + jvobj);
2078 * return local jalview object mapped to ID, if it exists
2082 * @return null or object bound to idcode
2084 private Object retrieveExistingObj(String idcode)
2086 if (idcode != null && vobj2jv != null)
2088 return vobj2jv.get(idcode);
2094 * binding from ID strings from external mapping table to jalview data model
2097 private Hashtable vobj2jv;
2099 private Sequence createVamsasSequence(String id, SequenceI jds)
2101 return createVamsasSequence(true, id, jds, null);
2104 private Sequence createVamsasSequence(boolean recurse, String id,
2105 SequenceI jds, SequenceI parentseq)
2107 Sequence vamsasSeq = new Sequence();
2108 vamsasSeq.setId(id);
2109 vamsasSeq.setName(jds.getName());
2110 vamsasSeq.setSequence(jds.getSequenceAsString());
2111 vamsasSeq.setDescription(jds.getDescription());
2112 jalview.datamodel.DBRefEntry[] dbrefs = null;
2113 if (jds.getDatasetSequence() != null)
2115 vamsasSeq.setDsseqid(seqHash(jds.getDatasetSequence()));
2119 // seqId==dsseqid so we can tell which sequences really are
2120 // dataset sequences only
2121 vamsasSeq.setDsseqid(id);
2122 dbrefs = jds.getDBRefs();
2123 if (parentseq == null)
2130 for (int d = 0; d < dbrefs.length; d++)
2132 DBRef dbref = new DBRef();
2133 dbref.setSource(dbrefs[d].getSource());
2134 dbref.setVersion(dbrefs[d].getVersion());
2135 dbref.setAccessionId(dbrefs[d].getAccessionId());
2136 if (dbrefs[d].hasMap())
2138 Mapping mp = createVamsasMapping(dbrefs[d].getMap(), parentseq,
2140 dbref.setMapping(mp);
2142 vamsasSeq.addDBRef(dbref);
2148 private Mapping createVamsasMapping(jalview.datamodel.Mapping jmp,
2149 SequenceI parentseq, SequenceI jds, boolean recurse)
2152 if (jmp.getMap() != null)
2156 jalview.util.MapList mlst = jmp.getMap();
2157 List<int[]> r = mlst.getFromRanges();
2158 for (int[] range : r)
2160 MapListFrom mfrom = new MapListFrom();
2161 mfrom.setStart(range[0]);
2162 mfrom.setEnd(range[1]);
2163 mp.addMapListFrom(mfrom);
2165 r = mlst.getToRanges();
2166 for (int[] range : r)
2168 MapListTo mto = new MapListTo();
2169 mto.setStart(range[0]);
2170 mto.setEnd(range[1]);
2171 mp.addMapListTo(mto);
2173 mp.setMapFromUnit(mlst.getFromRatio());
2174 mp.setMapToUnit(mlst.getToRatio());
2175 if (jmp.getTo() != null)
2177 MappingChoice mpc = new MappingChoice();
2179 // check/create ID for the sequence referenced by getTo()
2182 SequenceI ps = null;
2183 if (parentseq != jmp.getTo()
2184 && parentseq.getDatasetSequence() != jmp.getTo())
2186 // chaining dbref rather than a handshaking one
2187 jmpid = seqHash(ps = jmp.getTo());
2191 jmpid = seqHash(ps = parentseq);
2193 mpc.setDseqFor(jmpid);
2194 if (!seqRefIds.containsKey(mpc.getDseqFor()))
2196 jalview.bin.Cache.log.debug("creatign new DseqFor ID");
2197 seqRefIds.put(mpc.getDseqFor(), ps);
2201 jalview.bin.Cache.log.debug("reusing DseqFor ID");
2204 mp.setMappingChoice(mpc);
2210 String setUserColourScheme(jalview.schemes.ColourSchemeI cs,
2211 List<UserColourScheme> userColours, JalviewModelSequence jms)
2214 jalview.schemes.UserColourScheme ucs = (jalview.schemes.UserColourScheme) cs;
2215 boolean newucs = false;
2216 if (!userColours.contains(ucs))
2218 userColours.add(ucs);
2221 id = "ucs" + userColours.indexOf(ucs);
2224 // actually create the scheme's entry in the XML model
2225 java.awt.Color[] colours = ucs.getColours();
2226 jalview.schemabinding.version2.UserColours uc = new jalview.schemabinding.version2.UserColours();
2227 jalview.schemabinding.version2.UserColourScheme jbucs = new jalview.schemabinding.version2.UserColourScheme();
2229 for (int i = 0; i < colours.length; i++)
2231 jalview.schemabinding.version2.Colour col = new jalview.schemabinding.version2.Colour();
2232 col.setName(ResidueProperties.aa[i]);
2233 col.setRGB(jalview.util.Format.getHexString(colours[i]));
2234 jbucs.addColour(col);
2236 if (ucs.getLowerCaseColours() != null)
2238 colours = ucs.getLowerCaseColours();
2239 for (int i = 0; i < colours.length; i++)
2241 jalview.schemabinding.version2.Colour col = new jalview.schemabinding.version2.Colour();
2242 col.setName(ResidueProperties.aa[i].toLowerCase());
2243 col.setRGB(jalview.util.Format.getHexString(colours[i]));
2244 jbucs.addColour(col);
2249 uc.setUserColourScheme(jbucs);
2250 jms.addUserColours(uc);
2256 jalview.schemes.UserColourScheme getUserColourScheme(
2257 JalviewModelSequence jms, String id)
2259 UserColours[] uc = jms.getUserColours();
2260 UserColours colours = null;
2262 for (int i = 0; i < uc.length; i++)
2264 if (uc[i].getId().equals(id))
2272 java.awt.Color[] newColours = new java.awt.Color[24];
2274 for (int i = 0; i < 24; i++)
2276 newColours[i] = new java.awt.Color(Integer.parseInt(
2277 colours.getUserColourScheme().getColour(i).getRGB(), 16));
2280 jalview.schemes.UserColourScheme ucs = new jalview.schemes.UserColourScheme(
2283 if (colours.getUserColourScheme().getColourCount() > 24)
2285 newColours = new java.awt.Color[23];
2286 for (int i = 0; i < 23; i++)
2288 newColours[i] = new java.awt.Color(Integer.parseInt(
2289 colours.getUserColourScheme().getColour(i + 24).getRGB(),
2292 ucs.setLowerCaseColours(newColours);
2299 * contains last error message (if any) encountered by XML loader.
2301 String errorMessage = null;
2304 * flag to control whether the Jalview2XML_V1 parser should be deferred to if
2305 * exceptions are raised during project XML parsing
2307 public boolean attemptversion1parse = true;
2310 * Load a jalview project archive from a jar file
2313 * - HTTP URL or filename
2315 public AlignFrame loadJalviewAlign(final String file)
2318 jalview.gui.AlignFrame af = null;
2322 // create list to store references for any new Jmol viewers created
2323 newStructureViewers = new Vector<>();
2324 // UNMARSHALLER SEEMS TO CLOSE JARINPUTSTREAM, MOST ANNOYING
2325 // Workaround is to make sure caller implements the JarInputStreamProvider
2327 // so we can re-open the jar input stream for each entry.
2329 jarInputStreamProvider jprovider = createjarInputStreamProvider(file);
2330 af = loadJalviewAlign(jprovider);
2331 af.setMenusForViewport();
2333 } catch (MalformedURLException e)
2335 errorMessage = "Invalid URL format for '" + file + "'";
2341 SwingUtilities.invokeAndWait(new Runnable()
2346 setLoadingFinishedForNewStructureViewers();
2349 } catch (Exception x)
2351 System.err.println("Error loading alignment: " + x.getMessage());
2357 private jarInputStreamProvider createjarInputStreamProvider(
2358 final String file) throws MalformedURLException
2361 errorMessage = null;
2362 uniqueSetSuffix = null;
2364 viewportsAdded.clear();
2365 frefedSequence = null;
2367 if (file.startsWith("http://"))
2369 url = new URL(file);
2371 final URL _url = url;
2372 return new jarInputStreamProvider()
2376 public JarInputStream getJarInputStream() throws IOException
2380 return new JarInputStream(_url.openStream());
2384 return new JarInputStream(new FileInputStream(file));
2389 public String getFilename()
2397 * Recover jalview session from a jalview project archive. Caller may
2398 * initialise uniqueSetSuffix, seqRefIds, viewportsAdded and frefedSequence
2399 * themselves. Any null fields will be initialised with default values,
2400 * non-null fields are left alone.
2405 public AlignFrame loadJalviewAlign(final jarInputStreamProvider jprovider)
2407 errorMessage = null;
2408 if (uniqueSetSuffix == null)
2410 uniqueSetSuffix = System.currentTimeMillis() % 100000 + "";
2412 if (seqRefIds == null)
2416 AlignFrame af = null, _af = null;
2417 IdentityHashMap<AlignmentI, AlignmentI> importedDatasets = new IdentityHashMap<>();
2418 Map<String, AlignFrame> gatherToThisFrame = new HashMap<>();
2419 final String file = jprovider.getFilename();
2422 JarInputStream jin = null;
2423 JarEntry jarentry = null;
2428 jin = jprovider.getJarInputStream();
2429 for (int i = 0; i < entryCount; i++)
2431 jarentry = jin.getNextJarEntry();
2434 if (jarentry != null && jarentry.getName().endsWith(".xml"))
2436 InputStreamReader in = new InputStreamReader(jin, UTF_8);
2437 JalviewModel object = new JalviewModel();
2439 Unmarshaller unmar = new Unmarshaller(object);
2440 unmar.setValidation(false);
2441 object = (JalviewModel) unmar.unmarshal(in);
2442 if (true) // !skipViewport(object))
2444 _af = loadFromObject(object, file, true, jprovider);
2445 if (_af != null && object.getJalviewModelSequence()
2446 .getViewportCount() > 0)
2450 // store a reference to the first view
2453 if (_af.viewport.isGatherViewsHere())
2455 // if this is a gathered view, keep its reference since
2456 // after gathering views, only this frame will remain
2458 gatherToThisFrame.put(_af.viewport.getSequenceSetId(), _af);
2460 // Save dataset to register mappings once all resolved
2461 importedDatasets.put(af.viewport.getAlignment().getDataset(),
2462 af.viewport.getAlignment().getDataset());
2467 else if (jarentry != null)
2469 // Some other file here.
2472 } while (jarentry != null);
2473 resolveFrefedSequences();
2474 } catch (IOException ex)
2476 ex.printStackTrace();
2477 errorMessage = "Couldn't locate Jalview XML file : " + file;
2479 "Exception whilst loading jalview XML file : " + ex + "\n");
2480 } catch (Exception ex)
2482 System.err.println("Parsing as Jalview Version 2 file failed.");
2483 ex.printStackTrace(System.err);
2484 if (attemptversion1parse)
2486 // Is Version 1 Jar file?
2489 af = new Jalview2XML_V1(raiseGUI).LoadJalviewAlign(jprovider);
2490 } catch (Exception ex2)
2492 System.err.println("Exception whilst loading as jalviewXMLV1:");
2493 ex2.printStackTrace();
2497 if (Desktop.instance != null)
2499 Desktop.instance.stopLoading();
2503 System.out.println("Successfully loaded archive file");
2506 ex.printStackTrace();
2509 "Exception whilst loading jalview XML file : " + ex + "\n");
2510 } catch (OutOfMemoryError e)
2512 // Don't use the OOM Window here
2513 errorMessage = "Out of memory loading jalview XML file";
2514 System.err.println("Out of memory whilst loading jalview XML file");
2515 e.printStackTrace();
2519 * Regather multiple views (with the same sequence set id) to the frame (if
2520 * any) that is flagged as the one to gather to, i.e. convert them to tabbed
2521 * views instead of separate frames. Note this doesn't restore a state where
2522 * some expanded views in turn have tabbed views - the last "first tab" read
2523 * in will play the role of gatherer for all.
2525 for (AlignFrame fr : gatherToThisFrame.values())
2527 Desktop.instance.gatherViews(fr);
2530 restoreSplitFrames();
2531 for (AlignmentI ds : importedDatasets.keySet())
2533 if (ds.getCodonFrames() != null)
2535 StructureSelectionManager
2536 .getStructureSelectionManager(Desktop.instance)
2537 .registerMappings(ds.getCodonFrames());
2540 if (errorMessage != null)
2545 if (Desktop.instance != null)
2547 Desktop.instance.stopLoading();
2554 * Try to reconstruct and display SplitFrame windows, where each contains
2555 * complementary dna and protein alignments. Done by pairing up AlignFrame
2556 * objects (created earlier) which have complementary viewport ids associated.
2558 protected void restoreSplitFrames()
2560 List<SplitFrame> gatherTo = new ArrayList<>();
2561 List<AlignFrame> addedToSplitFrames = new ArrayList<>();
2562 Map<String, AlignFrame> dna = new HashMap<>();
2565 * Identify the DNA alignments
2567 for (Entry<Viewport, AlignFrame> candidate : splitFrameCandidates
2570 AlignFrame af = candidate.getValue();
2571 if (af.getViewport().getAlignment().isNucleotide())
2573 dna.put(candidate.getKey().getId(), af);
2578 * Try to match up the protein complements
2580 for (Entry<Viewport, AlignFrame> candidate : splitFrameCandidates
2583 AlignFrame af = candidate.getValue();
2584 if (!af.getViewport().getAlignment().isNucleotide())
2586 String complementId = candidate.getKey().getComplementId();
2587 // only non-null complements should be in the Map
2588 if (complementId != null && dna.containsKey(complementId))
2590 final AlignFrame dnaFrame = dna.get(complementId);
2591 SplitFrame sf = createSplitFrame(dnaFrame, af);
2592 addedToSplitFrames.add(dnaFrame);
2593 addedToSplitFrames.add(af);
2594 dnaFrame.setMenusForViewport();
2595 af.setMenusForViewport();
2596 if (af.viewport.isGatherViewsHere())
2605 * Open any that we failed to pair up (which shouldn't happen!) as
2606 * standalone AlignFrame's.
2608 for (Entry<Viewport, AlignFrame> candidate : splitFrameCandidates
2611 AlignFrame af = candidate.getValue();
2612 if (!addedToSplitFrames.contains(af))
2614 Viewport view = candidate.getKey();
2615 Desktop.addInternalFrame(af, view.getTitle(), view.getWidth(),
2617 af.setMenusForViewport();
2618 System.err.println("Failed to restore view " + view.getTitle()
2619 + " to split frame");
2624 * Gather back into tabbed views as flagged.
2626 for (SplitFrame sf : gatherTo)
2628 Desktop.instance.gatherViews(sf);
2631 splitFrameCandidates.clear();
2635 * Construct and display one SplitFrame holding DNA and protein alignments.
2638 * @param proteinFrame
2641 protected SplitFrame createSplitFrame(AlignFrame dnaFrame,
2642 AlignFrame proteinFrame)
2644 SplitFrame splitFrame = new SplitFrame(dnaFrame, proteinFrame);
2645 String title = MessageManager.getString("label.linked_view_title");
2646 int width = (int) dnaFrame.getBounds().getWidth();
2647 int height = (int) (dnaFrame.getBounds().getHeight()
2648 + proteinFrame.getBounds().getHeight() + 50);
2651 * SplitFrame location is saved to both enclosed frames
2653 splitFrame.setLocation(dnaFrame.getX(), dnaFrame.getY());
2654 Desktop.addInternalFrame(splitFrame, title, width, height);
2657 * And compute cDNA consensus (couldn't do earlier with consensus as
2658 * mappings were not yet present)
2660 proteinFrame.viewport.alignmentChanged(proteinFrame.alignPanel);
2666 * check errorMessage for a valid error message and raise an error box in the
2667 * GUI or write the current errorMessage to stderr and then clear the error
2670 protected void reportErrors()
2672 reportErrors(false);
2675 protected void reportErrors(final boolean saving)
2677 if (errorMessage != null)
2679 final String finalErrorMessage = errorMessage;
2680 errorMessage = null;
2683 javax.swing.SwingUtilities.invokeLater(new Runnable()
2688 JvOptionPane.showInternalMessageDialog(Desktop.desktop,
2690 "Error " + (saving ? "saving" : "loading")
2692 JvOptionPane.WARNING_MESSAGE);
2699 "Problem loading Jalview file: " + finalErrorMessage);
2704 Map<String, String> alreadyLoadedPDB = new HashMap<>();
2707 * when set, local views will be updated from view stored in JalviewXML
2708 * Currently (28th Sep 2008) things will go horribly wrong in vamsas document
2709 * sync if this is set to true.
2711 private final boolean updateLocalViews = false;
2714 * Returns the path to a temporary file holding the PDB file for the given PDB
2715 * id. The first time of asking, searches for a file of that name in the
2716 * Jalview project jar, and copies it to a new temporary file. Any repeat
2717 * requests just return the path to the file previously created.
2723 String loadPDBFile(jarInputStreamProvider jprovider, String pdbId,
2726 if (alreadyLoadedPDB.containsKey(pdbId))
2728 return alreadyLoadedPDB.get(pdbId).toString();
2731 String tempFile = copyJarEntry(jprovider, pdbId, "jalview_pdb",
2733 if (tempFile != null)
2735 alreadyLoadedPDB.put(pdbId, tempFile);
2741 * Copies the jar entry of given name to a new temporary file and returns the
2742 * path to the file, or null if the entry is not found.
2745 * @param jarEntryName
2747 * a prefix for the temporary file name, must be at least three
2750 * null or original file - so new file can be given the same suffix
2754 protected String copyJarEntry(jarInputStreamProvider jprovider,
2755 String jarEntryName, String prefix, String origFile)
2757 BufferedReader in = null;
2758 PrintWriter out = null;
2759 String suffix = ".tmp";
2760 if (origFile == null)
2762 origFile = jarEntryName;
2764 int sfpos = origFile.lastIndexOf(".");
2765 if (sfpos > -1 && sfpos < (origFile.length() - 3))
2767 suffix = "." + origFile.substring(sfpos + 1);
2771 JarInputStream jin = jprovider.getJarInputStream();
2773 * if (jprovider.startsWith("http://")) { jin = new JarInputStream(new
2774 * URL(jprovider).openStream()); } else { jin = new JarInputStream(new
2775 * FileInputStream(jprovider)); }
2778 JarEntry entry = null;
2781 entry = jin.getNextJarEntry();
2782 } while (entry != null && !entry.getName().equals(jarEntryName));
2785 in = new BufferedReader(new InputStreamReader(jin, UTF_8));
2786 File outFile = File.createTempFile(prefix, suffix);
2787 outFile.deleteOnExit();
2788 out = new PrintWriter(new FileOutputStream(outFile));
2791 while ((data = in.readLine()) != null)
2796 String t = outFile.getAbsolutePath();
2801 warn("Couldn't find entry in Jalview Jar for " + jarEntryName);
2803 } catch (Exception ex)
2805 ex.printStackTrace();
2813 } catch (IOException e)
2827 private class JvAnnotRow
2829 public JvAnnotRow(int i, AlignmentAnnotation jaa)
2836 * persisted version of annotation row from which to take vis properties
2838 public jalview.datamodel.AlignmentAnnotation template;
2841 * original position of the annotation row in the alignment
2847 * Load alignment frame from jalview XML DOM object
2852 * filename source string
2853 * @param loadTreesAndStructures
2854 * when false only create Viewport
2856 * data source provider
2857 * @return alignment frame created from view stored in DOM
2859 AlignFrame loadFromObject(JalviewModel object, String file,
2860 boolean loadTreesAndStructures, jarInputStreamProvider jprovider)
2862 SequenceSet vamsasSet = object.getVamsasModel().getSequenceSet(0);
2863 Sequence[] vamsasSeq = vamsasSet.getSequence();
2865 JalviewModelSequence jms = object.getJalviewModelSequence();
2867 Viewport view = (jms.getViewportCount() > 0) ? jms.getViewport(0)
2870 // ////////////////////////////////
2873 List<SequenceI> hiddenSeqs = null;
2875 List<SequenceI> tmpseqs = new ArrayList<>();
2877 boolean multipleView = false;
2878 SequenceI referenceseqForView = null;
2879 JSeq[] jseqs = object.getJalviewModelSequence().getJSeq();
2880 int vi = 0; // counter in vamsasSeq array
2881 for (int i = 0; i < jseqs.length; i++)
2883 String seqId = jseqs[i].getId();
2885 SequenceI tmpSeq = seqRefIds.get(seqId);
2888 if (!incompleteSeqs.containsKey(seqId))
2890 // may not need this check, but keep it for at least 2.9,1 release
2891 if (tmpSeq.getStart() != jseqs[i].getStart()
2892 || tmpSeq.getEnd() != jseqs[i].getEnd())
2895 "Warning JAL-2154 regression: updating start/end for sequence "
2896 + tmpSeq.toString() + " to " + jseqs[i]);
2901 incompleteSeqs.remove(seqId);
2903 if (vamsasSeq.length > vi && vamsasSeq[vi].getId().equals(seqId))
2905 // most likely we are reading a dataset XML document so
2906 // update from vamsasSeq section of XML for this sequence
2907 tmpSeq.setName(vamsasSeq[vi].getName());
2908 tmpSeq.setDescription(vamsasSeq[vi].getDescription());
2909 tmpSeq.setSequence(vamsasSeq[vi].getSequence());
2914 // reading multiple views, so vamsasSeq set is a subset of JSeq
2915 multipleView = true;
2917 tmpSeq.setStart(jseqs[i].getStart());
2918 tmpSeq.setEnd(jseqs[i].getEnd());
2919 tmpseqs.add(tmpSeq);
2923 tmpSeq = new jalview.datamodel.Sequence(vamsasSeq[vi].getName(),
2924 vamsasSeq[vi].getSequence());
2925 tmpSeq.setDescription(vamsasSeq[vi].getDescription());
2926 tmpSeq.setStart(jseqs[i].getStart());
2927 tmpSeq.setEnd(jseqs[i].getEnd());
2928 tmpSeq.setVamsasId(uniqueSetSuffix + seqId);
2929 seqRefIds.put(vamsasSeq[vi].getId(), tmpSeq);
2930 tmpseqs.add(tmpSeq);
2934 if (jseqs[i].hasViewreference() && jseqs[i].getViewreference())
2936 referenceseqForView = tmpseqs.get(tmpseqs.size() - 1);
2939 if (jseqs[i].getHidden())
2941 if (hiddenSeqs == null)
2943 hiddenSeqs = new ArrayList<>();
2946 hiddenSeqs.add(tmpSeq);
2951 // Create the alignment object from the sequence set
2952 // ///////////////////////////////
2953 SequenceI[] orderedSeqs = tmpseqs
2954 .toArray(new SequenceI[tmpseqs.size()]);
2956 AlignmentI al = null;
2957 // so we must create or recover the dataset alignment before going further
2958 // ///////////////////////////////
2959 if (vamsasSet.getDatasetId() == null || vamsasSet.getDatasetId() == "")
2961 // older jalview projects do not have a dataset - so creat alignment and
2963 al = new Alignment(orderedSeqs);
2964 al.setDataset(null);
2968 boolean isdsal = object.getJalviewModelSequence()
2969 .getViewportCount() == 0;
2972 // we are importing a dataset record, so
2973 // recover reference to an alignment already materialsed as dataset
2974 al = getDatasetFor(vamsasSet.getDatasetId());
2978 // materialse the alignment
2979 al = new Alignment(orderedSeqs);
2983 addDatasetRef(vamsasSet.getDatasetId(), al);
2986 // finally, verify all data in vamsasSet is actually present in al
2987 // passing on flag indicating if it is actually a stored dataset
2988 recoverDatasetFor(vamsasSet, al, isdsal);
2991 if (referenceseqForView != null)
2993 al.setSeqrep(referenceseqForView);
2995 // / Add the alignment properties
2996 for (int i = 0; i < vamsasSet.getSequenceSetPropertiesCount(); i++)
2998 SequenceSetProperties ssp = vamsasSet.getSequenceSetProperties(i);
2999 al.setProperty(ssp.getKey(), ssp.getValue());
3002 // ///////////////////////////////
3004 Hashtable pdbloaded = new Hashtable(); // TODO nothing writes to this??
3007 // load sequence features, database references and any associated PDB
3008 // structures for the alignment
3010 // prior to 2.10, this part would only be executed the first time a
3011 // sequence was encountered, but not afterwards.
3012 // now, for 2.10 projects, this is also done if the xml doc includes
3013 // dataset sequences not actually present in any particular view.
3015 for (int i = 0; i < vamsasSeq.length; i++)
3017 if (jseqs[i].getFeaturesCount() > 0)
3019 Features[] features = jseqs[i].getFeatures();
3020 for (int f = 0; f < features.length; f++)
3022 SequenceFeature sf = new SequenceFeature(features[f].getType(),
3023 features[f].getDescription(), features[f].getBegin(),
3024 features[f].getEnd(), features[f].getScore(),
3025 features[f].getFeatureGroup());
3026 sf.setStatus(features[f].getStatus());
3029 * load any feature attributes - include map-valued attributes
3031 Map<String, Map<String, String>> mapAttributes = new HashMap<>();
3032 for (int od = 0; od < features[f].getOtherDataCount(); od++)
3034 OtherData keyValue = features[f].getOtherData(od);
3035 String attributeName = keyValue.getKey();
3036 String attributeValue = keyValue.getValue();
3037 if (attributeName.startsWith("LINK"))
3039 sf.addLink(attributeValue);
3043 String subAttribute = keyValue.getKey2();
3044 if (subAttribute == null)
3046 // simple string-valued attribute
3047 sf.setValue(attributeName, attributeValue);
3051 // attribute 'key' has sub-attribute 'key2'
3052 if (!mapAttributes.containsKey(attributeName))
3054 mapAttributes.put(attributeName, new HashMap<>());
3056 mapAttributes.get(attributeName).put(subAttribute,
3061 for (Entry<String, Map<String, String>> mapAttribute : mapAttributes
3064 sf.setValue(mapAttribute.getKey(), mapAttribute.getValue());
3067 // adds feature to datasequence's feature set (since Jalview 2.10)
3068 al.getSequenceAt(i).addSequenceFeature(sf);
3071 if (vamsasSeq[i].getDBRefCount() > 0)
3073 // adds dbrefs to datasequence's set (since Jalview 2.10)
3075 al.getSequenceAt(i).getDatasetSequence() == null
3076 ? al.getSequenceAt(i)
3077 : al.getSequenceAt(i).getDatasetSequence(),
3080 if (jseqs[i].getPdbidsCount() > 0)
3082 Pdbids[] ids = jseqs[i].getPdbids();
3083 for (int p = 0; p < ids.length; p++)
3085 jalview.datamodel.PDBEntry entry = new jalview.datamodel.PDBEntry();
3086 entry.setId(ids[p].getId());
3087 if (ids[p].getType() != null)
3089 if (PDBEntry.Type.getType(ids[p].getType()) != null)
3091 entry.setType(PDBEntry.Type.getType(ids[p].getType()));
3095 entry.setType(PDBEntry.Type.FILE);
3098 // jprovider is null when executing 'New View'
3099 if (ids[p].getFile() != null && jprovider != null)
3101 if (!pdbloaded.containsKey(ids[p].getFile()))
3103 entry.setFile(loadPDBFile(jprovider, ids[p].getId(),
3108 entry.setFile(pdbloaded.get(ids[p].getId()).toString());
3111 if (ids[p].getPdbentryItem() != null)
3113 for (PdbentryItem item : ids[p].getPdbentryItem())
3115 for (Property pr : item.getProperty())
3117 entry.setProperty(pr.getName(), pr.getValue());
3121 StructureSelectionManager
3122 .getStructureSelectionManager(Desktop.instance)
3123 .registerPDBEntry(entry);
3124 // adds PDBEntry to datasequence's set (since Jalview 2.10)
3125 if (al.getSequenceAt(i).getDatasetSequence() != null)
3127 al.getSequenceAt(i).getDatasetSequence().addPDBId(entry);
3131 al.getSequenceAt(i).addPDBId(entry);
3136 } // end !multipleview
3138 // ///////////////////////////////
3139 // LOAD SEQUENCE MAPPINGS
3141 if (vamsasSet.getAlcodonFrameCount() > 0)
3143 // TODO Potentially this should only be done once for all views of an
3145 AlcodonFrame[] alc = vamsasSet.getAlcodonFrame();
3146 for (int i = 0; i < alc.length; i++)
3148 AlignedCodonFrame cf = new AlignedCodonFrame();
3149 if (alc[i].getAlcodMapCount() > 0)
3151 AlcodMap[] maps = alc[i].getAlcodMap();
3152 for (int m = 0; m < maps.length; m++)
3154 SequenceI dnaseq = seqRefIds.get(maps[m].getDnasq());
3156 jalview.datamodel.Mapping mapping = null;
3157 // attach to dna sequence reference.
3158 if (maps[m].getMapping() != null)
3160 mapping = addMapping(maps[m].getMapping());
3161 if (dnaseq != null && mapping.getTo() != null)
3163 cf.addMap(dnaseq, mapping.getTo(), mapping.getMap());
3169 newAlcodMapRef(maps[m].getDnasq(), cf, mapping));
3173 al.addCodonFrame(cf);
3178 // ////////////////////////////////
3180 List<JvAnnotRow> autoAlan = new ArrayList<>();
3183 * store any annotations which forward reference a group's ID
3185 Map<String, List<AlignmentAnnotation>> groupAnnotRefs = new Hashtable<>();
3187 if (vamsasSet.getAnnotationCount() > 0)
3189 Annotation[] an = vamsasSet.getAnnotation();
3191 for (int i = 0; i < an.length; i++)
3193 Annotation annotation = an[i];
3196 * test if annotation is automatically calculated for this view only
3198 boolean autoForView = false;
3199 if (annotation.getLabel().equals("Quality")
3200 || annotation.getLabel().equals("Conservation")
3201 || annotation.getLabel().equals("Consensus"))
3203 // Kludge for pre 2.5 projects which lacked the autocalculated flag
3205 if (!annotation.hasAutoCalculated())
3207 annotation.setAutoCalculated(true);
3210 if (autoForView || (annotation.hasAutoCalculated()
3211 && annotation.isAutoCalculated()))
3213 // remove ID - we don't recover annotation from other views for
3214 // view-specific annotation
3215 annotation.setId(null);
3218 // set visiblity for other annotation in this view
3219 String annotationId = annotation.getId();
3220 if (annotationId != null && annotationIds.containsKey(annotationId))
3222 AlignmentAnnotation jda = annotationIds.get(annotationId);
3223 // in principle Visible should always be true for annotation displayed
3224 // in multiple views
3225 if (annotation.hasVisible())
3227 jda.visible = annotation.getVisible();
3230 al.addAnnotation(jda);
3234 // Construct new annotation from model.
3235 AnnotationElement[] ae = annotation.getAnnotationElement();
3236 jalview.datamodel.Annotation[] anot = null;
3237 java.awt.Color firstColour = null;
3239 if (!annotation.getScoreOnly())
3241 anot = new jalview.datamodel.Annotation[al.getWidth()];
3242 for (int aa = 0; aa < ae.length && aa < anot.length; aa++)
3244 anpos = ae[aa].getPosition();
3246 if (anpos >= anot.length)
3251 anot[anpos] = new jalview.datamodel.Annotation(
3253 ae[aa].getDisplayCharacter(), ae[aa].getDescription(),
3254 (ae[aa].getSecondaryStructure() == null
3255 || ae[aa].getSecondaryStructure().length() == 0)
3257 : ae[aa].getSecondaryStructure()
3262 // JBPNote: Consider verifying dataflow for IO of secondary
3263 // structure annotation read from Stockholm files
3264 // this was added to try to ensure that
3265 // if (anot[ae[aa].getPosition()].secondaryStructure>' ')
3267 // anot[ae[aa].getPosition()].displayCharacter = "";
3269 anot[anpos].colour = new java.awt.Color(ae[aa].getColour());
3270 if (firstColour == null)
3272 firstColour = anot[anpos].colour;
3276 jalview.datamodel.AlignmentAnnotation jaa = null;
3278 if (annotation.getGraph())
3280 float llim = 0, hlim = 0;
3281 // if (autoForView || an[i].isAutoCalculated()) {
3284 jaa = new jalview.datamodel.AlignmentAnnotation(
3285 annotation.getLabel(), annotation.getDescription(), anot,
3286 llim, hlim, annotation.getGraphType());
3288 jaa.graphGroup = annotation.getGraphGroup();
3289 jaa._linecolour = firstColour;
3290 if (annotation.getThresholdLine() != null)
3292 jaa.setThreshold(new jalview.datamodel.GraphLine(
3293 annotation.getThresholdLine().getValue(),
3294 annotation.getThresholdLine().getLabel(),
3296 annotation.getThresholdLine().getColour())));
3299 if (autoForView || annotation.isAutoCalculated())
3301 // Hardwire the symbol display line to ensure that labels for
3302 // histograms are displayed
3308 jaa = new jalview.datamodel.AlignmentAnnotation(an[i].getLabel(),
3309 an[i].getDescription(), anot);
3310 jaa._linecolour = firstColour;
3312 // register new annotation
3313 if (an[i].getId() != null)
3315 annotationIds.put(an[i].getId(), jaa);
3316 jaa.annotationId = an[i].getId();
3318 // recover sequence association
3319 String sequenceRef = an[i].getSequenceRef();
3320 if (sequenceRef != null)
3322 // from 2.9 sequenceRef is to sequence id (JAL-1781)
3323 SequenceI sequence = seqRefIds.get(sequenceRef);
3324 if (sequence == null)
3326 // in pre-2.9 projects sequence ref is to sequence name
3327 sequence = al.findName(sequenceRef);
3329 if (sequence != null)
3331 jaa.createSequenceMapping(sequence, 1, true);
3332 sequence.addAlignmentAnnotation(jaa);
3335 // and make a note of any group association
3336 if (an[i].getGroupRef() != null && an[i].getGroupRef().length() > 0)
3338 List<jalview.datamodel.AlignmentAnnotation> aal = groupAnnotRefs
3339 .get(an[i].getGroupRef());
3342 aal = new ArrayList<>();
3343 groupAnnotRefs.put(an[i].getGroupRef(), aal);
3348 if (an[i].hasScore())
3350 jaa.setScore(an[i].getScore());
3352 if (an[i].hasVisible())
3354 jaa.visible = an[i].getVisible();
3357 if (an[i].hasCentreColLabels())
3359 jaa.centreColLabels = an[i].getCentreColLabels();
3362 if (an[i].hasScaleColLabels())
3364 jaa.scaleColLabel = an[i].getScaleColLabels();
3366 if (an[i].hasAutoCalculated() && an[i].isAutoCalculated())
3368 // newer files have an 'autoCalculated' flag and store calculation
3369 // state in viewport properties
3370 jaa.autoCalculated = true; // means annotation will be marked for
3371 // update at end of load.
3373 if (an[i].hasGraphHeight())
3375 jaa.graphHeight = an[i].getGraphHeight();
3377 if (an[i].hasBelowAlignment())
3379 jaa.belowAlignment = an[i].isBelowAlignment();
3381 jaa.setCalcId(an[i].getCalcId());
3382 if (an[i].getPropertyCount() > 0)
3384 for (jalview.schemabinding.version2.Property prop : an[i]
3387 jaa.setProperty(prop.getName(), prop.getValue());
3390 if (jaa.autoCalculated)
3392 autoAlan.add(new JvAnnotRow(i, jaa));
3395 // if (!autoForView)
3397 // add autocalculated group annotation and any user created annotation
3399 al.addAnnotation(jaa);
3403 // ///////////////////////
3405 // Create alignment markup and styles for this view
3406 if (jms.getJGroupCount() > 0)
3408 JGroup[] groups = jms.getJGroup();
3409 boolean addAnnotSchemeGroup = false;
3410 for (int i = 0; i < groups.length; i++)
3412 JGroup jGroup = groups[i];
3413 ColourSchemeI cs = null;
3414 if (jGroup.getColour() != null)
3416 if (jGroup.getColour().startsWith("ucs"))
3418 cs = getUserColourScheme(jms, jGroup.getColour());
3420 else if (jGroup.getColour().equals("AnnotationColourGradient")
3421 && jGroup.getAnnotationColours() != null)
3423 addAnnotSchemeGroup = true;
3427 cs = ColourSchemeProperty.getColourScheme(al,
3428 jGroup.getColour());
3431 int pidThreshold = jGroup.getPidThreshold();
3433 Vector<SequenceI> seqs = new Vector<>();
3435 for (int s = 0; s < jGroup.getSeqCount(); s++)
3437 String seqId = jGroup.getSeq(s) + "";
3438 SequenceI ts = seqRefIds.get(seqId);
3442 seqs.addElement(ts);
3446 if (seqs.size() < 1)
3451 SequenceGroup sg = new SequenceGroup(seqs, jGroup.getName(), cs,
3452 jGroup.getDisplayBoxes(), jGroup.getDisplayText(),
3453 jGroup.getColourText(), jGroup.getStart(), jGroup.getEnd());
3454 sg.getGroupColourScheme().setThreshold(pidThreshold, true);
3455 sg.getGroupColourScheme()
3456 .setConservationInc(jGroup.getConsThreshold());
3457 sg.setOutlineColour(new java.awt.Color(jGroup.getOutlineColour()));
3459 sg.textColour = new java.awt.Color(jGroup.getTextCol1());
3460 sg.textColour2 = new java.awt.Color(jGroup.getTextCol2());
3461 sg.setShowNonconserved(
3462 jGroup.hasShowUnconserved() ? jGroup.isShowUnconserved()
3464 sg.thresholdTextColour = jGroup.getTextColThreshold();
3465 if (jGroup.hasShowConsensusHistogram())
3467 sg.setShowConsensusHistogram(jGroup.isShowConsensusHistogram());
3470 if (jGroup.hasShowSequenceLogo())
3472 sg.setshowSequenceLogo(jGroup.isShowSequenceLogo());
3474 if (jGroup.hasNormaliseSequenceLogo())
3476 sg.setNormaliseSequenceLogo(jGroup.isNormaliseSequenceLogo());
3478 if (jGroup.hasIgnoreGapsinConsensus())
3480 sg.setIgnoreGapsConsensus(jGroup.getIgnoreGapsinConsensus());
3482 if (jGroup.getConsThreshold() != 0)
3484 Conservation c = new Conservation("All", sg.getSequences(null), 0,
3487 c.verdict(false, 25);
3488 sg.cs.setConservation(c);
3491 if (jGroup.getId() != null && groupAnnotRefs.size() > 0)
3493 // re-instate unique group/annotation row reference
3494 List<AlignmentAnnotation> jaal = groupAnnotRefs
3495 .get(jGroup.getId());
3498 for (AlignmentAnnotation jaa : jaal)
3501 if (jaa.autoCalculated)
3503 // match up and try to set group autocalc alignment row for this
3505 if (jaa.label.startsWith("Consensus for "))
3507 sg.setConsensus(jaa);
3509 // match up and try to set group autocalc alignment row for this
3511 if (jaa.label.startsWith("Conservation for "))
3513 sg.setConservationRow(jaa);
3520 if (addAnnotSchemeGroup)
3522 // reconstruct the annotation colourscheme
3523 sg.setColourScheme(constructAnnotationColour(
3524 jGroup.getAnnotationColours(), null, al, jms, false));
3530 // only dataset in this model, so just return.
3533 // ///////////////////////////////
3536 // If we just load in the same jar file again, the sequenceSetId
3537 // will be the same, and we end up with multiple references
3538 // to the same sequenceSet. We must modify this id on load
3539 // so that each load of the file gives a unique id
3540 String uniqueSeqSetId = view.getSequenceSetId() + uniqueSetSuffix;
3541 String viewId = (view.getId() == null ? null
3542 : view.getId() + uniqueSetSuffix);
3543 AlignFrame af = null;
3544 AlignViewport av = null;
3545 // now check to see if we really need to create a new viewport.
3546 if (multipleView && viewportsAdded.size() == 0)
3548 // We recovered an alignment for which a viewport already exists.
3549 // TODO: fix up any settings necessary for overlaying stored state onto
3550 // state recovered from another document. (may not be necessary).
3551 // we may need a binding from a viewport in memory to one recovered from
3553 // and then recover its containing af to allow the settings to be applied.
3554 // TODO: fix for vamsas demo
3556 "About to recover a viewport for existing alignment: Sequence set ID is "
3558 Object seqsetobj = retrieveExistingObj(uniqueSeqSetId);
3559 if (seqsetobj != null)
3561 if (seqsetobj instanceof String)
3563 uniqueSeqSetId = (String) seqsetobj;
3565 "Recovered extant sequence set ID mapping for ID : New Sequence set ID is "
3571 "Warning : Collision between sequence set ID string and existing jalview object mapping.");
3577 * indicate that annotation colours are applied across all groups (pre
3578 * Jalview 2.8.1 behaviour)
3580 boolean doGroupAnnColour = Jalview2XML.isVersionStringLaterThan("2.8.1",
3581 object.getVersion());
3583 AlignmentPanel ap = null;
3584 boolean isnewview = true;
3587 // Check to see if this alignment already has a view id == viewId
3588 jalview.gui.AlignmentPanel views[] = Desktop
3589 .getAlignmentPanels(uniqueSeqSetId);
3590 if (views != null && views.length > 0)
3592 for (int v = 0; v < views.length; v++)
3594 if (views[v].av.getViewId().equalsIgnoreCase(viewId))
3596 // recover the existing alignpanel, alignframe, viewport
3597 af = views[v].alignFrame;
3600 // TODO: could even skip resetting view settings if we don't want to
3601 // change the local settings from other jalview processes
3610 af = loadViewport(file, jseqs, hiddenSeqs, al, jms, view,
3611 uniqueSeqSetId, viewId, autoAlan);
3617 * Load any trees, PDB structures and viewers
3619 * Not done if flag is false (when this method is used for New View)
3621 if (loadTreesAndStructures)
3623 loadTrees(jms, view, af, av, ap);
3624 loadPDBStructures(jprovider, jseqs, af, ap);
3625 loadRnaViewers(jprovider, jseqs, ap);
3627 // and finally return.
3632 * Instantiate and link any saved RNA (Varna) viewers. The state of the Varna
3633 * panel is restored from separate jar entries, two (gapped and trimmed) per
3634 * sequence and secondary structure.
3636 * Currently each viewer shows just one sequence and structure (gapped and
3637 * trimmed), however this method is designed to support multiple sequences or
3638 * structures in viewers if wanted in future.
3644 private void loadRnaViewers(jarInputStreamProvider jprovider,
3645 JSeq[] jseqs, AlignmentPanel ap)
3648 * scan the sequences for references to viewers; create each one the first
3649 * time it is referenced, add Rna models to existing viewers
3651 for (JSeq jseq : jseqs)
3653 for (int i = 0; i < jseq.getRnaViewerCount(); i++)
3655 RnaViewer viewer = jseq.getRnaViewer(i);
3656 AppVarna appVarna = findOrCreateVarnaViewer(viewer, uniqueSetSuffix,
3659 for (int j = 0; j < viewer.getSecondaryStructureCount(); j++)
3661 SecondaryStructure ss = viewer.getSecondaryStructure(j);
3662 SequenceI seq = seqRefIds.get(jseq.getId());
3663 AlignmentAnnotation ann = this.annotationIds
3664 .get(ss.getAnnotationId());
3667 * add the structure to the Varna display (with session state copied
3668 * from the jar to a temporary file)
3670 boolean gapped = ss.isGapped();
3671 String rnaTitle = ss.getTitle();
3672 String sessionState = ss.getViewerState();
3673 String tempStateFile = copyJarEntry(jprovider, sessionState,
3675 RnaModel rna = new RnaModel(rnaTitle, ann, seq, null, gapped);
3676 appVarna.addModelSession(rna, rnaTitle, tempStateFile);
3678 appVarna.setInitialSelection(viewer.getSelectedRna());
3684 * Locate and return an already instantiated matching AppVarna, or create one
3688 * @param viewIdSuffix
3692 protected AppVarna findOrCreateVarnaViewer(RnaViewer viewer,
3693 String viewIdSuffix, AlignmentPanel ap)
3696 * on each load a suffix is appended to the saved viewId, to avoid conflicts
3697 * if load is repeated
3699 String postLoadId = viewer.getViewId() + viewIdSuffix;
3700 for (JInternalFrame frame : getAllFrames())
3702 if (frame instanceof AppVarna)
3704 AppVarna varna = (AppVarna) frame;
3705 if (postLoadId.equals(varna.getViewId()))
3707 // this viewer is already instantiated
3708 // could in future here add ap as another 'parent' of the
3709 // AppVarna window; currently just 1-to-many
3716 * viewer not found - make it
3718 RnaViewerModel model = new RnaViewerModel(postLoadId, viewer.getTitle(),
3719 viewer.getXpos(), viewer.getYpos(), viewer.getWidth(),
3720 viewer.getHeight(), viewer.getDividerLocation());
3721 AppVarna varna = new AppVarna(model, ap);
3727 * Load any saved trees
3735 protected void loadTrees(JalviewModelSequence jms, Viewport view,
3736 AlignFrame af, AlignViewport av, AlignmentPanel ap)
3738 // TODO result of automated refactoring - are all these parameters needed?
3741 for (int t = 0; t < jms.getTreeCount(); t++)
3744 Tree tree = jms.getTree(t);
3746 TreePanel tp = (TreePanel) retrieveExistingObj(tree.getId());
3749 tp = af.showNewickTree(
3750 new jalview.io.NewickFile(tree.getNewick()),
3751 tree.getTitle(), tree.getWidth(), tree.getHeight(),
3752 tree.getXpos(), tree.getYpos());
3753 if (tree.getId() != null)
3755 // perhaps bind the tree id to something ?
3760 // update local tree attributes ?
3761 // TODO: should check if tp has been manipulated by user - if so its
3762 // settings shouldn't be modified
3763 tp.setTitle(tree.getTitle());
3764 tp.setBounds(new Rectangle(tree.getXpos(), tree.getYpos(),
3765 tree.getWidth(), tree.getHeight()));
3766 tp.setViewport(av); // af.viewport; // TODO: verify 'associate with all
3769 tp.getTreeCanvas().setViewport(av); // af.viewport;
3770 tp.getTreeCanvas().setAssociatedPanel(ap); // af.alignPanel;
3775 warn("There was a problem recovering stored Newick tree: \n"
3776 + tree.getNewick());
3780 tp.fitToWindow.setState(tree.getFitToWindow());
3781 tp.fitToWindow_actionPerformed(null);
3783 if (tree.getFontName() != null)
3785 tp.setTreeFont(new java.awt.Font(tree.getFontName(),
3786 tree.getFontStyle(), tree.getFontSize()));
3790 tp.setTreeFont(new java.awt.Font(view.getFontName(),
3791 view.getFontStyle(), tree.getFontSize()));
3794 tp.showPlaceholders(tree.getMarkUnlinked());
3795 tp.showBootstrap(tree.getShowBootstrap());
3796 tp.showDistances(tree.getShowDistances());
3798 tp.getTreeCanvas().setThreshold(tree.getThreshold());
3800 if (tree.getCurrentTree())
3802 af.viewport.setCurrentTree(tp.getTree());
3806 } catch (Exception ex)
3808 ex.printStackTrace();
3813 * Load and link any saved structure viewers.
3820 protected void loadPDBStructures(jarInputStreamProvider jprovider,
3821 JSeq[] jseqs, AlignFrame af, AlignmentPanel ap)
3824 * Run through all PDB ids on the alignment, and collect mappings between
3825 * distinct view ids and all sequences referring to that view.
3827 Map<String, StructureViewerModel> structureViewers = new LinkedHashMap<>();
3829 for (int i = 0; i < jseqs.length; i++)
3831 if (jseqs[i].getPdbidsCount() > 0)
3833 Pdbids[] ids = jseqs[i].getPdbids();
3834 for (int p = 0; p < ids.length; p++)
3836 final int structureStateCount = ids[p].getStructureStateCount();
3837 for (int s = 0; s < structureStateCount; s++)
3839 // check to see if we haven't already created this structure view
3840 final StructureState structureState = ids[p]
3841 .getStructureState(s);
3842 String sviewid = (structureState.getViewId() == null) ? null
3843 : structureState.getViewId() + uniqueSetSuffix;
3844 jalview.datamodel.PDBEntry jpdb = new jalview.datamodel.PDBEntry();
3845 // Originally : ids[p].getFile()
3846 // : TODO: verify external PDB file recovery still works in normal
3847 // jalview project load
3848 jpdb.setFile(loadPDBFile(jprovider, ids[p].getId(),
3850 jpdb.setId(ids[p].getId());
3852 int x = structureState.getXpos();
3853 int y = structureState.getYpos();
3854 int width = structureState.getWidth();
3855 int height = structureState.getHeight();
3857 // Probably don't need to do this anymore...
3858 // Desktop.desktop.getComponentAt(x, y);
3859 // TODO: NOW: check that this recovers the PDB file correctly.
3860 String pdbFile = loadPDBFile(jprovider, ids[p].getId(),
3862 jalview.datamodel.SequenceI seq = seqRefIds
3863 .get(jseqs[i].getId() + "");
3864 if (sviewid == null)
3866 sviewid = "_jalview_pre2_4_" + x + "," + y + "," + width + ","
3869 if (!structureViewers.containsKey(sviewid))
3871 structureViewers.put(sviewid,
3872 new StructureViewerModel(x, y, width, height, false,
3873 false, true, structureState.getViewId(),
3874 structureState.getType()));
3875 // Legacy pre-2.7 conversion JAL-823 :
3876 // do not assume any view has to be linked for colour by
3880 // assemble String[] { pdb files }, String[] { id for each
3881 // file }, orig_fileloc, SequenceI[][] {{ seqs_file 1 }, {
3882 // seqs_file 2}, boolean[] {
3883 // linkAlignPanel,superposeWithAlignpanel}} from hash
3884 StructureViewerModel jmoldat = structureViewers.get(sviewid);
3885 jmoldat.setAlignWithPanel(jmoldat.isAlignWithPanel()
3886 | (structureState.hasAlignwithAlignPanel()
3887 ? structureState.getAlignwithAlignPanel()
3891 * Default colour by linked panel to false if not specified (e.g.
3892 * for pre-2.7 projects)
3894 boolean colourWithAlignPanel = jmoldat.isColourWithAlignPanel();
3895 colourWithAlignPanel |= (structureState
3896 .hasColourwithAlignPanel()
3897 ? structureState.getColourwithAlignPanel()
3899 jmoldat.setColourWithAlignPanel(colourWithAlignPanel);
3902 * Default colour by viewer to true if not specified (e.g. for
3905 boolean colourByViewer = jmoldat.isColourByViewer();
3906 colourByViewer &= structureState.hasColourByJmol()
3907 ? structureState.getColourByJmol()
3909 jmoldat.setColourByViewer(colourByViewer);
3911 if (jmoldat.getStateData().length() < structureState
3912 .getContent().length())
3915 jmoldat.setStateData(structureState.getContent());
3918 if (ids[p].getFile() != null)
3920 File mapkey = new File(ids[p].getFile());
3921 StructureData seqstrmaps = jmoldat.getFileData().get(mapkey);
3922 if (seqstrmaps == null)
3924 jmoldat.getFileData().put(mapkey,
3925 seqstrmaps = jmoldat.new StructureData(pdbFile,
3928 if (!seqstrmaps.getSeqList().contains(seq))
3930 seqstrmaps.getSeqList().add(seq);
3936 errorMessage = ("The Jmol views in this project were imported\nfrom an older version of Jalview.\nPlease review the sequence colour associations\nin the Colour by section of the Jmol View menu.\n\nIn the case of problems, see note at\nhttp://issues.jalview.org/browse/JAL-747");
3943 // Instantiate the associated structure views
3944 for (Entry<String, StructureViewerModel> entry : structureViewers
3949 createOrLinkStructureViewer(entry, af, ap, jprovider);
3950 } catch (Exception e)
3953 "Error loading structure viewer: " + e.getMessage());
3954 // failed - try the next one
3966 protected void createOrLinkStructureViewer(
3967 Entry<String, StructureViewerModel> viewerData, AlignFrame af,
3968 AlignmentPanel ap, jarInputStreamProvider jprovider)
3970 final StructureViewerModel stateData = viewerData.getValue();
3973 * Search for any viewer windows already open from other alignment views
3974 * that exactly match the stored structure state
3976 StructureViewerBase comp = findMatchingViewer(viewerData);
3980 linkStructureViewer(ap, comp, stateData);
3985 * From 2.9: stateData.type contains JMOL or CHIMERA, data is in jar entry
3986 * "viewer_"+stateData.viewId
3988 if (ViewerType.CHIMERA.toString().equals(stateData.getType()))
3990 createChimeraViewer(viewerData, af, jprovider);
3995 * else Jmol (if pre-2.9, stateData contains JMOL state string)
3997 createJmolViewer(viewerData, af, jprovider);
4002 * Create a new Chimera viewer.
4008 protected void createChimeraViewer(
4009 Entry<String, StructureViewerModel> viewerData, AlignFrame af,
4010 jarInputStreamProvider jprovider)
4012 StructureViewerModel data = viewerData.getValue();
4013 String chimeraSessionFile = data.getStateData();
4016 * Copy Chimera session from jar entry "viewer_"+viewId to a temporary file
4018 * NB this is the 'saved' viewId as in the project file XML, _not_ the
4019 * 'uniquified' sviewid used to reconstruct the viewer here
4021 String viewerJarEntryName = getViewerJarEntryName(data.getViewId());
4022 chimeraSessionFile = copyJarEntry(jprovider, viewerJarEntryName,
4025 Set<Entry<File, StructureData>> fileData = data.getFileData()
4027 List<PDBEntry> pdbs = new ArrayList<>();
4028 List<SequenceI[]> allseqs = new ArrayList<>();
4029 for (Entry<File, StructureData> pdb : fileData)
4031 String filePath = pdb.getValue().getFilePath();
4032 String pdbId = pdb.getValue().getPdbId();
4033 // pdbs.add(new PDBEntry(filePath, pdbId));
4034 pdbs.add(new PDBEntry(pdbId, null, PDBEntry.Type.PDB, filePath));
4035 final List<SequenceI> seqList = pdb.getValue().getSeqList();
4036 SequenceI[] seqs = seqList.toArray(new SequenceI[seqList.size()]);
4040 boolean colourByChimera = data.isColourByViewer();
4041 boolean colourBySequence = data.isColourWithAlignPanel();
4043 // TODO use StructureViewer as a factory here, see JAL-1761
4044 final PDBEntry[] pdbArray = pdbs.toArray(new PDBEntry[pdbs.size()]);
4045 final SequenceI[][] seqsArray = allseqs
4046 .toArray(new SequenceI[allseqs.size()][]);
4047 String newViewId = viewerData.getKey();
4049 ChimeraViewFrame cvf = new ChimeraViewFrame(chimeraSessionFile,
4050 af.alignPanel, pdbArray, seqsArray, colourByChimera,
4051 colourBySequence, newViewId);
4052 cvf.setSize(data.getWidth(), data.getHeight());
4053 cvf.setLocation(data.getX(), data.getY());
4057 * Create a new Jmol window. First parse the Jmol state to translate filenames
4058 * loaded into the view, and record the order in which files are shown in the
4059 * Jmol view, so we can add the sequence mappings in same order.
4065 protected void createJmolViewer(
4066 final Entry<String, StructureViewerModel> viewerData,
4067 AlignFrame af, jarInputStreamProvider jprovider)
4069 final StructureViewerModel svattrib = viewerData.getValue();
4070 String state = svattrib.getStateData();
4073 * Pre-2.9: state element value is the Jmol state string
4075 * 2.9+: @type is "JMOL", state data is in a Jar file member named "viewer_"
4078 if (ViewerType.JMOL.toString().equals(svattrib.getType()))
4080 state = readJarEntry(jprovider,
4081 getViewerJarEntryName(svattrib.getViewId()));
4084 List<String> pdbfilenames = new ArrayList<>();
4085 List<SequenceI[]> seqmaps = new ArrayList<>();
4086 List<String> pdbids = new ArrayList<>();
4087 StringBuilder newFileLoc = new StringBuilder(64);
4088 int cp = 0, ncp, ecp;
4089 Map<File, StructureData> oldFiles = svattrib.getFileData();
4090 while ((ncp = state.indexOf("load ", cp)) > -1)
4094 // look for next filename in load statement
4095 newFileLoc.append(state.substring(cp,
4096 ncp = (state.indexOf("\"", ncp + 1) + 1)));
4097 String oldfilenam = state.substring(ncp,
4098 ecp = state.indexOf("\"", ncp));
4099 // recover the new mapping data for this old filename
4100 // have to normalize filename - since Jmol and jalview do
4102 // translation differently.
4103 StructureData filedat = oldFiles.get(new File(oldfilenam));
4104 if (filedat == null)
4106 String reformatedOldFilename = oldfilenam.replaceAll("/", "\\\\");
4107 filedat = oldFiles.get(new File(reformatedOldFilename));
4109 newFileLoc.append(Platform.escapeString(filedat.getFilePath()));
4110 pdbfilenames.add(filedat.getFilePath());
4111 pdbids.add(filedat.getPdbId());
4112 seqmaps.add(filedat.getSeqList().toArray(new SequenceI[0]));
4113 newFileLoc.append("\"");
4114 cp = ecp + 1; // advance beyond last \" and set cursor so we can
4115 // look for next file statement.
4116 } while ((ncp = state.indexOf("/*file*/", cp)) > -1);
4120 // just append rest of state
4121 newFileLoc.append(state.substring(cp));
4125 System.err.print("Ignoring incomplete Jmol state for PDB ids: ");
4126 newFileLoc = new StringBuilder(state);
4127 newFileLoc.append("; load append ");
4128 for (File id : oldFiles.keySet())
4130 // add this and any other pdb files that should be present in
4132 StructureData filedat = oldFiles.get(id);
4133 newFileLoc.append(filedat.getFilePath());
4134 pdbfilenames.add(filedat.getFilePath());
4135 pdbids.add(filedat.getPdbId());
4136 seqmaps.add(filedat.getSeqList().toArray(new SequenceI[0]));
4137 newFileLoc.append(" \"");
4138 newFileLoc.append(filedat.getFilePath());
4139 newFileLoc.append("\"");
4142 newFileLoc.append(";");
4145 if (newFileLoc.length() == 0)
4149 int histbug = newFileLoc.indexOf("history = ");
4153 * change "history = [true|false];" to "history = [1|0];"
4156 int diff = histbug == -1 ? -1 : newFileLoc.indexOf(";", histbug);
4157 String val = (diff == -1) ? null
4158 : newFileLoc.substring(histbug, diff);
4159 if (val != null && val.length() >= 4)
4161 if (val.contains("e")) // eh? what can it be?
4163 if (val.trim().equals("true"))
4171 newFileLoc.replace(histbug, diff, val);
4176 final String[] pdbf = pdbfilenames
4177 .toArray(new String[pdbfilenames.size()]);
4178 final String[] id = pdbids.toArray(new String[pdbids.size()]);
4179 final SequenceI[][] sq = seqmaps
4180 .toArray(new SequenceI[seqmaps.size()][]);
4181 final String fileloc = newFileLoc.toString();
4182 final String sviewid = viewerData.getKey();
4183 final AlignFrame alf = af;
4184 final Rectangle rect = new Rectangle(svattrib.getX(), svattrib.getY(),
4185 svattrib.getWidth(), svattrib.getHeight());
4188 javax.swing.SwingUtilities.invokeAndWait(new Runnable()
4193 JalviewStructureDisplayI sview = null;
4196 sview = new StructureViewer(
4197 alf.alignPanel.getStructureSelectionManager())
4198 .createView(StructureViewer.ViewerType.JMOL,
4199 pdbf, id, sq, alf.alignPanel, svattrib,
4200 fileloc, rect, sviewid);
4201 addNewStructureViewer(sview);
4202 } catch (OutOfMemoryError ex)
4204 new OOMWarning("restoring structure view for PDB id " + id,
4205 (OutOfMemoryError) ex.getCause());
4206 if (sview != null && sview.isVisible())
4208 sview.closeViewer(false);
4209 sview.setVisible(false);
4215 } catch (InvocationTargetException ex)
4217 warn("Unexpected error when opening Jmol view.", ex);
4219 } catch (InterruptedException e)
4221 // e.printStackTrace();
4227 * Generates a name for the entry in the project jar file to hold state
4228 * information for a structure viewer
4233 protected String getViewerJarEntryName(String viewId)
4235 return VIEWER_PREFIX + viewId;
4239 * Returns any open frame that matches given structure viewer data. The match
4240 * is based on the unique viewId, or (for older project versions) the frame's
4246 protected StructureViewerBase findMatchingViewer(
4247 Entry<String, StructureViewerModel> viewerData)
4249 final String sviewid = viewerData.getKey();
4250 final StructureViewerModel svattrib = viewerData.getValue();
4251 StructureViewerBase comp = null;
4252 JInternalFrame[] frames = getAllFrames();
4253 for (JInternalFrame frame : frames)
4255 if (frame instanceof StructureViewerBase)
4258 * Post jalview 2.4 schema includes structure view id
4260 if (sviewid != null && ((StructureViewerBase) frame).getViewId()
4263 comp = (StructureViewerBase) frame;
4264 break; // break added in 2.9
4267 * Otherwise test for matching position and size of viewer frame
4269 else if (frame.getX() == svattrib.getX()
4270 && frame.getY() == svattrib.getY()
4271 && frame.getHeight() == svattrib.getHeight()
4272 && frame.getWidth() == svattrib.getWidth())
4274 comp = (StructureViewerBase) frame;
4275 // no break in faint hope of an exact match on viewId
4283 * Link an AlignmentPanel to an existing structure viewer.
4288 * @param useinViewerSuperpos
4289 * @param usetoColourbyseq
4290 * @param viewerColouring
4292 protected void linkStructureViewer(AlignmentPanel ap,
4293 StructureViewerBase viewer, StructureViewerModel stateData)
4295 // NOTE: if the jalview project is part of a shared session then
4296 // view synchronization should/could be done here.
4298 final boolean useinViewerSuperpos = stateData.isAlignWithPanel();
4299 final boolean usetoColourbyseq = stateData.isColourWithAlignPanel();
4300 final boolean viewerColouring = stateData.isColourByViewer();
4301 Map<File, StructureData> oldFiles = stateData.getFileData();
4304 * Add mapping for sequences in this view to an already open viewer
4306 final AAStructureBindingModel binding = viewer.getBinding();
4307 for (File id : oldFiles.keySet())
4309 // add this and any other pdb files that should be present in the
4311 StructureData filedat = oldFiles.get(id);
4312 String pdbFile = filedat.getFilePath();
4313 SequenceI[] seq = filedat.getSeqList().toArray(new SequenceI[0]);
4314 binding.getSsm().setMapping(seq, null, pdbFile, DataSourceType.FILE,
4316 binding.addSequenceForStructFile(pdbFile, seq);
4318 // and add the AlignmentPanel's reference to the view panel
4319 viewer.addAlignmentPanel(ap);
4320 if (useinViewerSuperpos)
4322 viewer.useAlignmentPanelForSuperposition(ap);
4326 viewer.excludeAlignmentPanelForSuperposition(ap);
4328 if (usetoColourbyseq)
4330 viewer.useAlignmentPanelForColourbyseq(ap, !viewerColouring);
4334 viewer.excludeAlignmentPanelForColourbyseq(ap);
4339 * Get all frames within the Desktop.
4343 protected JInternalFrame[] getAllFrames()
4345 JInternalFrame[] frames = null;
4346 // TODO is this necessary - is it safe - risk of hanging?
4351 frames = Desktop.desktop.getAllFrames();
4352 } catch (ArrayIndexOutOfBoundsException e)
4354 // occasional No such child exceptions are thrown here...
4358 } catch (InterruptedException f)
4362 } while (frames == null);
4367 * Answers true if 'version' is equal to or later than 'supported', where each
4368 * is formatted as major/minor versions like "2.8.3" or "2.3.4b1" for bugfix
4369 * changes. Development and test values for 'version' are leniently treated
4373 * - minimum version we are comparing against
4375 * - version of data being processsed
4378 public static boolean isVersionStringLaterThan(String supported,
4381 if (supported == null || version == null
4382 || version.equalsIgnoreCase("DEVELOPMENT BUILD")
4383 || version.equalsIgnoreCase("Test")
4384 || version.equalsIgnoreCase("AUTOMATED BUILD"))
4386 System.err.println("Assuming project file with "
4387 + (version == null ? "null" : version)
4388 + " is compatible with Jalview version " + supported);
4393 return StringUtils.compareVersions(version, supported, "b") >= 0;
4397 Vector<JalviewStructureDisplayI> newStructureViewers = null;
4399 protected void addNewStructureViewer(JalviewStructureDisplayI sview)
4401 if (newStructureViewers != null)
4403 sview.getBinding().setFinishedLoadingFromArchive(false);
4404 newStructureViewers.add(sview);
4408 protected void setLoadingFinishedForNewStructureViewers()
4410 if (newStructureViewers != null)
4412 for (JalviewStructureDisplayI sview : newStructureViewers)
4414 sview.getBinding().setFinishedLoadingFromArchive(true);
4416 newStructureViewers.clear();
4417 newStructureViewers = null;
4421 AlignFrame loadViewport(String file, JSeq[] JSEQ,
4422 List<SequenceI> hiddenSeqs, AlignmentI al,
4423 JalviewModelSequence jms, Viewport view, String uniqueSeqSetId,
4424 String viewId, List<JvAnnotRow> autoAlan)
4426 AlignFrame af = null;
4427 af = new AlignFrame(al, view.getWidth(), view.getHeight(),
4428 uniqueSeqSetId, viewId);
4430 af.setFileName(file, FileFormat.Jalview);
4432 for (int i = 0; i < JSEQ.length; i++)
4434 af.viewport.setSequenceColour(
4435 af.viewport.getAlignment().getSequenceAt(i),
4436 new java.awt.Color(JSEQ[i].getColour()));
4441 af.getViewport().setColourByReferenceSeq(true);
4442 af.getViewport().setDisplayReferenceSeq(true);
4445 af.viewport.setGatherViewsHere(view.getGatheredViews());
4447 if (view.getSequenceSetId() != null)
4449 AlignmentViewport av = viewportsAdded.get(uniqueSeqSetId);
4451 af.viewport.setSequenceSetId(uniqueSeqSetId);
4454 // propagate shared settings to this new view
4455 af.viewport.setHistoryList(av.getHistoryList());
4456 af.viewport.setRedoList(av.getRedoList());
4460 viewportsAdded.put(uniqueSeqSetId, af.viewport);
4462 // TODO: check if this method can be called repeatedly without
4463 // side-effects if alignpanel already registered.
4464 PaintRefresher.Register(af.alignPanel, uniqueSeqSetId);
4466 // apply Hidden regions to view.
4467 if (hiddenSeqs != null)
4469 for (int s = 0; s < JSEQ.length; s++)
4471 SequenceGroup hidden = new SequenceGroup();
4472 boolean isRepresentative = false;
4473 for (int r = 0; r < JSEQ[s].getHiddenSequencesCount(); r++)
4475 isRepresentative = true;
4476 SequenceI sequenceToHide = al
4477 .getSequenceAt(JSEQ[s].getHiddenSequences(r));
4478 hidden.addSequence(sequenceToHide, false);
4479 // remove from hiddenSeqs list so we don't try to hide it twice
4480 hiddenSeqs.remove(sequenceToHide);
4482 if (isRepresentative)
4484 SequenceI representativeSequence = al.getSequenceAt(s);
4485 hidden.addSequence(representativeSequence, false);
4486 af.viewport.hideRepSequences(representativeSequence, hidden);
4490 SequenceI[] hseqs = hiddenSeqs
4491 .toArray(new SequenceI[hiddenSeqs.size()]);
4492 af.viewport.hideSequence(hseqs);
4495 // recover view properties and display parameters
4497 af.viewport.setShowAnnotation(view.getShowAnnotation());
4498 af.viewport.setAbovePIDThreshold(view.getPidSelected());
4499 af.viewport.setThreshold(view.getPidThreshold());
4501 af.viewport.setColourText(view.getShowColourText());
4503 af.viewport.setConservationSelected(view.getConservationSelected());
4504 af.viewport.setIncrement(view.getConsThreshold());
4505 af.viewport.setShowJVSuffix(view.getShowFullId());
4506 af.viewport.setRightAlignIds(view.getRightAlignIds());
4507 af.viewport.setFont(new java.awt.Font(view.getFontName(),
4508 view.getFontStyle(), view.getFontSize()), true);
4509 ViewStyleI vs = af.viewport.getViewStyle();
4510 vs.setScaleProteinAsCdna(view.isScaleProteinAsCdna());
4511 af.viewport.setViewStyle(vs);
4512 // TODO: allow custom charWidth/Heights to be restored by updating them
4513 // after setting font - which means set above to false
4514 af.viewport.setRenderGaps(view.getRenderGaps());
4515 af.viewport.setWrapAlignment(view.getWrapAlignment());
4516 af.viewport.setShowAnnotation(view.getShowAnnotation());
4518 af.viewport.setShowBoxes(view.getShowBoxes());
4520 af.viewport.setShowText(view.getShowText());
4522 af.viewport.setTextColour(new java.awt.Color(view.getTextCol1()));
4523 af.viewport.setTextColour2(new java.awt.Color(view.getTextCol2()));
4524 af.viewport.setThresholdTextColour(view.getTextColThreshold());
4525 af.viewport.setShowUnconserved(
4526 view.hasShowUnconserved() ? view.isShowUnconserved() : false);
4527 af.viewport.getRanges().setStartRes(view.getStartRes());
4529 if (view.getViewName() != null)
4531 af.viewport.setViewName(view.getViewName());
4532 af.setInitialTabVisible();
4534 af.setBounds(view.getXpos(), view.getYpos(), view.getWidth(),
4536 // startSeq set in af.alignPanel.updateLayout below
4537 af.alignPanel.updateLayout();
4538 ColourSchemeI cs = null;
4539 // apply colourschemes
4540 if (view.getBgColour() != null)
4542 if (view.getBgColour().startsWith("ucs"))
4544 cs = getUserColourScheme(jms, view.getBgColour());
4546 else if (view.getBgColour().startsWith("Annotation"))
4548 AnnotationColours viewAnnColour = view.getAnnotationColours();
4549 cs = constructAnnotationColour(viewAnnColour, af, al, jms, true);
4556 cs = ColourSchemeProperty.getColourScheme(al, view.getBgColour());
4560 af.viewport.setGlobalColourScheme(cs);
4561 af.viewport.getResidueShading().setThreshold(view.getPidThreshold(),
4562 view.getIgnoreGapsinConsensus());
4563 af.viewport.getResidueShading()
4564 .setConsensus(af.viewport.getSequenceConsensusHash());
4565 af.viewport.setColourAppliesToAllGroups(false);
4567 if (view.getConservationSelected() && cs != null)
4569 af.viewport.getResidueShading()
4570 .setConservationInc(view.getConsThreshold());
4573 af.changeColour(cs);
4575 af.viewport.setColourAppliesToAllGroups(true);
4577 af.viewport.setShowSequenceFeatures(view.getShowSequenceFeatures());
4579 if (view.hasCentreColumnLabels())
4581 af.viewport.setCentreColumnLabels(view.getCentreColumnLabels());
4583 if (view.hasIgnoreGapsinConsensus())
4585 af.viewport.setIgnoreGapsConsensus(view.getIgnoreGapsinConsensus(),
4588 if (view.hasFollowHighlight())
4590 af.viewport.setFollowHighlight(view.getFollowHighlight());
4592 if (view.hasFollowSelection())
4594 af.viewport.followSelection = view.getFollowSelection();
4596 if (view.hasShowConsensusHistogram())
4599 .setShowConsensusHistogram(view.getShowConsensusHistogram());
4603 af.viewport.setShowConsensusHistogram(true);
4605 if (view.hasShowSequenceLogo())
4607 af.viewport.setShowSequenceLogo(view.getShowSequenceLogo());
4611 af.viewport.setShowSequenceLogo(false);
4613 if (view.hasNormaliseSequenceLogo())
4615 af.viewport.setNormaliseSequenceLogo(view.getNormaliseSequenceLogo());
4617 if (view.hasShowDbRefTooltip())
4619 af.viewport.setShowDBRefs(view.getShowDbRefTooltip());
4621 if (view.hasShowNPfeatureTooltip())
4623 af.viewport.setShowNPFeats(view.hasShowNPfeatureTooltip());
4625 if (view.hasShowGroupConsensus())
4627 af.viewport.setShowGroupConsensus(view.getShowGroupConsensus());
4631 af.viewport.setShowGroupConsensus(false);
4633 if (view.hasShowGroupConservation())
4635 af.viewport.setShowGroupConservation(view.getShowGroupConservation());
4639 af.viewport.setShowGroupConservation(false);
4642 // recover feature settings
4643 if (jms.getFeatureSettings() != null)
4645 FeatureRenderer fr = af.alignPanel.getSeqPanel().seqCanvas
4646 .getFeatureRenderer();
4647 FeaturesDisplayed fdi;
4648 af.viewport.setFeaturesDisplayed(fdi = new FeaturesDisplayed());
4649 String[] renderOrder = new String[jms.getFeatureSettings()
4650 .getSettingCount()];
4651 Map<String, FeatureColourI> featureColours = new Hashtable<>();
4652 Map<String, Float> featureOrder = new Hashtable<>();
4654 for (int fs = 0; fs < jms.getFeatureSettings()
4655 .getSettingCount(); fs++)
4657 Setting setting = jms.getFeatureSettings().getSetting(fs);
4658 String featureType = setting.getType();
4661 * restore feature filters (if any)
4663 MatcherSet filters = setting.getMatcherSet();
4664 if (filters != null)
4666 FeatureMatcherSetI filter = Jalview2XML
4667 .unmarshalFilter(featureType, filters);
4668 if (!filter.isEmpty())
4670 fr.setFeatureFilter(featureType, filter);
4675 * restore feature colour scheme
4677 Color maxColour = new Color(setting.getColour());
4678 if (setting.hasMincolour())
4681 * minColour is always set unless a simple colour
4682 * (including for colour by label though it doesn't use it)
4684 Color minColour = new Color(setting.getMincolour());
4685 Color noValueColour = minColour;
4686 NoValueColour noColour = setting.getNoValueColour();
4687 if (noColour == NoValueColour.NONE)
4689 noValueColour = null;
4691 else if (noColour == NoValueColour.MAX)
4693 noValueColour = maxColour;
4695 float min = setting.hasMin() ? setting.getMin() : 0f;
4696 float max = setting.hasMin() ? setting.getMax() : 1f;
4697 FeatureColourI gc = new FeatureColour(minColour, maxColour,
4698 noValueColour, min, max);
4699 if (setting.getAttributeNameCount() > 0)
4701 gc.setAttributeName(setting.getAttributeName());
4703 if (setting.hasThreshold())
4705 gc.setThreshold(setting.getThreshold());
4706 int threshstate = setting.getThreshstate();
4707 // -1 = None, 0 = Below, 1 = Above threshold
4708 if (threshstate == 0)
4710 gc.setBelowThreshold(true);
4712 else if (threshstate == 1)
4714 gc.setAboveThreshold(true);
4717 gc.setAutoScaled(true); // default
4718 if (setting.hasAutoScale())
4720 gc.setAutoScaled(setting.getAutoScale());
4722 if (setting.hasColourByLabel())
4724 gc.setColourByLabel(setting.getColourByLabel());
4726 // and put in the feature colour table.
4727 featureColours.put(featureType, gc);
4731 featureColours.put(featureType,
4732 new FeatureColour(maxColour));
4734 renderOrder[fs] = featureType;
4735 if (setting.hasOrder())
4737 featureOrder.put(featureType, setting.getOrder());
4741 featureOrder.put(featureType, new Float(
4742 fs / jms.getFeatureSettings().getSettingCount()));
4744 if (setting.getDisplay())
4746 fdi.setVisible(featureType);
4749 Map<String, Boolean> fgtable = new Hashtable<>();
4750 for (int gs = 0; gs < jms.getFeatureSettings().getGroupCount(); gs++)
4752 Group grp = jms.getFeatureSettings().getGroup(gs);
4753 fgtable.put(grp.getName(), new Boolean(grp.getDisplay()));
4755 // FeatureRendererSettings frs = new FeatureRendererSettings(renderOrder,
4756 // fgtable, featureColours, jms.getFeatureSettings().hasTransparency() ?
4757 // jms.getFeatureSettings().getTransparency() : 0.0, featureOrder);
4758 FeatureRendererSettings frs = new FeatureRendererSettings(renderOrder,
4759 fgtable, featureColours, 1.0f, featureOrder);
4760 fr.transferSettings(frs);
4763 if (view.getHiddenColumnsCount() > 0)
4765 for (int c = 0; c < view.getHiddenColumnsCount(); c++)
4767 af.viewport.hideColumns(view.getHiddenColumns(c).getStart(),
4768 view.getHiddenColumns(c).getEnd() // +1
4772 if (view.getCalcIdParam() != null)
4774 for (CalcIdParam calcIdParam : view.getCalcIdParam())
4776 if (calcIdParam != null)
4778 if (recoverCalcIdParam(calcIdParam, af.viewport))
4783 warn("Couldn't recover parameters for "
4784 + calcIdParam.getCalcId());
4789 af.setMenusFromViewport(af.viewport);
4790 af.setTitle(view.getTitle());
4791 // TODO: we don't need to do this if the viewport is aready visible.
4793 * Add the AlignFrame to the desktop (it may be 'gathered' later), unless it
4794 * has a 'cdna/protein complement' view, in which case save it in order to
4795 * populate a SplitFrame once all views have been read in.
4797 String complementaryViewId = view.getComplementId();
4798 if (complementaryViewId == null)
4800 Desktop.addInternalFrame(af, view.getTitle(), view.getWidth(),
4802 // recompute any autoannotation
4803 af.alignPanel.updateAnnotation(false, true);
4804 reorderAutoannotation(af, al, autoAlan);
4805 af.alignPanel.alignmentChanged();
4809 splitFrameCandidates.put(view, af);
4815 * Reads saved data to restore Colour by Annotation settings
4817 * @param viewAnnColour
4821 * @param checkGroupAnnColour
4824 private ColourSchemeI constructAnnotationColour(
4825 AnnotationColours viewAnnColour, AlignFrame af, AlignmentI al,
4826 JalviewModelSequence jms, boolean checkGroupAnnColour)
4828 boolean propagateAnnColour = false;
4829 AlignmentI annAlignment = af != null ? af.viewport.getAlignment() : al;
4830 if (checkGroupAnnColour && al.getGroups() != null
4831 && al.getGroups().size() > 0)
4833 // pre 2.8.1 behaviour
4834 // check to see if we should transfer annotation colours
4835 propagateAnnColour = true;
4836 for (SequenceGroup sg : al.getGroups())
4838 if (sg.getColourScheme() instanceof AnnotationColourGradient)
4840 propagateAnnColour = false;
4846 * 2.10.2- : saved annotationId is AlignmentAnnotation.annotationId
4848 String annotationId = viewAnnColour.getAnnotation();
4849 AlignmentAnnotation matchedAnnotation = annotationIds.get(annotationId);
4852 * pre 2.10.2: saved annotationId is AlignmentAnnotation.label
4854 if (matchedAnnotation == null
4855 && annAlignment.getAlignmentAnnotation() != null)
4857 for (int i = 0; i < annAlignment.getAlignmentAnnotation().length; i++)
4860 .equals(annAlignment.getAlignmentAnnotation()[i].label))
4862 matchedAnnotation = annAlignment.getAlignmentAnnotation()[i];
4867 if (matchedAnnotation == null)
4869 System.err.println("Failed to match annotation colour scheme for "
4873 if (matchedAnnotation.getThreshold() == null)
4875 matchedAnnotation.setThreshold(new GraphLine(
4876 viewAnnColour.getThreshold(), "Threshold", Color.black));
4879 AnnotationColourGradient cs = null;
4880 if (viewAnnColour.getColourScheme().equals("None"))
4882 cs = new AnnotationColourGradient(matchedAnnotation,
4883 new Color(viewAnnColour.getMinColour()),
4884 new Color(viewAnnColour.getMaxColour()),
4885 viewAnnColour.getAboveThreshold());
4887 else if (viewAnnColour.getColourScheme().startsWith("ucs"))
4889 cs = new AnnotationColourGradient(matchedAnnotation,
4890 getUserColourScheme(jms, viewAnnColour.getColourScheme()),
4891 viewAnnColour.getAboveThreshold());
4895 cs = new AnnotationColourGradient(matchedAnnotation,
4896 ColourSchemeProperty.getColourScheme(al,
4897 viewAnnColour.getColourScheme()),
4898 viewAnnColour.getAboveThreshold());
4901 boolean perSequenceOnly = viewAnnColour.isPerSequence();
4902 boolean useOriginalColours = viewAnnColour.isPredefinedColours();
4903 cs.setSeqAssociated(perSequenceOnly);
4904 cs.setPredefinedColours(useOriginalColours);
4906 if (propagateAnnColour && al.getGroups() != null)
4908 // Also use these settings for all the groups
4909 for (int g = 0; g < al.getGroups().size(); g++)
4911 SequenceGroup sg = al.getGroups().get(g);
4912 if (sg.getGroupColourScheme() == null)
4917 AnnotationColourGradient groupScheme = new AnnotationColourGradient(
4918 matchedAnnotation, sg.getColourScheme(),
4919 viewAnnColour.getAboveThreshold());
4920 sg.setColourScheme(groupScheme);
4921 groupScheme.setSeqAssociated(perSequenceOnly);
4922 groupScheme.setPredefinedColours(useOriginalColours);
4928 private void reorderAutoannotation(AlignFrame af, AlignmentI al,
4929 List<JvAnnotRow> autoAlan)
4931 // copy over visualization settings for autocalculated annotation in the
4933 if (al.getAlignmentAnnotation() != null)
4936 * Kludge for magic autoannotation names (see JAL-811)
4938 String[] magicNames = new String[] { "Consensus", "Quality",
4940 JvAnnotRow nullAnnot = new JvAnnotRow(-1, null);
4941 Hashtable<String, JvAnnotRow> visan = new Hashtable<>();
4942 for (String nm : magicNames)
4944 visan.put(nm, nullAnnot);
4946 for (JvAnnotRow auan : autoAlan)
4948 visan.put(auan.template.label
4949 + (auan.template.getCalcId() == null ? ""
4950 : "\t" + auan.template.getCalcId()),
4953 int hSize = al.getAlignmentAnnotation().length;
4954 List<JvAnnotRow> reorder = new ArrayList<>();
4955 // work through any autoCalculated annotation already on the view
4956 // removing it if it should be placed in a different location on the
4957 // annotation panel.
4958 List<String> remains = new ArrayList<>(visan.keySet());
4959 for (int h = 0; h < hSize; h++)
4961 jalview.datamodel.AlignmentAnnotation jalan = al
4962 .getAlignmentAnnotation()[h];
4963 if (jalan.autoCalculated)
4966 JvAnnotRow valan = visan.get(k = jalan.label);
4967 if (jalan.getCalcId() != null)
4969 valan = visan.get(k = jalan.label + "\t" + jalan.getCalcId());
4974 // delete the auto calculated row from the alignment
4975 al.deleteAnnotation(jalan, false);
4979 if (valan != nullAnnot)
4981 if (jalan != valan.template)
4983 // newly created autoannotation row instance
4984 // so keep a reference to the visible annotation row
4985 // and copy over all relevant attributes
4986 if (valan.template.graphHeight >= 0)
4989 jalan.graphHeight = valan.template.graphHeight;
4991 jalan.visible = valan.template.visible;
4993 reorder.add(new JvAnnotRow(valan.order, jalan));
4998 // Add any (possibly stale) autocalculated rows that were not appended to
4999 // the view during construction
5000 for (String other : remains)
5002 JvAnnotRow othera = visan.get(other);
5003 if (othera != nullAnnot && othera.template.getCalcId() != null
5004 && othera.template.getCalcId().length() > 0)
5006 reorder.add(othera);
5009 // now put the automatic annotation in its correct place
5010 int s = 0, srt[] = new int[reorder.size()];
5011 JvAnnotRow[] rws = new JvAnnotRow[reorder.size()];
5012 for (JvAnnotRow jvar : reorder)
5015 srt[s++] = jvar.order;
5018 jalview.util.QuickSort.sort(srt, rws);
5019 // and re-insert the annotation at its correct position
5020 for (JvAnnotRow jvar : rws)
5022 al.addAnnotation(jvar.template, jvar.order);
5024 af.alignPanel.adjustAnnotationHeight();
5028 Hashtable skipList = null;
5031 * TODO remove this method
5034 * @return AlignFrame bound to sequenceSetId from view, if one exists. private
5035 * AlignFrame getSkippedFrame(Viewport view) { if (skipList==null) {
5036 * throw new Error("Implementation Error. No skipList defined for this
5037 * Jalview2XML instance."); } return (AlignFrame)
5038 * skipList.get(view.getSequenceSetId()); }
5042 * Check if the Jalview view contained in object should be skipped or not.
5045 * @return true if view's sequenceSetId is a key in skipList
5047 private boolean skipViewport(JalviewModel object)
5049 if (skipList == null)
5054 if (skipList.containsKey(
5055 id = object.getJalviewModelSequence().getViewport()[0]
5056 .getSequenceSetId()))
5058 if (Cache.log != null && Cache.log.isDebugEnabled())
5060 Cache.log.debug("Skipping seuqence set id " + id);
5067 public void addToSkipList(AlignFrame af)
5069 if (skipList == null)
5071 skipList = new Hashtable();
5073 skipList.put(af.getViewport().getSequenceSetId(), af);
5076 public void clearSkipList()
5078 if (skipList != null)
5085 private void recoverDatasetFor(SequenceSet vamsasSet, AlignmentI al,
5086 boolean ignoreUnrefed)
5088 jalview.datamodel.AlignmentI ds = getDatasetFor(
5089 vamsasSet.getDatasetId());
5090 Vector dseqs = null;
5093 // create a list of new dataset sequences
5094 dseqs = new Vector();
5096 for (int i = 0, iSize = vamsasSet.getSequenceCount(); i < iSize; i++)
5098 Sequence vamsasSeq = vamsasSet.getSequence(i);
5099 ensureJalviewDatasetSequence(vamsasSeq, ds, dseqs, ignoreUnrefed, i);
5101 // create a new dataset
5104 SequenceI[] dsseqs = new SequenceI[dseqs.size()];
5105 dseqs.copyInto(dsseqs);
5106 ds = new jalview.datamodel.Alignment(dsseqs);
5107 debug("Created new dataset " + vamsasSet.getDatasetId()
5108 + " for alignment " + System.identityHashCode(al));
5109 addDatasetRef(vamsasSet.getDatasetId(), ds);
5111 // set the dataset for the newly imported alignment.
5112 if (al.getDataset() == null && !ignoreUnrefed)
5121 * sequence definition to create/merge dataset sequence for
5125 * vector to add new dataset sequence to
5126 * @param ignoreUnrefed
5127 * - when true, don't create new sequences from vamsasSeq if it's id
5128 * doesn't already have an asssociated Jalview sequence.
5130 * - used to reorder the sequence in the alignment according to the
5131 * vamsasSeq array ordering, to preserve ordering of dataset
5133 private void ensureJalviewDatasetSequence(Sequence vamsasSeq,
5134 AlignmentI ds, Vector dseqs, boolean ignoreUnrefed, int vseqpos)
5136 // JBP TODO: Check this is called for AlCodonFrames to support recovery of
5138 SequenceI sq = seqRefIds.get(vamsasSeq.getId());
5139 boolean reorder = false;
5140 SequenceI dsq = null;
5141 if (sq != null && sq.getDatasetSequence() != null)
5143 dsq = sq.getDatasetSequence();
5149 if (sq == null && ignoreUnrefed)
5153 String sqid = vamsasSeq.getDsseqid();
5156 // need to create or add a new dataset sequence reference to this sequence
5159 dsq = seqRefIds.get(sqid);
5164 // make a new dataset sequence
5165 dsq = sq.createDatasetSequence();
5168 // make up a new dataset reference for this sequence
5169 sqid = seqHash(dsq);
5171 dsq.setVamsasId(uniqueSetSuffix + sqid);
5172 seqRefIds.put(sqid, dsq);
5177 dseqs.addElement(dsq);
5182 ds.addSequence(dsq);
5188 { // make this dataset sequence sq's dataset sequence
5189 sq.setDatasetSequence(dsq);
5190 // and update the current dataset alignment
5195 if (!dseqs.contains(dsq))
5202 if (ds.findIndex(dsq) < 0)
5204 ds.addSequence(dsq);
5211 // TODO: refactor this as a merge dataset sequence function
5212 // now check that sq (the dataset sequence) sequence really is the union of
5213 // all references to it
5214 // boolean pre = sq.getStart() < dsq.getStart();
5215 // boolean post = sq.getEnd() > dsq.getEnd();
5219 // StringBuffer sb = new StringBuffer();
5220 String newres = jalview.analysis.AlignSeq.extractGaps(
5221 jalview.util.Comparison.GapChars, sq.getSequenceAsString());
5222 if (!newres.equalsIgnoreCase(dsq.getSequenceAsString())
5223 && newres.length() > dsq.getLength())
5225 // Update with the longer sequence.
5229 * if (pre) { sb.insert(0, newres .substring(0, dsq.getStart() -
5230 * sq.getStart())); dsq.setStart(sq.getStart()); } if (post) {
5231 * sb.append(newres.substring(newres.length() - sq.getEnd() -
5232 * dsq.getEnd())); dsq.setEnd(sq.getEnd()); }
5234 dsq.setSequence(newres);
5236 // TODO: merges will never happen if we 'know' we have the real dataset
5237 // sequence - this should be detected when id==dssid
5239 "DEBUG Notice: Merged dataset sequence (if you see this often, post at http://issues.jalview.org/browse/JAL-1474)"); // ("
5240 // + (pre ? "prepended" : "") + " "
5241 // + (post ? "appended" : ""));
5246 // sequence refs are identical. We may need to update the existing dataset
5247 // alignment with this one, though.
5248 if (ds != null && dseqs == null)
5250 int opos = ds.findIndex(dsq);
5251 SequenceI tseq = null;
5252 if (opos != -1 && vseqpos != opos)
5254 // remove from old position
5255 ds.deleteSequence(dsq);
5257 if (vseqpos < ds.getHeight())
5259 if (vseqpos != opos)
5261 // save sequence at destination position
5262 tseq = ds.getSequenceAt(vseqpos);
5263 ds.replaceSequenceAt(vseqpos, dsq);
5264 ds.addSequence(tseq);
5269 ds.addSequence(dsq);
5276 * TODO use AlignmentI here and in related methods - needs
5277 * AlignmentI.getDataset() changed to return AlignmentI instead of Alignment
5279 Hashtable<String, AlignmentI> datasetIds = null;
5281 IdentityHashMap<AlignmentI, String> dataset2Ids = null;
5283 private AlignmentI getDatasetFor(String datasetId)
5285 if (datasetIds == null)
5287 datasetIds = new Hashtable<>();
5290 if (datasetIds.containsKey(datasetId))
5292 return datasetIds.get(datasetId);
5297 private void addDatasetRef(String datasetId, AlignmentI dataset)
5299 if (datasetIds == null)
5301 datasetIds = new Hashtable<>();
5303 datasetIds.put(datasetId, dataset);
5307 * make a new dataset ID for this jalview dataset alignment
5312 private String getDatasetIdRef(AlignmentI dataset)
5314 if (dataset.getDataset() != null)
5316 warn("Serious issue! Dataset Object passed to getDatasetIdRef is not a Jalview DATASET alignment...");
5318 String datasetId = makeHashCode(dataset, null);
5319 if (datasetId == null)
5321 // make a new datasetId and record it
5322 if (dataset2Ids == null)
5324 dataset2Ids = new IdentityHashMap<>();
5328 datasetId = dataset2Ids.get(dataset);
5330 if (datasetId == null)
5332 datasetId = "ds" + dataset2Ids.size() + 1;
5333 dataset2Ids.put(dataset, datasetId);
5339 private void addDBRefs(SequenceI datasetSequence, Sequence sequence)
5341 for (int d = 0; d < sequence.getDBRefCount(); d++)
5343 DBRef dr = sequence.getDBRef(d);
5344 jalview.datamodel.DBRefEntry entry = new jalview.datamodel.DBRefEntry(
5345 sequence.getDBRef(d).getSource(),
5346 sequence.getDBRef(d).getVersion(),
5347 sequence.getDBRef(d).getAccessionId());
5348 if (dr.getMapping() != null)
5350 entry.setMap(addMapping(dr.getMapping()));
5352 datasetSequence.addDBRef(entry);
5356 private jalview.datamodel.Mapping addMapping(Mapping m)
5358 SequenceI dsto = null;
5359 // Mapping m = dr.getMapping();
5360 int fr[] = new int[m.getMapListFromCount() * 2];
5361 Enumeration f = m.enumerateMapListFrom();
5362 for (int _i = 0; f.hasMoreElements(); _i += 2)
5364 MapListFrom mf = (MapListFrom) f.nextElement();
5365 fr[_i] = mf.getStart();
5366 fr[_i + 1] = mf.getEnd();
5368 int fto[] = new int[m.getMapListToCount() * 2];
5369 f = m.enumerateMapListTo();
5370 for (int _i = 0; f.hasMoreElements(); _i += 2)
5372 MapListTo mf = (MapListTo) f.nextElement();
5373 fto[_i] = mf.getStart();
5374 fto[_i + 1] = mf.getEnd();
5376 jalview.datamodel.Mapping jmap = new jalview.datamodel.Mapping(dsto, fr,
5377 fto, (int) m.getMapFromUnit(), (int) m.getMapToUnit());
5378 if (m.getMappingChoice() != null)
5380 MappingChoice mc = m.getMappingChoice();
5381 if (mc.getDseqFor() != null)
5383 String dsfor = "" + mc.getDseqFor();
5384 if (seqRefIds.containsKey(dsfor))
5389 jmap.setTo(seqRefIds.get(dsfor));
5393 frefedSequence.add(newMappingRef(dsfor, jmap));
5399 * local sequence definition
5401 Sequence ms = mc.getSequence();
5402 SequenceI djs = null;
5403 String sqid = ms.getDsseqid();
5404 if (sqid != null && sqid.length() > 0)
5407 * recover dataset sequence
5409 djs = seqRefIds.get(sqid);
5414 "Warning - making up dataset sequence id for DbRef sequence map reference");
5415 sqid = ((Object) ms).toString(); // make up a new hascode for
5416 // undefined dataset sequence hash
5417 // (unlikely to happen)
5423 * make a new dataset sequence and add it to refIds hash
5425 djs = new jalview.datamodel.Sequence(ms.getName(),
5427 djs.setStart(jmap.getMap().getToLowest());
5428 djs.setEnd(jmap.getMap().getToHighest());
5429 djs.setVamsasId(uniqueSetSuffix + sqid);
5431 incompleteSeqs.put(sqid, djs);
5432 seqRefIds.put(sqid, djs);
5435 jalview.bin.Cache.log.debug("about to recurse on addDBRefs.");
5445 * Provides a 'copy' of an alignment view (on action New View) by 'saving' the
5446 * view as XML (but not to file), and then reloading it
5451 public AlignmentPanel copyAlignPanel(AlignmentPanel ap)
5454 JalviewModel jm = saveState(ap, null, null, null);
5456 uniqueSetSuffix = "";
5457 jm.getJalviewModelSequence().getViewport(0).setId(null);
5458 // we don't overwrite the view we just copied
5460 if (this.frefedSequence == null)
5462 frefedSequence = new Vector<>();
5465 viewportsAdded.clear();
5467 AlignFrame af = loadFromObject(jm, null, false, null);
5468 af.alignPanels.clear();
5469 af.closeMenuItem_actionPerformed(true);
5472 * if(ap.av.getAlignment().getAlignmentAnnotation()!=null) { for(int i=0;
5473 * i<ap.av.getAlignment().getAlignmentAnnotation().length; i++) {
5474 * if(!ap.av.getAlignment().getAlignmentAnnotation()[i].autoCalculated) {
5475 * af.alignPanel.av.getAlignment().getAlignmentAnnotation()[i] =
5476 * ap.av.getAlignment().getAlignmentAnnotation()[i]; } } }
5479 return af.alignPanel;
5482 private Hashtable jvids2vobj;
5484 private void warn(String msg)
5489 private void warn(String msg, Exception e)
5491 if (Cache.log != null)
5495 Cache.log.warn(msg, e);
5499 Cache.log.warn(msg);
5504 System.err.println("Warning: " + msg);
5507 e.printStackTrace();
5512 private void debug(String string)
5514 debug(string, null);
5517 private void debug(String msg, Exception e)
5519 if (Cache.log != null)
5523 Cache.log.debug(msg, e);
5527 Cache.log.debug(msg);
5532 System.err.println("Warning: " + msg);
5535 e.printStackTrace();
5541 * set the object to ID mapping tables used to write/recover objects and XML
5542 * ID strings for the jalview project. If external tables are provided then
5543 * finalize and clearSeqRefs will not clear the tables when the Jalview2XML
5544 * object goes out of scope. - also populates the datasetIds hashtable with
5545 * alignment objects containing dataset sequences
5548 * Map from ID strings to jalview datamodel
5550 * Map from jalview datamodel to ID strings
5554 public void setObjectMappingTables(Hashtable vobj2jv,
5555 IdentityHashMap jv2vobj)
5557 this.jv2vobj = jv2vobj;
5558 this.vobj2jv = vobj2jv;
5559 Iterator ds = jv2vobj.keySet().iterator();
5561 while (ds.hasNext())
5563 Object jvobj = ds.next();
5564 id = jv2vobj.get(jvobj).toString();
5565 if (jvobj instanceof jalview.datamodel.Alignment)
5567 if (((jalview.datamodel.Alignment) jvobj).getDataset() == null)
5569 addDatasetRef(id, (jalview.datamodel.Alignment) jvobj);
5572 else if (jvobj instanceof jalview.datamodel.Sequence)
5574 // register sequence object so the XML parser can recover it.
5575 if (seqRefIds == null)
5577 seqRefIds = new HashMap<>();
5579 if (seqsToIds == null)
5581 seqsToIds = new IdentityHashMap<>();
5583 seqRefIds.put(jv2vobj.get(jvobj).toString(), (SequenceI) jvobj);
5584 seqsToIds.put((SequenceI) jvobj, id);
5586 else if (jvobj instanceof jalview.datamodel.AlignmentAnnotation)
5589 AlignmentAnnotation jvann = (AlignmentAnnotation) jvobj;
5590 annotationIds.put(anid = jv2vobj.get(jvobj).toString(), jvann);
5591 if (jvann.annotationId == null)
5593 jvann.annotationId = anid;
5595 if (!jvann.annotationId.equals(anid))
5597 // TODO verify that this is the correct behaviour
5598 this.warn("Overriding Annotation ID for " + anid
5599 + " from different id : " + jvann.annotationId);
5600 jvann.annotationId = anid;
5603 else if (jvobj instanceof String)
5605 if (jvids2vobj == null)
5607 jvids2vobj = new Hashtable();
5608 jvids2vobj.put(jvobj, jv2vobj.get(jvobj).toString());
5613 Cache.log.debug("Ignoring " + jvobj.getClass() + " (ID = " + id);
5619 * set the uniqueSetSuffix used to prefix/suffix object IDs for jalview
5620 * objects created from the project archive. If string is null (default for
5621 * construction) then suffix will be set automatically.
5625 public void setUniqueSetSuffix(String string)
5627 uniqueSetSuffix = string;
5632 * uses skipList2 as the skipList for skipping views on sequence sets
5633 * associated with keys in the skipList
5637 public void setSkipList(Hashtable skipList2)
5639 skipList = skipList2;
5643 * Reads the jar entry of given name and returns its contents, or null if the
5644 * entry is not found.
5647 * @param jarEntryName
5650 protected String readJarEntry(jarInputStreamProvider jprovider,
5651 String jarEntryName)
5653 String result = null;
5654 BufferedReader in = null;
5659 * Reopen the jar input stream and traverse its entries to find a matching
5662 JarInputStream jin = jprovider.getJarInputStream();
5663 JarEntry entry = null;
5666 entry = jin.getNextJarEntry();
5667 } while (entry != null && !entry.getName().equals(jarEntryName));
5671 StringBuilder out = new StringBuilder(256);
5672 in = new BufferedReader(new InputStreamReader(jin, UTF_8));
5675 while ((data = in.readLine()) != null)
5679 result = out.toString();
5683 warn("Couldn't find entry in Jalview Jar for " + jarEntryName);
5685 } catch (Exception ex)
5687 ex.printStackTrace();
5695 } catch (IOException e)
5706 * Returns an incrementing counter (0, 1, 2...)
5710 private synchronized int nextCounter()
5716 * Populates an XML model of the feature colour scheme for one feature type
5718 * @param featureType
5722 protected static jalview.schemabinding.version2.Colour marshalColour(
5723 String featureType, FeatureColourI fcol)
5725 jalview.schemabinding.version2.Colour col = new jalview.schemabinding.version2.Colour();
5726 if (fcol.isSimpleColour())
5728 col.setRGB(Format.getHexString(fcol.getColour()));
5732 col.setRGB(Format.getHexString(fcol.getMaxColour()));
5733 col.setMin(fcol.getMin());
5734 col.setMax(fcol.getMax());
5735 col.setMinRGB(jalview.util.Format.getHexString(fcol.getMinColour()));
5736 col.setAutoScale(fcol.isAutoScaled());
5737 col.setThreshold(fcol.getThreshold());
5738 col.setColourByLabel(fcol.isColourByLabel());
5739 col.setThreshType(fcol.isAboveThreshold() ? ColourThreshTypeType.ABOVE
5740 : (fcol.isBelowThreshold() ? ColourThreshTypeType.BELOW
5741 : ColourThreshTypeType.NONE));
5742 if (fcol.isColourByAttribute())
5744 col.setAttributeName(fcol.getAttributeName());
5746 Color noColour = fcol.getNoColour();
5747 if (noColour == null)
5749 col.setNoValueColour(NoValueColour.NONE);
5751 else if (noColour == fcol.getMaxColour())
5753 col.setNoValueColour(NoValueColour.MAX);
5757 col.setNoValueColour(NoValueColour.MIN);
5760 col.setName(featureType);
5765 * Populates an XML model of the feature filter(s) for one feature type
5767 * @param firstMatcher
5768 * the first (or only) match condition)
5770 * remaining match conditions (if any)
5772 * if true, conditions are and-ed, else or-ed
5774 protected static MatcherSet marshalFilter(FeatureMatcherI firstMatcher,
5775 Iterator<FeatureMatcherI> filters, boolean and)
5777 MatcherSet result = new MatcherSet();
5779 if (filters.hasNext())
5784 CompoundMatcher compound = new CompoundMatcher();
5785 compound.setAnd(and);
5786 MatcherSet matcher1 = marshalFilter(firstMatcher,
5787 Collections.emptyIterator(), and);
5788 compound.addMatcherSet(matcher1);
5789 FeatureMatcherI nextMatcher = filters.next();
5790 MatcherSet matcher2 = marshalFilter(nextMatcher, filters, and);
5791 compound.addMatcherSet(matcher2);
5792 result.setCompoundMatcher(compound);
5797 * single condition matcher
5799 MatchCondition matcherModel = new MatchCondition();
5800 matcherModel.setCondition(
5801 firstMatcher.getMatcher().getCondition().getStableName());
5802 matcherModel.setValue(firstMatcher.getMatcher().getPattern());
5803 if (firstMatcher.isByAttribute())
5805 matcherModel.setBy(FeatureMatcherByType.BYATTRIBUTE);
5806 matcherModel.setAttributeName(firstMatcher.getAttribute());
5808 else if (firstMatcher.isByLabel())
5810 matcherModel.setBy(FeatureMatcherByType.BYLABEL);
5812 else if (firstMatcher.isByScore())
5814 matcherModel.setBy(FeatureMatcherByType.BYSCORE);
5816 result.setMatchCondition(matcherModel);
5823 * Loads one XML model of a feature filter to a Jalview object
5825 * @param featureType
5826 * @param matcherSetModel
5829 protected static FeatureMatcherSetI unmarshalFilter(
5830 String featureType, MatcherSet matcherSetModel)
5832 FeatureMatcherSetI result = new FeatureMatcherSet();
5835 unmarshalFilterConditions(result, matcherSetModel, true);
5836 } catch (IllegalStateException e)
5838 // mixing AND and OR conditions perhaps
5840 String.format("Error reading filter conditions for '%s': %s",
5841 featureType, e.getMessage()));
5842 // return as much as was parsed up to the error
5849 * Adds feature match conditions to matcherSet as unmarshalled from XML
5850 * (possibly recursively for compound conditions)
5853 * @param matcherSetModel
5855 * if true, multiple conditions are AND-ed, else they are OR-ed
5856 * @throws IllegalStateException
5857 * if AND and OR conditions are mixed
5859 protected static void unmarshalFilterConditions(
5860 FeatureMatcherSetI matcherSet, MatcherSet matcherSetModel,
5863 MatchCondition mc = matcherSetModel.getMatchCondition();
5869 FeatureMatcherByType filterBy = mc.getBy();
5870 Condition cond = Condition.fromString(mc.getCondition());
5871 String pattern = mc.getValue();
5872 FeatureMatcherI matchCondition = null;
5873 if (filterBy == FeatureMatcherByType.BYLABEL)
5875 matchCondition = FeatureMatcher.byLabel(cond, pattern);
5877 else if (filterBy == FeatureMatcherByType.BYSCORE)
5879 matchCondition = FeatureMatcher.byScore(cond, pattern);
5882 else if (filterBy == FeatureMatcherByType.BYATTRIBUTE)
5884 String[] attNames = mc.getAttributeName();
5885 matchCondition = FeatureMatcher.byAttribute(cond, pattern,
5890 * note this throws IllegalStateException if AND-ing to a
5891 * previously OR-ed compound condition, or vice versa
5895 matcherSet.and(matchCondition);
5899 matcherSet.or(matchCondition);
5905 * compound condition
5907 MatcherSet[] matchers = matcherSetModel.getCompoundMatcher()
5909 boolean anded = matcherSetModel.getCompoundMatcher().getAnd();
5910 if (matchers.length == 2)
5912 unmarshalFilterConditions(matcherSet, matchers[0], anded);
5913 unmarshalFilterConditions(matcherSet, matchers[1], anded);
5917 System.err.println("Malformed compound filter condition");
5923 * Loads one XML model of a feature colour to a Jalview object
5925 * @param colourModel
5928 protected static FeatureColourI unmarshalColour(
5929 jalview.schemabinding.version2.Colour colourModel)
5931 FeatureColourI colour = null;
5933 if (colourModel.hasMax())
5935 Color mincol = null;
5936 Color maxcol = null;
5937 Color noValueColour = null;
5941 mincol = new Color(Integer.parseInt(colourModel.getMinRGB(), 16));
5942 maxcol = new Color(Integer.parseInt(colourModel.getRGB(), 16));
5943 } catch (Exception e)
5945 Cache.log.warn("Couldn't parse out graduated feature color.", e);
5948 NoValueColour noCol = colourModel.getNoValueColour();
5949 if (noCol == NoValueColour.MIN)
5951 noValueColour = mincol;
5953 else if (noCol == NoValueColour.MAX)
5955 noValueColour = maxcol;
5958 colour = new FeatureColour(mincol, maxcol, noValueColour,
5959 colourModel.getMin(),
5960 colourModel.getMax());
5961 String[] attributes = colourModel.getAttributeName();
5962 if (attributes != null && attributes.length > 0)
5964 colour.setAttributeName(attributes);
5966 if (colourModel.hasAutoScale())
5968 colour.setAutoScaled(colourModel.getAutoScale());
5970 if (colourModel.hasColourByLabel())
5972 colour.setColourByLabel(colourModel.getColourByLabel());
5974 if (colourModel.hasThreshold())
5976 colour.setThreshold(colourModel.getThreshold());
5978 ColourThreshTypeType ttyp = colourModel.getThreshType();
5981 if (ttyp == ColourThreshTypeType.ABOVE)
5983 colour.setAboveThreshold(true);
5985 else if (ttyp == ColourThreshTypeType.BELOW)
5987 colour.setBelowThreshold(true);
5993 Color color = new Color(Integer.parseInt(colourModel.getRGB(), 16));
5994 colour = new FeatureColour(color);