1 package uk.ac.vamsas.objects.utils;
\r
3 import java.util.Vector;
\r
5 import uk.ac.vamsas.objects.core.Local;
\r
6 import uk.ac.vamsas.objects.core.MapType;
\r
7 import uk.ac.vamsas.objects.core.Mapped;
\r
8 import uk.ac.vamsas.objects.core.RangeType;
\r
9 import uk.ac.vamsas.objects.core.Seg;
\r
12 * Utilities for working with RangeType and MapType objects.
\r
13 * Derived from bitter experience.
\r
17 public class Range {
\r
20 * get start<end range of segment, adjusting for inclusivity flag and
\r
24 * @param ensureDirection when true - always ensure start is less than end.
\r
25 * @return int[] { start, end, direction} where direction==1 for range running from end to start.
\r
27 public static int[] getSegRange(Seg visSeg, boolean ensureDirection)
\r
29 boolean incl = visSeg.getInclusive();
\r
30 // adjust for inclusive flag.
\r
31 int pol = (visSeg.getStart() <= visSeg.getEnd()) ? 1 : -1; // polarity of
\r
33 int start = visSeg.getStart() + (incl ? 0 : pol);
\r
34 int end = visSeg.getEnd() + (incl ? 0 : -pol);
\r
35 if (ensureDirection && pol == -1)
\r
37 // jalview doesn't deal with inverted ranges, yet.
\r
44 start, end, pol < 0 ? 1 : 0};
\r
48 * get real bounds of a RangeType's specification. start and end are an
\r
49 * inclusive range within which all segments and positions lie.
\r
50 * TODO: refactor to vamsas utils
\r
52 * @return int[] { start, end}
\r
54 public static int[] getBounds(RangeType dseta)
\r
59 if (dseta.getSegCount() > 0 && dseta.getPosCount() > 0)
\r
61 throw new Error("Invalid vamsas RangeType - cannot resolve both lists of Pos and Seg from choice!");
\r
63 if (dseta.getSegCount() > 0)
\r
65 se = getSegRange(dseta.getSeg(0), true);
\r
66 for (int s = 1, sSize = dseta.getSegCount(); s < sSize; s++)
\r
68 int nse[] = getSegRange(dseta.getSeg(s), true);
\r
79 if (dseta.getPosCount() > 0)
\r
81 // could do a polarity for pos range too. and pass back indication of discontinuities.
\r
82 int pos = dseta.getPos(0).getI();
\r
86 for (int p = 0, pSize = dseta.getPosCount(); p < pSize; p++)
\r
88 pos = dseta.getPos(p).getI();
\r
105 * map from a rangeType's internal frame to the referenced object's coordinate frame.
\r
107 * @return int [] { ref(pos)...} for all pos in rangeType's frame.
\r
109 public static int[] getMapping(RangeType dseta)
\r
111 Vector posList = new Vector();
\r
115 if (dseta.getSegCount() > 0 && dseta.getPosCount() > 0)
\r
117 throw new Error("Invalid vamsas RangeType - cannot resolve both lists of Pos and Seg from choice!");
\r
119 if (dseta.getSegCount() > 0)
\r
121 for (int s = 0, sSize = dseta.getSegCount(); s < sSize; s++)
\r
123 se = getSegRange(dseta.getSeg(s), false);
\r
124 int se_end = se[1 - se[2]] + (se[2] == 0 ? 1 : -1);
\r
125 for (int p = se[se[2]]; p != se_end; p += se[2] == 0 ? 1 : -1)
\r
127 posList.add(new Integer(p));
\r
131 else if (dseta.getPosCount() > 0)
\r
133 int pos = dseta.getPos(0).getI();
\r
135 for (int p = 0, pSize = dseta.getPosCount(); p < pSize; p++)
\r
137 pos = dseta.getPos(p).getI();
\r
138 posList.add(new Integer(pos));
\r
142 if (posList != null && posList.size() > 0)
\r
144 int[] range = new int[posList.size()];
\r
145 for (int i = 0; i < range.length; i++)
\r
147 range[i] = ( (Integer) posList.elementAt(i)).intValue();
\r
155 public static int[] getIntervals(RangeType range)
\r
157 int[] intervals=null;
\r
158 Vector posList = new Vector();
\r
162 if (range.getSegCount() > 0 && range.getPosCount() > 0)
\r
164 throw new Error("Invalid vamsas RangeType - cannot resolve both lists of Pos and Seg from choice!");
\r
166 if (range.getSegCount() > 0)
\r
168 for (int s = 0, sSize = range.getSegCount(); s < sSize; s++)
\r
170 se = getSegRange(range.getSeg(s), false);
\r
171 posList.addElement(new Integer(se[0]));
\r
172 posList.addElement(new Integer(se[1]));
\r
175 else if (range.getPosCount() > 0)
\r
177 int pos = range.getPos(0).getI();
\r
178 for (int p = 0, pSize = range.getPosCount(); p < pSize; p++)
\r
180 pos = range.getPos(p).getI();
\r
181 posList.add(new Integer(pos));
\r
182 posList.add(new Integer(pos));
\r
186 if (posList != null && posList.size() > 0)
\r
188 intervals=new int[posList.size()];
\r
189 java.util.Enumeration e = posList.elements();
\r
191 while (e.hasMoreElements())
\r
193 intervals[i++] = ((Integer)e.nextElement()).intValue();
\r
199 * initialise a range type object from a set of start/end inclusive intervals
\r
203 public static void initRangeType(RangeType mrt, int[] range)
\r
205 for (int i=0; i<range.length; i+=2)
\r
207 Seg vSeg = new Seg();
\r
208 vSeg.setStart(range[i]);
\r
209 vSeg.setEnd(range[i+1]);
\r
210 vSeg.setInclusive(true);
\r
217 * @param maprange where the from range is the local mapped range, and the to range is the 'mapped' range in the MapRangeType
\r
218 * @param default unit for local
\r
219 * @param default unit for mapped
\r
222 public static MapList parsemapType(MapType maprange, int localu, int mappedu)
\r
225 int[] localRange = getIntervals(maprange.getLocal());
\r
226 int[] mappedRange = getIntervals(maprange.getMapped());
\r
227 long lu = maprange.getLocal().hasUnit() ? maprange.getLocal().getUnit() : localu;
\r
228 long mu = maprange.getMapped().hasUnit() ? maprange.getMapped().getUnit() : mappedu;
\r
229 ml = new MapList(localRange, mappedRange, (int)lu, (int)mu);
\r
233 * Parse map with default units of 1,1
\r
235 * @return MapList representing map
\r
237 public static MapList parsemapType(MapType map)
\r
239 return parsemapType(map, 1, 1);
\r
243 * initialise a MapType object from a MapList object.
\r
248 public static void initMapType(MapType maprange, MapList ml, boolean setUnits)
\r
250 initMapType(maprange, ml, setUnits, false);
\r
257 * @param reverse - reverse MapList mapping for Local and Mapped ranges and units
\r
259 public static void initMapType(MapType maprange, MapList ml, boolean setUnits, boolean reverse)
\r
261 maprange.setLocal(new Local());
\r
262 maprange.setMapped(new Mapped());
\r
265 initRangeType(maprange.getLocal(), ml.getFromRanges());
\r
266 initRangeType(maprange.getMapped(), ml.getToRanges());
\r
268 initRangeType(maprange.getLocal(), ml.getToRanges());
\r
269 initRangeType(maprange.getMapped(), ml.getFromRanges());
\r
275 maprange.getLocal().setUnit(ml.getFromRatio());
\r
276 maprange.getMapped().setUnit(ml.getToRatio());
\r
278 maprange.getLocal().setUnit(ml.getToRatio());
\r
279 maprange.getMapped().setUnit(ml.getFromRatio());
\r