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.
24 import java.awt.Color;
25 import java.io.IOException;
26 import java.util.ArrayList;
27 import java.util.Hashtable;
28 import java.util.Iterator;
29 import java.util.List;
30 import java.util.Vector;
32 import org.json.simple.JSONArray;
33 import org.json.simple.JSONObject;
34 import org.json.simple.parser.JSONParser;
36 import jalview.api.AlignViewportI;
37 import jalview.api.ComplexAlignFile;
38 import jalview.api.FeatureRenderer;
39 import jalview.api.FeaturesDisplayedI;
40 import jalview.datamodel.AlignmentAnnotation;
41 import jalview.datamodel.AlignmentI;
42 import jalview.datamodel.Annotation;
43 import jalview.datamodel.ColumnSelection;
44 import jalview.datamodel.HiddenSequences;
45 import jalview.datamodel.Sequence;
46 import jalview.datamodel.SequenceFeature;
47 import jalview.datamodel.SequenceGroup;
48 import jalview.datamodel.SequenceI;
49 import jalview.gui.AlignViewport;
50 import jalview.json.binding.v1.AlignmentAnnotationPojo;
51 import jalview.json.binding.v1.AlignmentPojo;
52 import jalview.json.binding.v1.AlignmentPojo.JalviewBioJsColorSchemeMapper;
53 import jalview.json.binding.v1.AnnotationPojo;
54 import jalview.json.binding.v1.SequenceFeaturesPojo;
55 import jalview.json.binding.v1.SequenceGrpPojo;
56 import jalview.json.binding.v1.SequencePojo;
57 import jalview.schemes.ColourSchemeI;
58 import jalview.schemes.ColourSchemeProperty;
60 public class JSONFile extends AlignFile implements ComplexAlignFile
62 private ColourSchemeI colourScheme;
64 private String version = "2.9";
66 private String webstartUrl = "www.jalview.org/services/launchApp";
68 private String application = "Jalview";
70 public static final String FILE_EXT = "json";
72 public static final String FILE_DESC = "JSON";
74 private String globalColorScheme;
76 private boolean showSeqFeatures;
78 private Hashtable<String, Sequence> seqMap;
80 private FeaturesDisplayedI displayedFeatures;
82 private FeatureRenderer fr;
84 private JSONExportSettings jsonExportSettings;
86 private List<int[]> hiddenColumns;
88 private ColumnSelection columnSelection;
90 private List<String> hiddenSeqRefs;
92 private ArrayList<SequenceI> hiddenSequences;
99 public JSONFile(FileParse source) throws IOException
104 public JSONFile(String inFile, String type) throws IOException
110 public void parse() throws IOException
112 StringBuilder jsonStringBuilder = new StringBuilder();
114 while ((currentLine = nextLine()) != null)
116 jsonStringBuilder.append(currentLine);
118 parse(jsonStringBuilder.toString());
123 public String print()
125 String jsonOutput = null;
128 if (getJsonExportSettings() == null)
130 jsonExportSettings = new JSONExportSettings();
131 jsonExportSettings.setExportAnnotations(true);
132 jsonExportSettings.setExportGroups(true);
133 jsonExportSettings.setExportJalviewSettings(true);
134 jsonExportSettings.setExportSequenceFeatures(true);
137 AlignmentPojo jsonAlignmentPojo = new AlignmentPojo();
138 if (getViewport() != null)
140 globalColorScheme = ColourSchemeProperty
141 .getColourName(getViewport()
142 .getGlobalColourScheme());
143 setDisplayedFeatures(getViewport().getFeaturesDisplayed());
144 showSeqFeatures = getViewport().isShowSequenceFeatures();
145 fr = getViewport().getFeatureRenderer();
149 for (SequenceI seq : seqs)
151 StringBuilder name = new StringBuilder();
152 name.append(seq.getName()).append("/").append(seq.getStart())
153 .append("-").append(seq.getEnd());
154 SequencePojo jsonSeqPojo = new SequencePojo();
155 jsonSeqPojo.setId(String.valueOf(seq.hashCode()));
156 jsonSeqPojo.setOrder(++count);
157 jsonSeqPojo.setEnd(seq.getEnd());
158 jsonSeqPojo.setStart(seq.getStart());
159 jsonSeqPojo.setName(name.toString());
160 jsonSeqPojo.setSeq(seq.getSequenceAsString());
161 jsonAlignmentPojo.getSeqs().add(jsonSeqPojo);
164 if (jsonExportSettings.isExportJalviewSettings())
166 jsonAlignmentPojo.setGlobalColorScheme(globalColorScheme);
167 jsonAlignmentPojo.getAppSettings().put("application", application);
168 jsonAlignmentPojo.getAppSettings().put("version", version);
169 jsonAlignmentPojo.getAppSettings().put("webStartUrl", webstartUrl);
170 jsonAlignmentPojo.getAppSettings().put("showSeqFeatures",
171 String.valueOf(showSeqFeatures));
173 String[] hiddenSections = exportHiddenSections();
174 if (hiddenSections != null && getViewport().isIncludeHiddenRegion())
176 if (hiddenSections[0] != null)
178 jsonAlignmentPojo.getAppSettings().put("hiddenCols",
179 String.valueOf(hiddenSections[0]));
181 if (hiddenSections[1] != null)
183 jsonAlignmentPojo.getAppSettings().put("hiddenSeqs",
184 String.valueOf(hiddenSections[1]));
189 if (jsonExportSettings.isExportAnnotations())
192 .setAlignAnnotation(annotationToJsonPojo(annotations));
195 if (jsonExportSettings.isExportSequenceFeatures())
198 .setSeqFeatures(sequenceFeatureToJsonPojo(seqs, fr));
201 if (jsonExportSettings.isExportGroups() && seqGroups != null
202 && seqGroups.size() > 0)
204 for (SequenceGroup seqGrp : seqGroups)
206 SequenceGrpPojo seqGrpPojo = new SequenceGrpPojo();
207 seqGrpPojo.setGroupName(seqGrp.getName());
208 seqGrpPojo.setColourScheme(ColourSchemeProperty
209 .getColourName(seqGrp.cs));
210 seqGrpPojo.setColourText(seqGrp.getColourText());
211 seqGrpPojo.setDescription(seqGrp.getDescription());
212 seqGrpPojo.setDisplayBoxes(seqGrp.getDisplayBoxes());
213 seqGrpPojo.setDisplayText(seqGrp.getDisplayText());
214 seqGrpPojo.setEndRes(seqGrp.getEndRes());
215 seqGrpPojo.setStartRes(seqGrp.getStartRes());
216 seqGrpPojo.setShowNonconserved(seqGrp.getShowNonconserved());
217 for (SequenceI seq : seqGrp.getSequences())
219 seqGrpPojo.getSeqsHash().add(String.valueOf(seq.hashCode()));
221 jsonAlignmentPojo.getSeqGroups().add(seqGrpPojo);
224 org.json.JSONObject generatedJSon = new org.json.JSONObject(
226 jsonOutput = generatedJSon.toString();
227 return jsonOutput.replaceAll("xstart", "xStart").replaceAll("xend",
229 } catch (Exception e)
236 public String[] exportHiddenSections()
238 String[] hiddenSections = new String[2];
239 if (getViewport() == null)
244 // hidden column business
245 if (getViewport().hasHiddenColumns())
247 List<int[]> hiddenCols = getViewport().getColumnSelection()
249 StringBuilder hiddenColsBuilder = new StringBuilder();
250 for (int[] range : hiddenCols)
252 hiddenColsBuilder.append(";").append(range[0]).append("-")
256 hiddenColsBuilder.deleteCharAt(0);
257 hiddenSections[0] = hiddenColsBuilder.toString();
260 // hidden rows/seqs business
261 HiddenSequences hiddenSeqsObj = getViewport().getAlignment()
262 .getHiddenSequences();
263 if (hiddenSeqsObj == null || hiddenSeqsObj.hiddenSequences == null)
265 return hiddenSections;
268 SequenceI[] hiddenSeqs = hiddenSeqsObj.hiddenSequences;
269 StringBuilder hiddenSeqsBuilder = new StringBuilder();
270 for (SequenceI hiddenSeq : hiddenSeqs)
272 if (hiddenSeq != null)
274 hiddenSeqsBuilder.append(";").append(hiddenSeq.hashCode());
277 if (hiddenSeqsBuilder.length() > 0)
279 hiddenSeqsBuilder.deleteCharAt(0);
281 hiddenSections[1] = hiddenSeqsBuilder.toString();
283 return hiddenSections;
286 public static List<SequenceFeaturesPojo> sequenceFeatureToJsonPojo(
287 List<SequenceI> seqs, FeatureRenderer fr)
289 FeaturesDisplayedI displayedFeatures = (fr == null) ? null : fr
290 .getFeaturesDisplayed();
291 List<SequenceFeaturesPojo> sequenceFeaturesPojo = new ArrayList<SequenceFeaturesPojo>();
292 for (SequenceI seq : seqs)
294 SequenceI dataSetSequence = seq.getDatasetSequence();
295 SequenceFeature[] seqFeatures = (dataSetSequence == null) ? null
296 : seq.getDatasetSequence().getSequenceFeatures();
298 seqFeatures = (seqFeatures == null) ? seq.getSequenceFeatures()
300 if (seqFeatures == null)
305 for (SequenceFeature sf : seqFeatures)
307 if (displayedFeatures != null
308 && displayedFeatures.isVisible(sf.getType()))
310 SequenceFeaturesPojo jsonFeature = new SequenceFeaturesPojo(
311 String.valueOf(seq.hashCode()));
312 String featureColour = (fr == null) ? null : jalview.util.Format
314 .findFeatureColour(Color.white, seq,
315 seq.findIndex(sf.getBegin())));
316 jsonFeature.setXstart(seq.findIndex(sf.getBegin()) - 1);
317 jsonFeature.setXend(seq.findIndex(sf.getEnd()));
318 jsonFeature.setType(sf.getType());
319 jsonFeature.setDescription(sf.getDescription());
320 jsonFeature.setLinks(sf.links);
321 jsonFeature.setOtherDetails(sf.otherDetails);
322 jsonFeature.setScore(sf.getScore());
323 jsonFeature.setFillColor(featureColour);
324 jsonFeature.setFeatureGroup(sf.getFeatureGroup());
325 sequenceFeaturesPojo.add(jsonFeature);
329 return sequenceFeaturesPojo;
332 public static List<AlignmentAnnotationPojo> annotationToJsonPojo(
333 Vector<AlignmentAnnotation> annotations)
335 List<AlignmentAnnotationPojo> jsonAnnotations = new ArrayList<AlignmentAnnotationPojo>();
336 if (annotations == null)
338 return jsonAnnotations;
340 for (AlignmentAnnotation annot : annotations)
342 AlignmentAnnotationPojo alignAnnotPojo = new AlignmentAnnotationPojo();
343 alignAnnotPojo.setDescription(annot.description);
344 alignAnnotPojo.setLabel(annot.label);
345 for (Annotation annotation : annot.annotations)
347 AnnotationPojo annotationPojo = new AnnotationPojo();
348 if (annotation != null)
350 annotationPojo.setDescription(annotation.description);
351 annotationPojo.setValue(annotation.value);
353 .setSecondaryStructure(annotation.secondaryStructure);
354 annotationPojo.setDisplayCharacter(annotation.displayCharacter);
355 alignAnnotPojo.getAnnotations().add(annotationPojo);
359 alignAnnotPojo.getAnnotations().add(annotationPojo);
362 jsonAnnotations.add(alignAnnotPojo);
364 return jsonAnnotations;
367 @SuppressWarnings("unchecked")
368 public JSONFile parse(String jsonAlignmentString)
372 JSONParser jsonParser = new JSONParser();
373 JSONObject alignmentJsonObj = (JSONObject) jsonParser
374 .parse(jsonAlignmentString);
375 JSONArray seqJsonArray = (JSONArray) alignmentJsonObj.get("seqs");
376 JSONArray alAnnotJsonArray = (JSONArray) alignmentJsonObj
377 .get("alignAnnotation");
378 JSONArray jsonSeqArray = (JSONArray) alignmentJsonObj
380 JSONArray seqGrpJsonArray = (JSONArray) alignmentJsonObj
382 JSONObject jvSettingsJsonObj = (JSONObject) alignmentJsonObj
385 if (jvSettingsJsonObj != null)
387 String jsColourScheme = (String) jvSettingsJsonObj
388 .get("globalColorScheme");
389 Boolean showFeatures = Boolean.valueOf(jvSettingsJsonObj.get(
390 "showSeqFeatures").toString());
391 setColourScheme(getJalviewColorScheme(jsColourScheme));
392 setShowSeqFeatures(showFeatures);
393 parseHiddenSeqRefsAsList(jvSettingsJsonObj);
394 parseHiddenCols(jvSettingsJsonObj);
397 hiddenSequences = new ArrayList<SequenceI>();
398 seqMap = new Hashtable<String, Sequence>();
399 for (Iterator<JSONObject> sequenceIter = seqJsonArray.iterator(); sequenceIter
402 JSONObject sequence = sequenceIter.next();
403 String sequcenceString = sequence.get("seq").toString();
404 String sequenceName = sequence.get("name").toString();
405 String seqUniqueId = sequence.get("id").toString();
406 int start = Integer.valueOf(sequence.get("start").toString());
407 int end = Integer.valueOf(sequence.get("end").toString());
408 Sequence seq = new Sequence(sequenceName, sequcenceString, start,
410 if (hiddenSeqRefs != null && hiddenSeqRefs.contains(seqUniqueId))
412 hiddenSequences.add(seq);
415 seqMap.put(seqUniqueId, seq);
417 parseFeatures(jsonSeqArray);
419 for (Iterator<JSONObject> seqGrpIter = seqGrpJsonArray.iterator(); seqGrpIter
422 JSONObject seqGrpObj = seqGrpIter.next();
423 String grpName = seqGrpObj.get("groupName").toString();
424 String colourScheme = seqGrpObj.get("colourScheme").toString();
425 String description = (seqGrpObj.get("description") == null) ? null
426 : seqGrpObj.get("description").toString();
427 boolean displayBoxes = Boolean.valueOf(seqGrpObj
428 .get("displayBoxes").toString());
429 boolean displayText = Boolean.valueOf(seqGrpObj.get("displayText")
431 boolean colourText = Boolean.valueOf(seqGrpObj.get("colourText")
433 boolean showNonconserved = Boolean.valueOf(seqGrpObj.get(
434 "showNonconserved").toString());
435 int startRes = Integer
436 .valueOf(seqGrpObj.get("startRes").toString());
437 int endRes = Integer.valueOf(seqGrpObj.get("endRes").toString());
438 JSONArray seqsHashArray = (JSONArray) seqGrpObj.get("seqsHash");
440 ArrayList<SequenceI> grpSeqs = new ArrayList<SequenceI>();
441 if (seqsHashArray.size() > 0)
443 Iterator<String> seqHashIter = seqsHashArray.iterator();
444 while (seqHashIter.hasNext())
446 String seqHash = seqHashIter.next();
447 Sequence sequence = seqMap.get(seqHash);
448 if (sequence != null)
450 grpSeqs.add(sequence);
454 ColourSchemeI scheme = getJalviewColorScheme(colourScheme);
455 SequenceGroup seqGrp = new SequenceGroup(grpSeqs, grpName, scheme,
456 displayBoxes, displayText, colourText, startRes, endRes);
457 seqGrp.setShowNonconserved(showNonconserved);
458 seqGrp.setDescription(description);
459 this.seqGroups.add(seqGrp);
463 for (Iterator<JSONObject> alAnnotIter = alAnnotJsonArray.iterator(); alAnnotIter
466 JSONObject alAnnot = alAnnotIter.next();
467 JSONArray annotJsonArray = (JSONArray) alAnnot.get("annotations");
468 Annotation[] annotations = new Annotation[annotJsonArray.size()];
470 for (Iterator<JSONObject> annotIter = annotJsonArray.iterator(); annotIter
473 JSONObject annot = annotIter.next();
476 annotations[count] = null;
480 float val = annot.get("value") == null ? null : Float
481 .valueOf(annot.get("value").toString());
482 String desc = annot.get("description") == null ? null : annot
483 .get("description").toString();
485 char ss = annot.get("secondaryStructure") == null ? ' '
486 : annot.get("secondaryStructure").toString().charAt(0);
487 String displayChar = annot.get("displayCharacter").toString();
489 annotations[count] = new Annotation(displayChar, desc, ss, val);
494 AlignmentAnnotation alignAnnot = new AlignmentAnnotation(alAnnot
495 .get("label").toString(), alAnnot.get("description")
496 .toString(), annotations);
497 this.annotations.add(alignAnnot);
500 } catch (Exception e)
507 public void parseHiddenSeqRefsAsList(JSONObject jvSettingsJson)
509 hiddenSeqRefs = new ArrayList<String>();
510 String hiddenSeqs = (String) jvSettingsJson.get("hiddenSeqs");
511 if(hiddenSeqs != null && !hiddenSeqs.isEmpty()){
512 String[] seqRefs = hiddenSeqs.split(";");
513 for(String seqRef : seqRefs){
514 hiddenSeqRefs.add(seqRef);
519 public void parseHiddenCols(JSONObject jvSettingsJson)
521 // hiddenColumns = new ArrayList<int[]>();
522 String hiddenCols = (String) jvSettingsJson.get("hiddenCols");
523 if(hiddenCols != null && !hiddenCols.isEmpty()){
524 columnSelection = new ColumnSelection();
525 String[] rangeStrings = hiddenCols.split(";");
526 for(String rangeString : rangeStrings){
527 String[] range = rangeString.split("-");
528 // hiddenColumns.add(new int[]
529 // { Integer.valueOf(range[0]), Integer.valueOf(range[1]) });
530 columnSelection.hideColumns(Integer.valueOf(range[0]),
531 Integer.valueOf(range[1]));
536 @SuppressWarnings("unchecked")
537 private void parseFeatures(JSONArray jsonSeqFeatures)
539 if (jsonSeqFeatures != null)
541 for (Iterator<JSONObject> seqFeatureItr = jsonSeqFeatures.iterator(); seqFeatureItr
544 JSONObject jsonFeature = seqFeatureItr.next();
545 Long begin = (Long) jsonFeature.get("xStart");
546 Long end = (Long) jsonFeature.get("xEnd");
547 String type = (String) jsonFeature.get("type");
548 String featureGrp = (String) jsonFeature.get("featureGroup");
549 String descripiton = (String) jsonFeature.get("description");
550 String seqRef = (String) jsonFeature.get("sequenceRef");
551 Float score = Float.valueOf(jsonFeature.get("score").toString());
552 // Hashtable otherDetails = (Hashtable) jsonFeature
553 // .get("otherDetails");
554 // sequenceFeature.otherDetails = otherDetails;
556 Sequence seq = seqMap.get(seqRef);
557 SequenceFeature sequenceFeature = new SequenceFeature();
558 JSONArray linksJsonArray = (JSONArray) jsonFeature.get("links");
559 if (linksJsonArray != null && linksJsonArray.size() > 0)
561 Iterator<String> linkList = linksJsonArray.iterator();
562 while (linkList.hasNext())
564 String link = linkList.next();
565 sequenceFeature.addLink(link);
568 sequenceFeature.setFeatureGroup(featureGrp);
569 sequenceFeature.setScore(score);
570 sequenceFeature.setDescription(descripiton);
571 sequenceFeature.setType(type);
572 sequenceFeature.setBegin(seq.findPosition(begin.intValue()));
573 sequenceFeature.setEnd(seq.findPosition(end.intValue()) - 1);
574 seq.addSequenceFeature(sequenceFeature);
579 public static ColourSchemeI getJalviewColorScheme(
580 String bioJsColourSchemeName)
582 ColourSchemeI jalviewColor = null;
583 for (JalviewBioJsColorSchemeMapper cs : JalviewBioJsColorSchemeMapper
586 if (cs.getBioJsName().equalsIgnoreCase(bioJsColourSchemeName))
588 jalviewColor = cs.getJvColourScheme();
595 public AlignViewportI getViewport(AlignmentI al)
597 AlignViewportI viewport = new AlignViewport(al, getColumnSelection());
598 viewport.setGlobalColourScheme(getColourScheme());
599 viewport.setShowSequenceFeatures(isShowSeqFeatures());
603 public String getGlobalColorScheme()
605 return globalColorScheme;
608 public void setGlobalColorScheme(String globalColorScheme)
610 this.globalColorScheme = globalColorScheme;
613 public ColourSchemeI getColourScheme()
618 public void setColourScheme(ColourSchemeI colourScheme)
620 this.colourScheme = colourScheme;
623 public FeaturesDisplayedI getDisplayedFeatures()
625 return displayedFeatures;
628 public void setDisplayedFeatures(FeaturesDisplayedI displayedFeatures)
630 this.displayedFeatures = displayedFeatures;
633 public JSONExportSettings getJsonExportSettings()
635 return jsonExportSettings;
638 public void setJsonExportSettings(JSONExportSettings jsonExportSettings)
640 this.jsonExportSettings = jsonExportSettings;
644 public static String getJSONData(AlignViewportI av)
646 JSONFile jsonFile = new JSONFile();
647 jsonFile.setViewport(av);
648 jsonFile.seqGroups = av.getAlignment().getGroups();
649 jsonFile.setDisplayedFeatures(av.getFeaturesDisplayed());
651 for (SequenceI seq : av.getAlignment().getSequences())
653 jsonFile.seqs.add(seq);
656 // Add non auto calculated annotation to AlignFile
657 for (AlignmentAnnotation annot : av.getAlignment()
658 .getAlignmentAnnotation())
660 if (annot != null && !annot.autoCalculated)
662 if (annot.label.equals("PDB.CATempFactor"))
666 jsonFile.annotations.add(annot);
669 String jsonString = jsonFile.print();
673 public boolean isShowSeqFeatures()
675 return showSeqFeatures;
678 public void setShowSeqFeatures(boolean showSeqFeatures)
680 this.showSeqFeatures = showSeqFeatures;
683 public Vector<AlignmentAnnotation> getAnnotations()
688 public List<int[]> getHiddenColumns()
690 return hiddenColumns;
693 public ColumnSelection getColumnSelection()
695 return columnSelection;
698 public void setColumnSelection(ColumnSelection columnSelection)
700 this.columnSelection = columnSelection;
703 public SequenceI[] getHiddenSequences()
705 if (hiddenSequences == null || hiddenSequences.isEmpty())
707 return new SequenceI[]
710 synchronized (hiddenSequences)
712 return hiddenSequences.toArray(new SequenceI[hiddenSequences.size()]);
716 public void setHiddenSequences(ArrayList<SequenceI> hiddenSequences)
718 this.hiddenSequences = hiddenSequences;
721 public class JSONExportSettings
723 private boolean exportSequence;
725 private boolean exportSequenceFeatures;
727 private boolean exportAnnotations;
729 private boolean exportGroups;
731 private boolean exportJalviewSettings;
733 public boolean isExportSequence()
735 return exportSequence;
738 public void setExportSequence(boolean exportSequence)
740 this.exportSequence = exportSequence;
743 public boolean isExportSequenceFeatures()
745 return exportSequenceFeatures;
748 public void setExportSequenceFeatures(boolean exportSequenceFeatures)
750 this.exportSequenceFeatures = exportSequenceFeatures;
753 public boolean isExportAnnotations()
755 return exportAnnotations;
758 public void setExportAnnotations(boolean exportAnnotations)
760 this.exportAnnotations = exportAnnotations;
763 public boolean isExportGroups()
768 public void setExportGroups(boolean exportGroups)
770 this.exportGroups = exportGroups;
773 public boolean isExportJalviewSettings()
775 return exportJalviewSettings;
778 public void setExportJalviewSettings(boolean exportJalviewSettings)
780 this.exportJalviewSettings = exportJalviewSettings;