LSSTApplications  18.1.0
LSSTDataManagementBasePackage
transformFromString.py
Go to the documentation of this file.
1 #
2 # LSST Data Management System
3 # Copyright 2017 LSST/AURA.
4 #
5 # This product includes software developed by the
6 # LSST Project (http://www.lsst.org/).
7 #
8 # This program is free software: you can redistribute it and/or modify
9 # it under the terms of the GNU General Public License as published by
10 # the Free Software Foundation, either version 3 of the License, or
11 # (at your option) any later version.
12 #
13 # This program is distributed in the hope that it will be useful,
14 # but WITHOUT ANY WARRANTY; without even the implied warranty of
15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 # GNU General Public License for more details.
17 #
18 # You should have received a copy of the LSST License Statement and
19 # the GNU General Public License along with this program. If not,
20 # see <http://www.lsstcorp.org/LegalNotices/>.
21 #
22 
23 from .python import transformRegistry
24 
25 __all__ = ["transformFromString"]
26 
27 
29  """Read a Transform from a string that was saved using
30  ``Transform.writeString``
31 
32  Unlike ``Transform.readString``, you need not know the ``Transform`` class in
33  advance
34 
35  Parameters
36  ----------
37  data : `str`
38  A string in the format produced by ``Transform.writeString``.
39 
40  Returns
41  -------
42  transform : a ``Transform`` class
43  An object of the same type used to create ``data``.
44  """
45  version, transformClassName, remainder = data.split(" ", 2)
46  try:
47  transformClass = transformRegistry[transformClassName]
48  except LookupError:
49  raise RuntimeError("Unknown transform class %r" % (transformClassName,))
50 
51  return transformClass.readString(data)