LArSoft  v07_13_02
Liquid Argon Software toolkit - http://larsoft.org/
cosmic::BeamFlashTrackMatchTagger Class Reference
Inheritance diagram for cosmic::BeamFlashTrackMatchTagger:
art::EDProducer art::ProducerBase art::Consumer art::EngineCreator art::ProductRegistryHelper

Public Types

using ModuleType = EDProducer
 
using WorkerType = WorkerT< EDProducer >
 
template<typename UserConfig , typename KeysToIgnore = void>
using Table = ProducerBase::Table< UserConfig, KeysToIgnore >
 

Public Member Functions

 BeamFlashTrackMatchTagger (fhicl::ParameterSet const &p)
 
 BeamFlashTrackMatchTagger (BeamFlashTrackMatchTagger const &)=delete
 
 BeamFlashTrackMatchTagger (BeamFlashTrackMatchTagger &&)=delete
 
BeamFlashTrackMatchTaggeroperator= (BeamFlashTrackMatchTagger const &)=delete
 
BeamFlashTrackMatchTaggeroperator= (BeamFlashTrackMatchTagger &&)=delete
 
void reconfigure (fhicl::ParameterSet const &p)
 
void produce (art::Event &e) override
 
template<typename PROD , BranchType B = InEvent>
ProductID getProductID (std::string const &instanceName={}) const
 
template<typename PROD , BranchType B>
ProductID getProductID (ModuleDescription const &moduleDescription, std::string const &instanceName) const
 
bool modifiesEvent () const
 
template<typename T , BranchType = InEvent>
ProductToken< T > consumes (InputTag const &)
 
template<typename T , art::BranchType BT>
art::ProductToken< T > consumes (InputTag const &it)
 
template<typename T , BranchType = InEvent>
void consumesMany ()
 
template<typename Element , BranchType = InEvent>
ViewToken< Element > consumesView (InputTag const &)
 
template<typename T , art::BranchType BT>
art::ViewToken< T > consumesView (InputTag const &it)
 
template<typename T , BranchType = InEvent>
ProductToken< T > mayConsume (InputTag const &)
 
template<typename T , art::BranchType BT>
art::ProductToken< T > mayConsume (InputTag const &it)
 
template<typename T , BranchType = InEvent>
void mayConsumeMany ()
 
template<typename Element , BranchType = InEvent>
ViewToken< Element > mayConsumeView (InputTag const &)
 
template<typename T , art::BranchType BT>
art::ViewToken< T > mayConsumeView (InputTag const &it)
 
base_engine_tcreateEngine (seed_t seed)
 
base_engine_tcreateEngine (seed_t seed, std::string const &kind_of_engine_to_make)
 
base_engine_tcreateEngine (seed_t seed, std::string const &kind_of_engine_to_make, label_t const &engine_label)
 
seed_t get_seed_value (fhicl::ParameterSet const &pset, char const key[]="seed", seed_t const implicit_seed=-1)
 

Static Public Member Functions

static cet::exempt_ptr< Consumernon_module_context ()
 

Protected Member Functions

CurrentProcessingContext const * currentContext () const
 
void validateConsumedProduct (BranchType const bt, ProductInfo const &pi)
 
void prepareForJob (fhicl::ParameterSet const &pset)
 
void showMissingConsumes () const
 

Private Attributes

BeamFlashTrackMatchTaggerAlg fAlg
 
std::string fTrackModuleLabel
 
std::string fFlashModuleLabel
 
HitTagAssociatorAlg fHitTagAssnsAlg
 
bool fMakeHitTagAssns
 
std::string fHitModuleLabel
 

Detailed Description

Definition at line 41 of file BeamFlashTrackMatchTagger_module.cc.

Member Typedef Documentation

using art::EDProducer::ModuleType = EDProducer
inherited

Definition at line 34 of file EDProducer.h.

template<typename UserConfig , typename KeysToIgnore = void>
using art::EDProducer::Table = ProducerBase::Table<UserConfig, KeysToIgnore>
inherited

Definition at line 43 of file EDProducer.h.

using art::EDProducer::WorkerType = WorkerT<EDProducer>
inherited

Definition at line 35 of file EDProducer.h.

Constructor & Destructor Documentation

cosmic::BeamFlashTrackMatchTagger::BeamFlashTrackMatchTagger ( fhicl::ParameterSet const &  p)
explicit

Definition at line 70 of file BeamFlashTrackMatchTagger_module.cc.

References fMakeHitTagAssns.

71  : fAlg(p.get<fhicl::ParameterSet>("BeamFlashTrackMatchAlgParams")),
72  fTrackModuleLabel(p.get<std::string>("TrackModuleLabel")),
73  fFlashModuleLabel(p.get<std::string>("FlashModuleLabel")),
74  fHitTagAssnsAlg(p.get<fhicl::ParameterSet>("HitTagAssociatorAlgParams")),
75  fMakeHitTagAssns(p.get<bool>("MakeHitTagAssns",false)),
76  fHitModuleLabel(p.get<std::string>("HitModuleLabel","dummy_hit"))
77 {
78  produces< std::vector<anab::CosmicTag> >();
79  produces< art::Assns<recob::Track, anab::CosmicTag> >();
80  if(fMakeHitTagAssns) produces< art::Assns<recob::Hit, anab::CosmicTag> >();
81 }
cosmic::BeamFlashTrackMatchTagger::BeamFlashTrackMatchTagger ( BeamFlashTrackMatchTagger const &  )
delete
cosmic::BeamFlashTrackMatchTagger::BeamFlashTrackMatchTagger ( BeamFlashTrackMatchTagger &&  )
delete

Member Function Documentation

template<typename T , BranchType = InEvent>
ProductToken<T> art::Consumer::consumes ( InputTag const &  )
inherited
template<typename T , art::BranchType BT>
art::ProductToken<T> art::Consumer::consumes ( InputTag const &  it)
inherited

Definition at line 147 of file Consumer.h.

References art::InputTag::instance(), art::InputTag::label(), and art::InputTag::process().

148 {
149  if (!moduleContext_)
150  return ProductToken<T>::invalid();
151 
152  consumables_[BT].emplace_back(ConsumableType::Product,
153  TypeID{typeid(T)},
154  it.label(),
155  it.instance(),
156  it.process());
157  return ProductToken<T>{it};
158 }
static ProductToken< T > invalid()
Definition: ProductToken.h:47
ConsumableProducts consumables_
Definition: Consumer.h:138
bool moduleContext_
Definition: Consumer.h:136
template<typename T , art::BranchType BT>
void art::Consumer::consumesMany ( )
inherited

Definition at line 162 of file Consumer.h.

163 {
164  if (!moduleContext_)
165  return;
166 
167  consumables_[BT].emplace_back(ConsumableType::Many, TypeID{typeid(T)});
168 }
ConsumableProducts consumables_
Definition: Consumer.h:138
bool moduleContext_
Definition: Consumer.h:136
template<typename Element , BranchType = InEvent>
ViewToken<Element> art::Consumer::consumesView ( InputTag const &  )
inherited
template<typename T , art::BranchType BT>
art::ViewToken<T> art::Consumer::consumesView ( InputTag const &  it)
inherited

Definition at line 172 of file Consumer.h.

References art::InputTag::instance(), art::InputTag::label(), and art::InputTag::process().

173 {
174  if (!moduleContext_)
175  return ViewToken<T>::invalid();
176 
177  consumables_[BT].emplace_back(ConsumableType::ViewElement,
178  TypeID{typeid(T)},
179  it.label(),
180  it.instance(),
181  it.process());
182  return ViewToken<T>{it};
183 }
static ViewToken< Element > invalid()
Definition: ProductToken.h:75
ConsumableProducts consumables_
Definition: Consumer.h:138
bool moduleContext_
Definition: Consumer.h:136
EngineCreator::base_engine_t & EngineCreator::createEngine ( seed_t  seed,
std::string const &  kind_of_engine_to_make 
)
inherited

Definition at line 32 of file EngineCreator.cc.

References art::EngineCreator::rng().

34 {
35  return rng()->createEngine(
36  placeholder_schedule_id(), seed, kind_of_engine_to_make);
37 }
long seed
Definition: chem4.cc:68
static art::ServiceHandle< art::RandomNumberGenerator > & rng()
EngineCreator::base_engine_t & EngineCreator::createEngine ( seed_t  seed,
std::string const &  kind_of_engine_to_make,
label_t const &  engine_label 
)
inherited

Definition at line 40 of file EngineCreator.cc.

References art::EngineCreator::rng().

43 {
44  return rng()->createEngine(
45  placeholder_schedule_id(), seed, kind_of_engine_to_make, engine_label);
46 }
long seed
Definition: chem4.cc:68
static art::ServiceHandle< art::RandomNumberGenerator > & rng()
CurrentProcessingContext const * art::EDProducer::currentContext ( ) const
protectedinherited

Definition at line 120 of file EDProducer.cc.

References art::EDProducer::current_context_.

121  {
122  return current_context_.get();
123  }
CPC_exempt_ptr current_context_
Definition: EDProducer.h:116
EngineCreator::seed_t EngineCreator::get_seed_value ( fhicl::ParameterSet const &  pset,
char const  key[] = "seed",
seed_t const  implicit_seed = -1 
)
inherited

Definition at line 49 of file EngineCreator.cc.

References fhicl::ParameterSet::get().

Referenced by art::MixFilter< T >::initEngine_().

52 {
53  auto const& explicit_seeds = pset.get<std::vector<int>>(key, {});
54  return explicit_seeds.empty() ? implicit_seed : explicit_seeds.front();
55 }
template<typename PROD , BranchType B>
ProductID art::EDProducer::getProductID ( std::string const &  instanceName = {}) const
inlineinherited

Definition at line 123 of file EDProducer.h.

References art::EDProducer::moduleDescription_.

124  {
125  return ProducerBase::getProductID<PROD, B>(moduleDescription_,
126  instanceName);
127  }
ModuleDescription moduleDescription_
Definition: EDProducer.h:115
template<typename PROD , BranchType B>
ProductID art::ProducerBase::getProductID ( ModuleDescription const &  moduleDescription,
std::string const &  instanceName 
) const
inherited

Definition at line 56 of file ProducerBase.h.

References B, and art::ModuleDescription::moduleLabel().

Referenced by art::ProducerBase::modifiesEvent().

58  {
59  auto const& pd =
60  get_ProductDescription<PROD>(B, md.moduleLabel(), instanceName);
61  return pd.productID();
62  }
Int_t B
Definition: plot.C:25
template<typename T , BranchType = InEvent>
ProductToken<T> art::Consumer::mayConsume ( InputTag const &  )
inherited
template<typename T , art::BranchType BT>
art::ProductToken<T> art::Consumer::mayConsume ( InputTag const &  it)
inherited

Definition at line 190 of file Consumer.h.

References art::InputTag::instance(), art::InputTag::label(), and art::InputTag::process().

191 {
192  if (!moduleContext_)
193  return ProductToken<T>::invalid();
194 
195  consumables_[BT].emplace_back(ConsumableType::Product,
196  TypeID{typeid(T)},
197  it.label(),
198  it.instance(),
199  it.process());
200  return ProductToken<T>{it};
201 }
static ProductToken< T > invalid()
Definition: ProductToken.h:47
ConsumableProducts consumables_
Definition: Consumer.h:138
bool moduleContext_
Definition: Consumer.h:136
template<typename T , art::BranchType BT>
void art::Consumer::mayConsumeMany ( )
inherited

Definition at line 205 of file Consumer.h.

206 {
207  if (!moduleContext_)
208  return;
209 
210  consumables_[BT].emplace_back(ConsumableType::Many, TypeID{typeid(T)});
211 }
ConsumableProducts consumables_
Definition: Consumer.h:138
bool moduleContext_
Definition: Consumer.h:136
template<typename Element , BranchType = InEvent>
ViewToken<Element> art::Consumer::mayConsumeView ( InputTag const &  )
inherited
template<typename T , art::BranchType BT>
art::ViewToken<T> art::Consumer::mayConsumeView ( InputTag const &  it)
inherited

Definition at line 215 of file Consumer.h.

References art::InputTag::instance(), art::InputTag::label(), and art::InputTag::process().

216 {
217  if (!moduleContext_)
218  return ViewToken<T>::invalid();
219 
220  consumables_[BT].emplace_back(ConsumableType::ViewElement,
221  TypeID{typeid(T)},
222  it.label(),
223  it.instance(),
224  it.process());
225  return ViewToken<T>{it};
226 }
static ViewToken< Element > invalid()
Definition: ProductToken.h:75
ConsumableProducts consumables_
Definition: Consumer.h:138
bool moduleContext_
Definition: Consumer.h:136
bool art::ProducerBase::modifiesEvent ( ) const
inlineinherited

Definition at line 40 of file ProducerBase.h.

References art::ProducerBase::getProductID().

41  {
42  return true;
43  }
BeamFlashTrackMatchTagger& cosmic::BeamFlashTrackMatchTagger::operator= ( BeamFlashTrackMatchTagger const &  )
delete
BeamFlashTrackMatchTagger& cosmic::BeamFlashTrackMatchTagger::operator= ( BeamFlashTrackMatchTagger &&  )
delete
void art::Consumer::prepareForJob ( fhicl::ParameterSet const &  pset)
protectedinherited

Definition at line 89 of file Consumer.cc.

References fhicl::ParameterSet::get_if_present().

Referenced by art::EDProducer::doBeginJob(), art::EDFilter::doBeginJob(), and art::EDAnalyzer::doBeginJob().

90 {
91  if (!moduleContext_)
92  return;
93 
94  pset.get_if_present("errorOnMissingConsumes", requireConsumes_);
95  for (auto& consumablesPerBranch : consumables_) {
96  cet::sort_all(consumablesPerBranch);
97  }
98 }
bool requireConsumes_
Definition: Consumer.h:137
ConsumableProducts consumables_
Definition: Consumer.h:138
bool moduleContext_
Definition: Consumer.h:136
void cosmic::BeamFlashTrackMatchTagger::produce ( art::Event e)
overridevirtual

Implements art::EDProducer.

Definition at line 97 of file BeamFlashTrackMatchTagger_module.cc.

References util::CreateAssn(), DEFINE_ART_MODULE, lar::extractProviders(), fAlg, fFlashModuleLabel, fHitModuleLabel, fHitTagAssnsAlg, fMakeHitTagAssns, fTrackModuleLabel, util::GetAssociatedVectorManyI(), art::DataViewImpl::getByLabel(), cosmic::HitTagAssociatorAlg::MakeHitTagAssociations(), max, art::Event::put(), and cosmic::BeamFlashTrackMatchTaggerAlg::RunCompatibilityCheck().

98 {
99  // services and providers we'll be using
100  auto providers = lar::extractProviders<
103  >();
104 
106  phot::PhotonVisibilityService const& pvs(*pvsHandle);
108  opdet::OpDigiProperties const& opdigip(*opdigipHandle);
109 
110  //Get Flashes from event.
112  evt.getByLabel(fFlashModuleLabel, flashHandle);
113  std::vector<recob::OpFlash> const& flashVector(*flashHandle);
114 
115  //Get Tracks from event.
117  evt.getByLabel(fTrackModuleLabel, trackHandle);
118  std::vector<recob::Track> const& trackVector(*trackHandle);
119 
120  //Make the containger for the tag product to put onto the event.
121  std::unique_ptr< std::vector<anab::CosmicTag> > cosmicTagPtr ( new std::vector<anab::CosmicTag>);
122  std::vector<anab::CosmicTag> & cosmicTagVector(*cosmicTagPtr);
123 
124  //Make a container for the track<-->tag associations.
125  //One entry per track, with entry equal to index in cosmic tag collection of associated tag.
126  std::vector<size_t> assnTrackTagVector;
127  std::unique_ptr< art::Assns<recob::Track,anab::CosmicTag> > assnTrackTag(new art::Assns<recob::Track,anab::CosmicTag>);
128 
129  //run the alg!
130  fAlg.RunCompatibilityCheck(flashVector, trackVector,
131  cosmicTagVector, assnTrackTagVector,
132  providers, pvs, opdigip);
133 
134 
135  //Make the associations for ART
136  for(size_t track_iter=0; track_iter<assnTrackTagVector.size(); track_iter++){
137  if(assnTrackTagVector[track_iter]==std::numeric_limits<size_t>::max()) continue;
138  art::Ptr<recob::Track> trk_ptr(trackHandle,track_iter);
139  util::CreateAssn(*this, evt, cosmicTagVector, trk_ptr, *assnTrackTag, assnTrackTagVector[track_iter]);
140  }
141 
142  //make hit<--> tag associations, if requested
143  if(fMakeHitTagAssns){
144 
145  //Get Hits from event.
147  evt.getByLabel(fHitModuleLabel, hitHandle);
148 
149  //Get track<-->hit associations
151  evt.getByLabel(fTrackModuleLabel,assnHitTrackHandle);
152  std::vector< std::vector<size_t> >
153  track_indices_per_hit = util::GetAssociatedVectorManyI(assnHitTrackHandle,
154  hitHandle);
155 
156  std::vector< std::vector<size_t> > assnHitTagVector;
157  std::unique_ptr< art::Assns<recob::Hit,anab::CosmicTag> > assnHitTag(new art::Assns<recob::Hit,anab::CosmicTag>);
158 
159  fHitTagAssnsAlg.MakeHitTagAssociations(track_indices_per_hit,
160  assnTrackTagVector,
161  assnHitTagVector);
162 
163  //Make the associations for ART
164  for(size_t hit_iter=0; hit_iter<assnHitTagVector.size(); hit_iter++){
165  art::Ptr<recob::Hit> hit_ptr(hitHandle,hit_iter);
166  for(size_t tag_iter=0; tag_iter<assnHitTagVector[hit_iter].size(); tag_iter++)
167  util::CreateAssn(*this, evt, cosmicTagVector, hit_ptr, *assnHitTag, assnHitTagVector[hit_iter][tag_iter]);
168  }
169 
170  evt.put( std::move(assnHitTag));
171  }//end if makes hit<-->tag associations
172 
173  //put the data on the event
174  evt.put(std::move(cosmicTagPtr));
175  evt.put(std::move(assnTrackTag));
176 
177 }
ProviderPackFromServices< Services... > extractProviders()
Returns a provider pack with providers from specified services.
Definition: ServicePack.h:54
void RunCompatibilityCheck(std::vector< recob::OpFlash > const &, std::vector< recob::Track > const &, std::vector< anab::CosmicTag > &, std::vector< size_t > &, Providers_t, phot::PhotonVisibilityService const &, opdet::OpDigiProperties const &)
Int_t max
Definition: plot.C:27
bool CreateAssn(PRODUCER const &prod, art::Event &evt, std::vector< T > const &a, art::Ptr< U > const &b, art::Assns< U, T > &assn, std::string a_instance, size_t indx=UINT_MAX)
Creates a single one-to-one association.
The geometry of one entire detector, as served by art.
Definition: Geometry.h:110
std::vector< std::vector< size_t > > GetAssociatedVectorManyI(art::Handle< art::Assns< T, U > > h, art::Handle< std::vector< T > > index_p)
void MakeHitTagAssociations(std::vector< std::vector< size_t > > const &bridges_per_hit, std::vector< std::vector< size_t > > const &tags_per_bridges, std::vector< std::vector< size_t > > &tags_per_hit)
TCEvent evt
Definition: DataStructs.cxx:5
void cosmic::BeamFlashTrackMatchTagger::reconfigure ( fhicl::ParameterSet const &  p)

Definition at line 83 of file BeamFlashTrackMatchTagger_module.cc.

References fAlg, fFlashModuleLabel, fHitModuleLabel, fHitTagAssnsAlg, fMakeHitTagAssns, fTrackModuleLabel, fhicl::ParameterSet::get(), cosmic::HitTagAssociatorAlg::reconfigure(), and cosmic::BeamFlashTrackMatchTaggerAlg::reconfigure().

83  {
84  fhicl::ParameterSet alg_params = p.get<fhicl::ParameterSet>("BeamFlashTrackMatchAlgParams");
85  fAlg.reconfigure(alg_params);
86 
87  fhicl::ParameterSet hittagassnsalg_params = p.get<fhicl::ParameterSet>("HitTagAssociatorAlgParams");
88  fHitTagAssnsAlg.reconfigure(hittagassnsalg_params);
89 
90  fTrackModuleLabel = p.get<std::string>("TrackModuleLabel");
91  fFlashModuleLabel = p.get<std::string>("FlashModuleLabel");
92  fMakeHitTagAssns = p.get<bool>("MakeHitTagAssns",false);
93  fHitModuleLabel = p.get<std::string>("HitModuleLabel","dummy_hit");
94 
95 }
void reconfigure(fhicl::ParameterSet const &p)
T get(std::string const &key) const
Definition: ParameterSet.h:231
void reconfigure(fhicl::ParameterSet const &p)
void art::Consumer::showMissingConsumes ( ) const
protectedinherited

Definition at line 125 of file Consumer.cc.

Referenced by art::EDProducer::doEndJob(), art::EDFilter::doEndJob(), art::EDAnalyzer::doEndJob(), and art::RootOutput::endJob().

126 {
127  if (!moduleContext_)
128  return;
129 
130  // If none of the branches have missing consumes statements, exit early.
131  if (std::all_of(cbegin(missingConsumes_),
132  cend(missingConsumes_),
133  [](auto const& perBranch) { return perBranch.empty(); }))
134  return;
135 
136  constexpr cet::HorizontalRule rule{60};
137  mf::LogPrint log{"MTdiagnostics"};
138  log << '\n'
139  << rule('=') << '\n'
140  << "The following consumes (or mayConsume) statements are missing from\n"
141  << module_context(moduleDescription_) << '\n'
142  << rule('-') << '\n';
143 
144  cet::for_all_with_index(
145  missingConsumes_, [&log](std::size_t const i, auto const& perBranch) {
146  for (auto const& pi : perBranch) {
147  log << " "
148  << assemble_consumes_statement(static_cast<BranchType>(i), pi)
149  << '\n';
150  }
151  });
152  log << rule('=');
153 }
cet::exempt_ptr< ModuleDescription const > moduleDescription_
Definition: Consumer.h:140
constexpr T pi()
Returns the constant pi (up to 35 decimal digits of precision)
bool moduleContext_
Definition: Consumer.h:136
ConsumableProductSets missingConsumes_
Definition: Consumer.h:139
void art::Consumer::validateConsumedProduct ( BranchType const  bt,
ProductInfo const &  pi 
)
protectedinherited

Definition at line 101 of file Consumer.cc.

References art::errors::ProductRegistrationFailure.

103 {
104  // Early exits if consumes tracking has been disabled or if the
105  // consumed product is an allowed consumable.
106  if (!moduleContext_)
107  return;
108 
109  if (cet::binary_search_all(consumables_[bt], pi))
110  return;
111 
112  if (requireConsumes_) {
114  "Consumer: an error occurred during validation of a "
115  "retrieved product\n\n")
116  << "The following consumes (or mayConsume) statement is missing from\n"
117  << module_context(moduleDescription_) << ":\n\n"
118  << " " << assemble_consumes_statement(bt, pi) << "\n\n";
119  }
120 
121  missingConsumes_[bt].insert(pi);
122 }
cet::exempt_ptr< ModuleDescription const > moduleDescription_
Definition: Consumer.h:140
bool requireConsumes_
Definition: Consumer.h:137
cet::coded_exception< errors::ErrorCodes, ExceptionDetail::translate > Exception
Definition: Exception.h:66
constexpr T pi()
Returns the constant pi (up to 35 decimal digits of precision)
ConsumableProducts consumables_
Definition: Consumer.h:138
bool moduleContext_
Definition: Consumer.h:136
ConsumableProductSets missingConsumes_
Definition: Consumer.h:139

Member Data Documentation

BeamFlashTrackMatchTaggerAlg cosmic::BeamFlashTrackMatchTagger::fAlg
private

Definition at line 59 of file BeamFlashTrackMatchTagger_module.cc.

Referenced by produce(), and reconfigure().

std::string cosmic::BeamFlashTrackMatchTagger::fFlashModuleLabel
private

Definition at line 61 of file BeamFlashTrackMatchTagger_module.cc.

Referenced by produce(), and reconfigure().

std::string cosmic::BeamFlashTrackMatchTagger::fHitModuleLabel
private

Definition at line 65 of file BeamFlashTrackMatchTagger_module.cc.

Referenced by produce(), and reconfigure().

HitTagAssociatorAlg cosmic::BeamFlashTrackMatchTagger::fHitTagAssnsAlg
private

Definition at line 63 of file BeamFlashTrackMatchTagger_module.cc.

Referenced by produce(), and reconfigure().

bool cosmic::BeamFlashTrackMatchTagger::fMakeHitTagAssns
private
std::string cosmic::BeamFlashTrackMatchTagger::fTrackModuleLabel
private

Definition at line 60 of file BeamFlashTrackMatchTagger_module.cc.

Referenced by produce(), and reconfigure().


The documentation for this class was generated from the following file: