X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fgui%2FJalview2XML.java;h=7e2d1dd3d19b41fa90c99a1289505efbfcea4186;hb=59c22b05925dd3b4d148c1ce0e43eea12bc64ba7;hp=008be21188ac3dbb809014943462fe666b309df9;hpb=c901bd1778574b5792a7ee168bfe3e1addd3e181;p=jalview.git diff --git a/src/jalview/gui/Jalview2XML.java b/src/jalview/gui/Jalview2XML.java index 008be21..7e2d1dd 100755 --- a/src/jalview/gui/Jalview2XML.java +++ b/src/jalview/gui/Jalview2XML.java @@ -1,466 +1,957 @@ +/* + * Jalview - A Sequence Alignment Editor and Viewer + * Copyright (C) 2005 AM Waterhouse, J Procter, G Barton, M Clamp, S Searle + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA + */ package jalview.gui; +import jalview.io.*; + +import jalview.schemes.*; + import java.io.*; + +import java.net.*; + import java.util.*; + import java.util.jar.*; +import javax.swing.*; + import jalview.binding.*; -import jalview.schemes.*; -import javax.swing.JInternalFrame; +/** + * DOCUMENT ME! + * + * @author $author$ + * @version $Revision$ + */ public class Jalview2XML { + // SAVES SEVERAL ALIGNEMENT WINDOWS TO SAME JARFILE + public static void SaveState(File statefile) + { + long creation = System.currentTimeMillis(); + JInternalFrame[] frames = Desktop.desktop.getAllFrames(); - public static void SaveState(File statefile) - { - long creation = System.currentTimeMillis(); - JInternalFrame[] frames = Desktop.desktop.getAllFrames(); - try{ - JalviewState state = new JalviewState(); + if (frames == null) + { + return; + } - Vector shortNames = new Vector(); - for (int i = 0; i < frames.length; i++) + try { - if (frames[i] instanceof AlignFrame) - { - AlignFrame af = (AlignFrame) frames[i]; + FileOutputStream fos = new FileOutputStream(statefile); + JarOutputStream jout = new JarOutputStream(fos); - String shortName = af.getTitle(); + //NOTE UTF-8 MUST BE USED FOR WRITING UNICODE CHARS + //////////////////////////////////////////////////// + PrintWriter out = new PrintWriter(new OutputStreamWriter(jout, + "UTF-8")); - shortName = shortName.replace('/', '_'); - shortName = shortName.replace('\\', '_'); - String jarFile = statefile.getParent()+File.separatorChar+shortName+".jar"; + Vector shortNames = new Vector(); - int count=1; - while( shortNames.contains(shortName) ) + //REVERSE ORDER + for (int i = frames.length - 1; i > -1; i--) { - if(shortName.endsWith("_"+(count-1))) - shortName = shortName.substring(0, shortName.lastIndexOf("_")); + if (frames[i] instanceof AlignFrame) + { + AlignFrame af = (AlignFrame) frames[i]; + + String shortName = af.getTitle(); - shortName = shortName.concat("_"+count); - count++; + if (shortName.indexOf(File.separatorChar) > -1) + { + shortName = shortName.substring(shortName.lastIndexOf( + File.separatorChar) + 1); + } + + int count = 1; + + while (shortNames.contains(shortName)) + { + if (shortName.endsWith("_" + (count - 1))) + { + shortName = shortName.substring(0, + shortName.lastIndexOf("_")); + } + + shortName = shortName.concat("_" + count); + count++; + } + + shortNames.addElement(shortName); + + if (!shortName.endsWith(".xml")) + { + shortName = shortName + ".xml"; + } + + SaveState(af, creation, shortName, jout, out); + } } - shortNames.addElement(shortName); - if(!shortName.endsWith(".xml")) - shortName = shortName+".xml"; + out.close(); + jout.close(); + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } + + // USE THIS METHOD TO SAVE A SINGLE ALIGNMENT WINDOW + public static void SaveAlignment(AlignFrame af, String jarFile, + String fileName) + { + try + { + FileOutputStream fos = new FileOutputStream(jarFile); + JarOutputStream jout = new JarOutputStream(fos); + + //NOTE UTF-8 MUST BE USED FOR WRITING UNICODE CHARS + //////////////////////////////////////////////////// + PrintWriter out = new PrintWriter(new OutputStreamWriter(jout, + "UTF-8")); + + SaveState(af, System.currentTimeMillis(), fileName, jout, out); + out.close(); + jout.close(); + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } + + /** + * DOCUMENT ME! + * + * @param af DOCUMENT ME! + * @param timeStamp DOCUMENT ME! + * @param fileName DOCUMENT ME! + * @param jout DOCUMENT ME! + * @param out DOCUMENT ME! + */ + public static void SaveState(AlignFrame af, long timeStamp, + String fileName, JarOutputStream jout, PrintWriter out) + { + Vector seqids = new Vector(); + Vector userColours = new Vector(); + + AlignViewport av = af.viewport; + + JalviewModel object = new JalviewModel(); + object.setVamsasModel(new jalview.binding.VamsasModel()); + + object.setCreationDate(new java.util.Date(timeStamp)); + object.setVersion(jalview.bin.Cache.getProperty("VERSION")); + + jalview.datamodel.AlignmentI jal = af.viewport.alignment; - jarFile = statefile.getParent()+File.separatorChar+shortName+".jar"; + SequenceSet vamsasSet = new SequenceSet(); + Sequence vamsasSeq; + JalviewModelSequence jms = new JalviewModelSequence(); + + vamsasSet.setGapChar(jal.getGapCharacter() + ""); + + JSeq jseq; + + //SAVE SEQUENCES + int id = 0; + + for (int i = 0; i < jal.getHeight(); i++) + { + seqids.add(jal.getSequenceAt(i)); + + vamsasSeq = new Sequence(); + vamsasSeq.setId(id + ""); + vamsasSeq.setName(jal.getSequenceAt(i).getName()); + vamsasSeq.setSequence(jal.getSequenceAt(i).getSequence()); + vamsasSeq.setDescription(jal.getSequenceAt(i).getDescription()); + + jseq = new JSeq(); + jseq.setStart(jal.getSequenceAt(i).getStart()); + jseq.setEnd(jal.getSequenceAt(i).getEnd()); + + jseq.setColour(jal.getSequenceAt(i).getColor().getRGB()); + + jseq.setId(id); + + if(jal.getSequenceAt(i).getDatasetSequence().getSequenceFeatures()!=null) + { + jalview.datamodel.SequenceFeature[] sf + = jal.getSequenceAt(i).getDatasetSequence().getSequenceFeatures(); + int index = 0; + while(index < sf.length) + { + Features features = new Features(); + + features.setBegin(sf[index].getBegin()); + features.setEnd(sf[index].getEnd()); + features.setDescription(sf[index].getDescription()); + features.setStatus(sf[index].getStatus()); + features.setType(sf[index].getType()); + features.setFeatureGroup(sf[index].getFeatureGroup()); + jseq.addFeatures(features); + index ++; + } + } - SaveState( af, creation, shortName, jarFile); - state.addFile(jarFile); + if(jal.getSequenceAt(i).getDatasetSequence().getPDBId()!=null) + { + Enumeration en = jal.getSequenceAt(i).getDatasetSequence().getPDBId().elements(); + while(en.hasMoreElements()) + { + Pdbids pdb = new Pdbids(); + jalview.datamodel.PDBEntry entry + = (jalview.datamodel.PDBEntry)en.nextElement(); + + pdb.setId(entry.getId()); + pdb.setType(entry.getType()); + + if(entry.getProperty()!=null) + { + PdbentryItem item = new PdbentryItem(); + Hashtable properties = entry.getProperty(); + Enumeration en2 = properties.keys(); + while(en2.hasMoreElements()) + { + Property prop = new Property(); + String key = en2.nextElement().toString(); + prop.setName(key); + prop.setValue( properties.get(key).toString() ); + item.addProperty(prop); + } + pdb.addPdbentryItem(item); + } + + jseq.addPdbids(pdb); + } + } + + jms.addJSeq(jseq); + vamsasSet.addSequence(vamsasSeq); + id++; + } + + //SAVE TREES + /////////////////////////////////// + if (af.viewport.currentTree != null) + { + // FIND ANY ASSOCIATED TREES + // NOT IMPLEMENTED FOR HEADLESS STATE AT PRESENT + if (Desktop.desktop != null) + { + JInternalFrame[] frames = Desktop.desktop.getAllFrames(); + + for (int t = 0; t < frames.length; t++) + { + if (frames[t] instanceof TreePanel) + { + TreePanel tp = (TreePanel) frames[t]; + + if (tp.treeCanvas.av.alignment == jal) + { + Tree tree = new Tree(); + tree.setTitle(tp.getTitle()); + tree.setCurrentTree( (af.viewport.currentTree == tp.getTree())); + tree.setNewick(tp.getTree().toString()); + tree.setThreshold(tp.treeCanvas.threshold); + + tree.setFitToWindow(tp.fitToWindow.getState()); + tree.setFontName(tp.getTreeFont().getName()); + tree.setFontSize(tp.getTreeFont().getSize()); + tree.setFontStyle(tp.getTreeFont().getStyle()); + tree.setMarkUnlinked(tp.placeholdersMenu.getState()); + + tree.setShowBootstrap(tp.bootstrapMenu.getState()); + tree.setShowDistances(tp.distanceMenu.getState()); + + tree.setHeight(tp.getHeight()); + tree.setWidth(tp.getWidth()); + tree.setXpos(tp.getX()); + tree.setYpos(tp.getY()); + + jms.addTree(tree); + } + } + } } } - PrintWriter out = new PrintWriter(new FileWriter(statefile)); - state.marshal(out); - out.close(); - } - catch(Exception ex){ex.printStackTrace();} - } + //SAVE ANNOTATIONS + if (jal.getAlignmentAnnotation() != null) + { + jalview.datamodel.AlignmentAnnotation[] aa = jal.getAlignmentAnnotation(); + for (int i = 0; i < aa.length; i++) + { + if (aa[i].label.equals("Quality") || + aa[i].label.equals("Conservation") || + aa[i].label.equals("Consensus")) + { + continue; + } + + Annotation an = new Annotation(); + an.setDescription(aa[i].description); + if(aa[i].graph>0) + { + an.setGraph(true); + an.setGraphType(aa[i].graph); + } + an.setLabel(aa[i].label); + + AnnotationElement ae; + + for (int a = 0; a < aa[i].annotations.length; a++) + { + if ((aa[i] == null) || (aa[i].annotations[a] == null)) + { + continue; + } + + ae = new AnnotationElement(); + ae.setDescription(aa[i].annotations[a].description); + ae.setDisplayCharacter(aa[i].annotations[a].displayCharacter); + ae.setValue(aa[i].annotations[a].value); + ae.setPosition(a); + ae.setSecondaryStructure(aa[i].annotations[a].secondaryStructure + + ""); + an.addAnnotationElement(ae); + } + + vamsasSet.addAnnotation(an); + } + } - public static void SaveState( AlignFrame af, long timeStamp, String fileName, String jarFile) - { + //SAVE GROUPS + if (jal.getGroups() != null) + { + JGroup[] groups = new JGroup[jal.getGroups().size()]; - Vector seqids = new Vector(); + for (int i = 0; i < groups.length; i++) + { + groups[i] = new JGroup(); + + jalview.datamodel.SequenceGroup sg = (jalview.datamodel.SequenceGroup) jal.getGroups() + .elementAt(i); + groups[i].setStart(sg.getStartRes()); + groups[i].setEnd(sg.getEndRes()); + groups[i].setName(sg.getName()); + if(sg.cs!=null) + { + if (sg.cs.conservationApplied()) + { + groups[i].setConsThreshold(sg.cs.getConservationInc()); + + if (sg.cs instanceof jalview.schemes.UserColourScheme) + { + groups[i].setColour(SetUserColourScheme(sg.cs, + userColours, + jms)); + } + else + { + groups[i].setColour(ColourSchemeProperty.getColourName(sg. + cs)); + } + } + else if (sg.cs instanceof jalview.schemes.UserColourScheme) + { + groups[i].setColour(SetUserColourScheme(sg.cs, userColours, + jms)); + } + else + { + groups[i].setColour(ColourSchemeProperty.getColourName( + sg.cs)); + } + + groups[i].setPidThreshold(sg.cs.getThreshold()); + } + + groups[i].setOutlineColour(sg.getOutlineColour().getRGB()); + groups[i].setDisplayBoxes(sg.getDisplayBoxes()); + groups[i].setDisplayText(sg.getDisplayText()); + groups[i].setColourText(sg.getColourText()); + + for (int s = 0; s < sg.getSize(); s++) + { + jalview.datamodel.Sequence seq = (jalview.datamodel.Sequence) sg.getSequenceAt(s); + int index = seqids.indexOf(seq); + groups[i].addSeq(index); + } + } - AlignViewport av = af.viewport; + jms.setJGroup(groups); + } - JalviewModel object = new JalviewModel(); - object.setVamsasModel( new VamsasModel() ); - object.setCreationDate( new java.util.Date(timeStamp) ); + ///////////SAVE VIEWPORT + Viewport view = new Viewport(); + view.setTitle(af.getTitle()); + view.setXpos(af.getX()); + view.setYpos(af.getY()); + view.setWidth(af.getWidth()); + view.setHeight(af.getHeight()); + view.setStartRes(av.startRes); + view.setStartSeq(av.startSeq); - jalview.datamodel.AlignmentI jal = af.viewport.alignment; + if (av.getGlobalColourScheme() instanceof jalview.schemes.UserColourScheme) + { + view.setBgColour(SetUserColourScheme(av.getGlobalColourScheme(), + userColours, jms)); + } + else + { + view.setBgColour(ColourSchemeProperty.getColourName( + av.getGlobalColourScheme())); + } - SequenceSet vamsasSet = new SequenceSet(); - Sequence vamsasSeq; - JalviewModelSequence jms = new JalviewModelSequence(); + ColourSchemeI cs = av.getGlobalColourScheme(); - vamsasSet.setGapChar(jal.getGapCharacter()+""); + if(cs!=null) + { + if (cs.conservationApplied()) + { + view.setConsThreshold(cs.getConservationInc()); + if (cs instanceof jalview.schemes.UserColourScheme) + view.setBgColour(SetUserColourScheme(cs, userColours, jms)); + } - JSeq jseq; + if (cs instanceof ResidueColourScheme) + { + view.setPidThreshold(cs.getThreshold()); + } + } + + view.setConservationSelected(av.getConservationSelected()); + view.setPidSelected(av.getAbovePIDThreshold()); + view.setFontName(av.font.getName()); + view.setFontSize(av.font.getSize()); + view.setFontStyle(av.font.getStyle()); + view.setRenderGaps(av.renderGaps); + view.setShowAnnotation(av.getShowAnnotation()); + view.setShowBoxes(av.getShowBoxes()); + view.setShowColourText(av.getColourText()); + view.setShowConservation(av.showConservation); + view.setShowFullId(av.getShowJVSuffix()); + view.setShowIdentity(av.showIdentity); + view.setShowQuality(av.showQuality); + view.setShowSequenceFeatures(av.showSequenceFeatures); + view.setShowText(av.getShowText()); + view.setWrapAlignment(av.getWrapAlignment()); + + if(av.featuresDisplayed!=null) + { + jalview.binding.FeatureSettings fs = new jalview.binding.FeatureSettings(); + + Enumeration e = af.alignPanel.seqPanel.seqCanvas.getFeatureRenderer().featureColours.keys(); + while (e.hasMoreElements()) + { + String type = e.nextElement().toString(); + Setting setting = new Setting(); + setting.setType(type); + setting.setColour( + af.alignPanel.seqPanel.seqCanvas.getFeatureRenderer().getColour(type).getRGB() + ); + setting.setDisplay( + av.featuresDisplayed.contains(type) + ); + + fs.addSetting(setting); + + } + jms.setFeatureSettings(fs); + + } + + jms.addViewport(view); - //SAVE SEQUENCES - int id = 0; - for(int i=0; i 0) + { + Features[] features = JSEQ[i].getFeatures(); + for (int f = 0; f < features.length; f++) + { + //features[f].getBegin() + jalview.datamodel.SequenceFeature sf + = new jalview.datamodel.SequenceFeature(features[f].getType(), + features[f].getDescription(), features[f].getStatus(), + features[f].getBegin(), features[f].getEnd()); + sf.setFeatureGroup(features[f].getFeatureGroup()); + al.getSequenceAt(i).getDatasetSequence().addSequenceFeature(sf); + } + } + if (JSEQ[i].getPdbidsCount() > 0) + { + Pdbids[] ids = JSEQ[i].getPdbids(); + for (int p = 0; p < ids.length; p++) + { + jalview.datamodel.PDBEntry entry = new jalview.datamodel.PDBEntry(); + entry.setId(ids[p].getId()); + entry.setType(ids[p].getType()); + al.getSequenceAt(i).getDatasetSequence().addPDBId(entry); + } - for(int s=0; s 0) + { + JGroup[] groups = jms.getJGroup(); - //PUT IT IN THIS JARFILE - JarOutputStream jout = new JarOutputStream(fos); + for (int i = 0; i < groups.length; i++) + { + ColourSchemeI cs = null; + + if (groups[i].getColour() != null) + { + if (groups[i].getColour().startsWith("ucs")) + { + cs = GetUserColourScheme(jms, groups[i].getColour()); + } + else + { + cs = ColourSchemeProperty.getColour(al, + groups[i].getColour()); + } + + cs.setThreshold(groups[i].getPidThreshold(), true); + } + + Vector seqs = new Vector(); + int[] ids = groups[i].getSeq(); + + for (int s = 0; s < ids.length; s++) + { + seqs.addElement((jalview.datamodel.SequenceI) seqids.elementAt( + ids[s])); + } + + jalview.datamodel.SequenceGroup sg = new jalview.datamodel.SequenceGroup(seqs, + groups[i].getName(), cs, groups[i].getDisplayBoxes(), + groups[i].getDisplayText(), groups[i].getColourText(), + groups[i].getStart(), groups[i].getEnd()); + + sg.setOutlineColour(new java.awt.Color( + groups[i].getOutlineColour())); + + if (groups[i].getConsThreshold() != 0) + { + jalview.analysis.Conservation c = new jalview.analysis.Conservation("All", + ResidueProperties.propHash, 3, sg.sequences, 0, + sg.getWidth() - 1); + c.calculate(); + c.verdict(false, 25); + sg.cs.setConservation(c); + } + + al.addGroup(sg); + } + } - //NOTE UTF-8 MUST BE USED FOR WRITING UNICODE CHARS - //////////////////////////////////////////////////// - PrintWriter out = new PrintWriter(new OutputStreamWriter(jout, "UTF-8")); - if(!fileName.endsWith(".xml")) - fileName = fileName+".xml"; + af.setBounds(view.getXpos(), view.getYpos(), view.getWidth(), + view.getHeight()); + af.viewport.setStartRes(view.getStartRes()); + af.viewport.setStartSeq(view.getStartSeq()); + af.viewport.setShowAnnotation(view.getShowAnnotation()); + af.viewport.showConservation = view.getShowConservation(); + af.viewport.showQuality = view.getShowQuality(); + af.viewport.showIdentity = view.getShowIdentity(); + af.viewport.setAbovePIDThreshold(view.getPidSelected()); + af.abovePIDThreshold.setSelected(view.getPidSelected()); + af.viewport.setColourText(view.getShowColourText()); + af.colourTextMenuItem.setSelected(view.getShowColourText()); + af.viewport.setConservationSelected(view.getConservationSelected()); + af.conservationMenuItem.setSelected(view.getConservationSelected()); - JarEntry entry = new JarEntry(fileName); - jout.putNextEntry(entry); + af.viewport.setShowJVSuffix(view.getShowFullId()); + af.seqLimits.setSelected(view.getShowFullId()); - object.marshal(out); - out.close(); - fos.close(); - jout.close(); - } - catch (Exception ex) - { - ex.printStackTrace(); - } - } - - public static void LoadState(String file) - { - try{ - JalviewState state = new JalviewState(); - BufferedReader in = new BufferedReader(new FileReader(file)); - state = (JalviewState)state.unmarshal(in); - Enumeration en = state.enumerateFile(); - while( en.hasMoreElements() ) - { - LoadJalviewAlign( en.nextElement().toString()); - } - } - catch(Exception ex) - { ex.printStackTrace(); return; } - } - - public static void LoadJalviewAlign(String file) - { - JalviewModel object = new JalviewModel(); - Vector seqids = new Vector(); - try{ - FileInputStream fis = new FileInputStream(file); - JarInputStream jin = new JarInputStream(fis); - jin.getNextJarEntry(); - InputStreamReader in = new InputStreamReader(jin, "UTF-8"); - object = (JalviewModel) object.unmarshal(in); - } - catch(Exception ex) - { System.out.println(ex); return; } - - - SequenceSet vamsasSet = object.getVamsasModel().getSequenceSet(0); - Sequence [] vamsasSeq = vamsasSet.getSequence(); - - JalviewModelSequence jms = object.getJalviewModelSequence(); - ////////////////////////////////// - //LOAD SEQUENCES - jalview.datamodel.Sequence [] jseqs = new jalview.datamodel.Sequence[vamsasSeq.length]; - JSeq [] JSEQ = object.getJalviewModelSequence().getJSeq(); - for(int i=0; i0) - { - JGroup[] groups = jms.getJGroup(); - for (int i = 0; i < groups.length; i++) - { - ColourSchemeI cs = ColourSchemeProperty.getColour(al, groups[i].getColour() ); - if (cs instanceof ResidueColourScheme) - ( (ResidueColourScheme) cs).setThreshold(groups[i].getPidThreshold()); - else if (cs instanceof ScoreColourScheme) - ( (ScoreColourScheme) cs).setThreshold(groups[i].getPidThreshold()); - - jalview.datamodel.SequenceGroup sg = new jalview.datamodel.SequenceGroup - (groups[i].getName(), - cs, - groups[i].getDisplayBoxes(), - groups[i].getDisplayText(), - groups[i].getColourText(), - groups[i].getStart(), - groups[i].getEnd()) ; - sg.setOutlineColour( new java.awt.Color(groups[i].getOutlineColour())); - int [] ids = groups[i].getSeq(); - for(int s=0; s0) - { - try{ - af.ShowNewickTree(new jalview.io.NewickFile( - (String)object.getVamsasModel().getTree(0)), "Tree"); - }catch(Exception ex){ex.printStackTrace();} + if (view.getShowSequenceFeatures()) + { + af.viewport.showSequenceFeatures = true; + af.showSeqFeatures.setSelected(true); + } - } + if(jms.getFeatureSettings()!=null) + { + af.viewport.featuresDisplayed = new Hashtable(); + // af.alignPanel.seqPanel.seqCanvas.getFeatureRenderer().featuresDisplayed!=null) + // jalview.binding.FeatureSettings fs = new jalview.binding.FeatureSettings(); + for(int fs=0; fs 0) + { + try + { + for (int t = 0; t < jms.getTreeCount(); t++) + { + + Tree tree = jms.getTree(t); + + TreePanel tp = af.ShowNewickTree(new jalview.io.NewickFile( + tree.getNewick()), tree.getTitle(), + tree.getWidth(), tree.getHeight(), + tree.getXpos(), tree.getYpos()); + tp.fitToWindow.setState(tree.getFitToWindow()); + tp.fitToWindow_actionPerformed(null); + if(tree.getFontName()!=null) + tp.setTreeFont(new java.awt.Font(tree.getFontName(), + tree.getFontStyle(), + tree.getFontSize())); + else + tp.setTreeFont(new java.awt.Font(view.getFontName(), + view.getFontStyle(), + tree.getFontSize())); + + tp.showPlaceholders(tree.getMarkUnlinked()); + tp.showBootstrap(tree.getShowBootstrap()); + tp.showDistances(tree.getShowDistances()); + + tp.treeCanvas.threshold = tree.getThreshold(); + + if (tree.getCurrentTree()) + af.viewport.setCurrentTree(tp.getTree()); + } + + } + catch (Exception ex) + { + ex.printStackTrace(); + } + + } + return af; + } +}