LSST Applications  21.0.0+04719a4bac,21.0.0-1-ga51b5d4+f5e6047307,21.0.0-11-g2b59f77+a9c1acf22d,21.0.0-11-ga42c5b2+86977b0b17,21.0.0-12-gf4ce030+76814010d2,21.0.0-13-g1721dae+760e7a6536,21.0.0-13-g3a573fe+768d78a30a,21.0.0-15-g5a7caf0+f21cbc5713,21.0.0-16-g0fb55c1+b60e2d390c,21.0.0-19-g4cded4ca+71a93a33c0,21.0.0-2-g103fe59+bb20972958,21.0.0-2-g45278ab+04719a4bac,21.0.0-2-g5242d73+3ad5d60fb1,21.0.0-2-g7f82c8f+8babb168e8,21.0.0-2-g8f08a60+06509c8b61,21.0.0-2-g8faa9b5+616205b9df,21.0.0-2-ga326454+8babb168e8,21.0.0-2-gde069b7+5e4aea9c2f,21.0.0-2-gecfae73+1d3a86e577,21.0.0-2-gfc62afb+3ad5d60fb1,21.0.0-25-g1d57be3cd+e73869a214,21.0.0-3-g357aad2+ed88757d29,21.0.0-3-g4a4ce7f+3ad5d60fb1,21.0.0-3-g4be5c26+3ad5d60fb1,21.0.0-3-g65f322c+e0b24896a3,21.0.0-3-g7d9da8d+616205b9df,21.0.0-3-ge02ed75+a9c1acf22d,21.0.0-4-g591bb35+a9c1acf22d,21.0.0-4-g65b4814+b60e2d390c,21.0.0-4-gccdca77+0de219a2bc,21.0.0-4-ge8a399c+6c55c39e83,21.0.0-5-gd00fb1e+05fce91b99,21.0.0-6-gc675373+3ad5d60fb1,21.0.0-64-g1122c245+4fb2b8f86e,21.0.0-7-g04766d7+cd19d05db2,21.0.0-7-gdf92d54+04719a4bac,21.0.0-8-g5674e7b+d1bd76f71f,master-gac4afde19b+a9c1acf22d,w.2021.13
LSST Data Management Base Package
butlerFactory.py
Go to the documentation of this file.
1 #!/usr/bin/env python
2 
3 #
4 # LSST Data Management System
5 # Copyright 2008, 2009, 2010 LSST Corporation.
6 #
7 # This product includes software developed by the
8 # LSST Project (http://www.lsst.org/).
9 #
10 # This program is free software: you can redistribute it and/or modify
11 # it under the terms of the GNU General Public License as published by
12 # the Free Software Foundation, either version 3 of the License, or
13 # (at your option) any later version.
14 #
15 # This program is distributed in the hope that it will be useful,
16 # but WITHOUT ANY WARRANTY; without even the implied warranty of
17 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 # GNU General Public License for more details.
19 #
20 # You should have received a copy of the LSST License Statement and
21 # the GNU General Public License along with this program. If not,
22 # see <http://www.lsstcorp.org/LegalNotices/>.
23 #
24 
25 # -*- python -*-
26 
27 """This module defines the ButlerFactory class."""
28 
29 from lsst.daf.persistence import Butler
30 
31 
33  """ButlerFactory creates data Butlers containing data mappers. Use of it
34  is deprecated in favor of the direct Butler constructor.
35 
36  The ButlerFactory class takes a mapper for a data collection.
37  It can then create Butlers with these mappers.
38 
39  A data identifier is a dictionary. The keys match those understood by a
40  mapper; the values select particular data sets or collections of data
41  sets. For example, one key might be "visit". Specifying a value of
42  "695934" for this key might select a collection of images.
43 
44  The mappers perform four functions:
45  1. Determine what keys are valid for dataset ids.
46  2. Obtain a collection of potential dataset ids matching a
47  partial dataset id.
48  3. Map a dataset id to the location of the dataset, including its
49  C++ and Python types.
50  4. Manipulate a retrieved dataset object so that it conforms to a
51  standard.
52 
53  Public methods:
54 
55  __init__(self, mapper)
56 
57  create(self)
58  """
59 
60  def __init__(self, mapper):
61  """Construct a ButlerFactory.
62 
63  @param mapper mapper object.
64  """
65 
66  self.mappermapper = mapper
67 
68  def create(self):
69  """Create a Butler.
70 
71  @returns a new Butler.
72  """
73 
74  if hasattr(self.mappermapper, 'root'):
75  root = self.mappermapper.root
76  else:
77  root = None
78  return Butler(root=root, mapper=self.mappermapper)