CMS 3D CMS Logo

 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Pages
List of all members | Classes | Public Member Functions | Static Public Member Functions | Private Member Functions | Private Attributes
ExternalLHEProducer Class Reference

#include <Example/ExternalLHEProducer/src/ExternalLHEProducer.cc>

Inheritance diagram for ExternalLHEProducer:
edm::one::EDProducer< edm::BeginRunProducer, edm::EndRunProducer > edm::one::EDProducerBase edm::ProducerBase edm::EDConsumerBase edm::ProductRegistryHelper

Classes

class  FileCloseSentry
 

Public Member Functions

 ExternalLHEProducer (const edm::ParameterSet &iConfig)
 
virtual ~ExternalLHEProducer ()
 
- Public Member Functions inherited from edm::one::EDProducer< edm::BeginRunProducer, edm::EndRunProducer >
 EDProducer ()=default
 
- Public Member Functions inherited from edm::one::EDProducerBase
 EDProducerBase ()
 
ModuleDescription const & moduleDescription () const
 
virtual ~EDProducerBase ()
 
- Public Member Functions inherited from edm::ProducerBase
 ProducerBase ()
 
void registerProducts (ProducerBase *, ProductRegistry *, ModuleDescription const &)
 
std::function< void(BranchDescription
const &)> 
registrationCallback () const
 used by the fwk to register list of products More...
 
virtual ~ProducerBase ()
 
- Public Member Functions inherited from edm::EDConsumerBase
 EDConsumerBase ()
 
ProductHolderIndexAndSkipBit indexFrom (EDGetToken, BranchType, TypeID const &) const
 
void itemsMayGet (BranchType, std::vector< ProductHolderIndexAndSkipBit > &) const
 
void itemsToGet (BranchType, std::vector< ProductHolderIndexAndSkipBit > &) const
 
std::vector
< ProductHolderIndexAndSkipBit >
const & 
itemsToGetFromEvent () const
 
void labelsForToken (EDGetToken iToken, Labels &oLabels) const
 
void modulesDependentUpon (const std::string &iProcessName, std::vector< const char * > &oModuleLabels) const
 
bool registeredToConsume (ProductHolderIndex, bool, BranchType) const
 
bool registeredToConsumeMany (TypeID const &, BranchType) const
 
void updateLookup (BranchType iBranchType, ProductHolderIndexHelper const &)
 
virtual ~EDConsumerBase ()
 

Static Public Member Functions

static void fillDescriptions (edm::ConfigurationDescriptions &descriptions)
 
- Static Public Member Functions inherited from edm::one::EDProducerBase
static const std::string & baseType ()
 
static void fillDescriptions (ConfigurationDescriptions &descriptions)
 
static void prevalidate (ConfigurationDescriptions &descriptions)
 

Private Member Functions

virtual void beginRunProduce (edm::Run &run, edm::EventSetup const &es) override
 
int closeDescriptors (int preserve)
 
virtual void endJob () override
 
virtual void endRunProduce (edm::Run &, edm::EventSetup const &) override
 
void executeScript ()
 
virtual void nextEvent ()
 
virtual void produce (edm::Event &, const edm::EventSetup &) override
 
std::auto_ptr< std::string > readOutput ()
 

Private Attributes

std::vector< std::string > args_
 
uint32_t nEvents_
 
uint32_t npars_
 
std::string outputContents_
 
std::string outputFile_
 
boost::shared_ptr< lhef::LHEEventpartonLevel
 
std::auto_ptr< lhef::LHEReaderreader_
 
boost::shared_ptr
< lhef::LHERunInfo
runInfo
 
boost::shared_ptr
< lhef::LHERunInfo
runInfoLast
 
boost::ptr_deque
< LHERunInfoProduct
runInfoProducts
 
std::string scriptName_
 
bool wasMerged
 

Additional Inherited Members

- Public Types inherited from edm::one::EDProducerBase
typedef EDProducerBase ModuleType
 
- Public Types inherited from edm::ProducerBase
typedef
ProductRegistryHelper::TypeLabelList 
TypeLabelList
 
- Protected Member Functions inherited from edm::ProducerBase
void callWhenNewProductsRegistered (std::function< void(BranchDescription const &)> const &func)
 
- Protected Member Functions inherited from edm::EDConsumerBase
template<typename ProductType , BranchType B = InEvent>
EDGetTokenT< ProductType > consumes (edm::InputTag const &tag)
 
EDGetToken consumes (const TypeToGet &id, edm::InputTag const &tag)
 
template<BranchType B>
EDGetToken consumes (TypeToGet const &id, edm::InputTag const &tag)
 
ConsumesCollector consumesCollector ()
 Use a ConsumesCollector to gather consumes information from helper functions. More...
 
template<typename ProductType , BranchType B = InEvent>
void consumesMany ()
 
void consumesMany (const TypeToGet &id)
 
template<BranchType B>
void consumesMany (const TypeToGet &id)
 
template<typename ProductType , BranchType B = InEvent>
EDGetTokenT< ProductType > mayConsume (edm::InputTag const &tag)
 
EDGetToken mayConsume (const TypeToGet &id, edm::InputTag const &tag)
 
template<BranchType B>
EDGetToken mayConsume (const TypeToGet &id, edm::InputTag const &tag)
 

Detailed Description

Description: [one line class summary]

Implementation: [Notes on implementation]

Definition at line 63 of file ExternalLHEProducer.cc.

Constructor & Destructor Documentation

ExternalLHEProducer::ExternalLHEProducer ( const edm::ParameterSet iConfig)
explicit

Definition at line 124 of file ExternalLHEProducer.cc.

References args_, and npars_.

124  :
125  scriptName_((iConfig.getParameter<edm::FileInPath>("scriptName")).fullPath().c_str()),
126  outputFile_(iConfig.getParameter<std::string>("outputFile")),
127  args_(iConfig.getParameter<std::vector<std::string> >("args")),
128  npars_(iConfig.getParameter<uint32_t>("numberOfParameters")),
129  nEvents_(iConfig.getParameter<uint32_t>("nEvents"))
130 {
131  if (npars_ != args_.size())
132  throw cms::Exception("ExternalLHEProducer") << "Problem with configuration: " << args_.size() << " script arguments given, expected " << npars_;
133  produces<LHEXMLStringProduct, edm::InRun>("LHEScriptOutput");
134 
135  produces<LHEEventProduct>();
136  produces<LHERunInfoProduct, edm::InRun>();
137 }
T getParameter(std::string const &) const
std::vector< std::string > args_
ExternalLHEProducer::~ExternalLHEProducer ( )
virtual

Definition at line 140 of file ExternalLHEProducer.cc.

141 {
142 }

Member Function Documentation

void ExternalLHEProducer::beginRunProduce ( edm::Run run,
edm::EventSetup const &  es 
)
overrideprivatevirtual

Definition at line 214 of file ExternalLHEProducer.cc.

References LHERunInfoProduct::addComment(), LHERunInfoProduct::addHeader(), args_, edm::hlt::Exception, executeScript(), edm::Service< T >::isAvailable(), LogDebug, edm::RandomNumberGenerator::mySeed(), nEvents_, nextEvent(), outputContents_, AlCaHLTBitMon_ParallelJobs::p, edm::Run::put(), reader_, readOutput(), runInfo, runInfoLast, runInfoProducts, runGlobalFakeInputProducer::skip, and wasMerged.

215 {
216 
217  // pass the number of events as previous to last argument
218 
219  std::ostringstream eventStream;
220  eventStream << nEvents_;
221  args_.push_back(eventStream.str());
222 
223  // pass the random number generator seed as last argument
224 
226 
227  if ( ! rng.isAvailable()) {
228  throw cms::Exception("Configuration")
229  << "The ExternalLHEProducer module requires the RandomNumberGeneratorService\n"
230  "which is not present in the configuration file. You must add the service\n"
231  "in the configuration file if you want to run ExternalLHEProducer";
232  }
233  std::ostringstream randomStream;
234  randomStream << rng->mySeed();
235  args_.push_back(randomStream.str());
236 
237  for ( unsigned int iArg = 0; iArg < args_.size() ; iArg++ ) {
238  LogDebug("LHEInputArgs") << "arg [" << iArg << "] = " << args_[iArg];
239  }
240 
241  executeScript();
242  std::auto_ptr<std::string> localContents = readOutput();
243  outputContents_ = *localContents;
244  std::auto_ptr<LHEXMLStringProduct> p(new LHEXMLStringProduct(*localContents));
245  run.put(p, "LHEScriptOutput");
246 
247  // LHE C++ classes translation
248 
249  unsigned int skip = 0;
250  std::auto_ptr<lhef::LHEReader> thisRead( new lhef::LHEReader(outputContents_, skip ) );
251  reader_ = thisRead;
252 
253  nextEvent();
254  if (runInfoLast) {
256 
257  std::auto_ptr<LHERunInfoProduct> product(new LHERunInfoProduct(*runInfo->getHEPRUP()));
258  std::for_each(runInfo->getHeaders().begin(),
259  runInfo->getHeaders().end(),
260  boost::bind(&LHERunInfoProduct::addHeader,
261  product.get(), _1));
262  std::for_each(runInfo->getComments().begin(),
263  runInfo->getComments().end(),
264  boost::bind(&LHERunInfoProduct::addComment,
265  product.get(), _1));
266 
267  // keep a copy around in case of merging
268  runInfoProducts.push_back(new LHERunInfoProduct(*product));
269  wasMerged = false;
270 
271  run.put(product);
272 
273  runInfo.reset();
274  }
275 
276 }
#define LogDebug(id)
std::auto_ptr< std::string > readOutput()
void addHeader(const Header &header)
std::vector< std::string > args_
std::auto_ptr< lhef::LHEReader > reader_
boost::shared_ptr< lhef::LHERunInfo > runInfoLast
virtual std::uint32_t mySeed() const =0
bool isAvailable() const
Definition: Service.h:46
boost::shared_ptr< lhef::LHERunInfo > runInfo
void addComment(const std::string &line)
void put(std::auto_ptr< PROD > product)
Put a new product.
Definition: Run.h:107
boost::ptr_deque< LHERunInfoProduct > runInfoProducts
int ExternalLHEProducer::closeDescriptors ( int  preserve)
private

Definition at line 292 of file ExternalLHEProducer.cc.

References dqmPostProcessing_online::DIR, dir, reco::dp, and NULL.

Referenced by executeScript().

293 {
294  int maxfd = 1024;
295  int fd;
296 #ifdef __linux__
297  DIR * dir;
298  struct dirent *dp;
299  maxfd = preserve;
300  if ((dir = opendir("/proc/self/fd"))) {
301  errno = 0;
302  while ((dp = readdir (dir)) != NULL) {
303  if ((strcmp(dp->d_name, ".") == 0) || (strcmp(dp->d_name, "..") == 0)) {
304  continue;
305  }
306  if (sscanf(dp->d_name, "%d", &fd) != 1) {
307  //throw cms::Exception("closeDescriptors") << "Found unexpected filename in /proc/self/fd: " << dp->d_name;
308  return -1;
309  }
310  if (fd > maxfd) {
311  maxfd = fd;
312  }
313  }
314  if (errno) {
315  //throw cms::Exception("closeDescriptors") << "Unable to determine the number of fd (errno=" << errno << ", " << strerror(errno) << ").";
316  return errno;
317  }
318  closedir(dir);
319  }
320 #endif
321  // TODO: assert for an unreasonable number of fds?
322  for (fd=3; fd<maxfd+1; fd++) {
323  if (fd != preserve)
324  close(fd);
325  }
326  return 0;
327 }
#define NULL
Definition: scimark2.h:8
auto dp
Definition: deltaR.h:24
dbl *** dir
Definition: mlp_gen.cc:35
void ExternalLHEProducer::endJob ( void  )
overrideprivatevirtual

Reimplemented from edm::one::EDProducerBase.

Definition at line 207 of file ExternalLHEProducer.cc.

References reader_.

207  {
208 
209  reader_.reset();
210 }
std::auto_ptr< lhef::LHEReader > reader_
void ExternalLHEProducer::endRunProduce ( edm::Run run,
edm::EventSetup const &  es 
)
overrideprivatevirtual

Definition at line 280 of file ExternalLHEProducer.cc.

References edm::Run::put(), and runInfoProducts.

281 {
282 
283  if (!runInfoProducts.empty()) {
284  std::auto_ptr<LHERunInfoProduct> product(runInfoProducts.pop_front().release());
285  run.put(product);
286  }
287 
288 }
void put(std::auto_ptr< PROD > product)
Put a new product.
Definition: Run.h:107
boost::ptr_deque< LHERunInfoProduct > runInfoProducts
void ExternalLHEProducer::executeScript ( )
private

Definition at line 331 of file ExternalLHEProducer.cc.

References dir2webdir::argc, args_, getDQMSummary::argv, closeDescriptors(), edm::hlt::Exception, i, NULL, sysUtil::pid, pipe::pipe(), SiPixelLorentzAngle_cfi::read, scriptName_, ntuplemaker::status, and TablePrint::write.

Referenced by beginRunProduce().

332 {
333 
334  // Fork a script, wait until it finishes.
335 
336  int rc = 0, rc2 = 0;
337  int filedes[2], fd_flags;
338  unsigned int argc;
339 
340  if (pipe(filedes)) {
341  throw cms::Exception("Unable to create a new pipe");
342  }
343  FileCloseSentry sentry1(filedes[0]), sentry2(filedes[1]);
344 
345  if ((fd_flags = fcntl(filedes[1], F_GETFD, NULL)) == -1) {
346  throw cms::Exception("ExternalLHEProducer") << "Failed to get pipe file descriptor flags (errno=" << rc << ", " << strerror(rc) << ")";
347  }
348  if (fcntl(filedes[1], F_SETFD, fd_flags | FD_CLOEXEC) == -1) {
349  throw cms::Exception("ExternalLHEProducer") << "Failed to set pipe file descriptor flags (errno=" << rc << ", " << strerror(rc) << ")";
350  }
351 
352  argc = 1 + args_.size();
353  // TODO: assert that we have a reasonable number of arguments
354  char **argv = new char *[argc+1];
355  argv[0] = strdup(scriptName_.c_str());
356  for (unsigned int i=1; i<argc; i++) {
357  argv[i] = strdup(args_[i-1].c_str());
358  }
359  argv[argc] = NULL;
360 
361  pid_t pid = fork();
362  if (pid == 0) {
363  // The child process
364  if (!(rc = closeDescriptors(filedes[1]))) {
365  execvp(argv[0], argv); // If execv returns, we have an error.
366  rc = errno;
367  }
368  while ((write(filedes[1], &rc, sizeof(int)) == -1) && (errno == EINTR)) {}
369  _exit(1);
370  }
371 
372  // Free the arg vector ASAP
373  for (unsigned int i=0; i<args_.size()+1; i++) {
374  free(argv[i]);
375  }
376  delete [] argv;
377 
378  if (pid == -1) {
379  throw cms::Exception("ForkException") << "Unable to fork a child (errno=" << errno << ", " << strerror(errno) << ")";
380  }
381 
382  close(filedes[1]);
383  // If the exec succeeds, the read will fail.
384  while (((rc2 = read(filedes[0], &rc, sizeof(int))) == -1) && (errno == EINTR)) { rc2 = 0; }
385  if ((rc2 == sizeof(int)) && rc) {
386  throw cms::Exception("ExternalLHEProducer") << "Failed to execute script (errno=" << rc << ", " << strerror(rc) << ")";
387  }
388  close(filedes[0]);
389 
390  int status = 0;
391  errno = 0;
392  do {
393  if (waitpid(pid, &status, 0) < 0) {
394  if (errno == EINTR) {
395  continue;
396  } else {
397  throw cms::Exception("ExternalLHEProducer") << "Failed to read child status (errno=" << errno << ", " << strerror(errno) << ")";
398  }
399  }
400  if (WIFSIGNALED(status)) {
401  throw cms::Exception("ExternalLHEProducer") << "Child exited due to signal " << WTERMSIG(status) << ".";
402  }
403  if (WIFEXITED(status)) {
404  rc = WEXITSTATUS(status);
405  break;
406  }
407  } while (true);
408  if (rc) {
409  throw cms::Exception("ExternalLHEProducer") << "Child failed with exit code " << rc << ".";
410  }
411 
412 }
int i
Definition: DBlmapReader.cc:9
def pipe
Definition: pipe.py:5
#define NULL
Definition: scimark2.h:8
std::vector< std::string > args_
int closeDescriptors(int preserve)
tuple pid
Definition: sysUtil.py:22
tuple argc
Definition: dir2webdir.py:38
tuple status
Definition: ntuplemaker.py:245
void ExternalLHEProducer::fillDescriptions ( edm::ConfigurationDescriptions descriptions)
static

Definition at line 444 of file ExternalLHEProducer.cc.

References edm::ParameterSetDescription::add(), edm::ConfigurationDescriptions::addDefault(), edm::ParameterSetDescription::setComment(), and AlCaHLTBitMon_QueryRunRegistry::string.

444  {
445  //The following says we do not know what parameters are allowed so do no validation
446  // Please change this to state exactly what you do use, even if it is no parameters
448  desc.setComment("Executes an external script and places its output file into an EDM collection");
449 
450  edm::FileInPath thePath;
451  desc.add<edm::FileInPath>("scriptName", thePath);
452  desc.add<std::string>("outputFile", "myoutput");
453  desc.add<std::vector<std::string> >("args");
454  desc.add<uint32_t>("numberOfParameters");
455  desc.add<uint32_t>("nEvents");
456 
457  descriptions.addDefault(desc);
458 }
void setComment(std::string const &value)
void addDefault(ParameterSetDescription const &psetDescription)
ParameterDescriptionBase * add(U const &iLabel, T const &value)
void ExternalLHEProducer::nextEvent ( )
privatevirtual

Definition at line 460 of file ExternalLHEProducer.cc.

References partonLevel, reader_, runInfo, and runInfoLast.

Referenced by beginRunProduce(), and produce().

461 {
462 
463  if (partonLevel)
464  return;
465 
466  partonLevel = reader_->next();
467  if (!partonLevel)
468  return;
469 
470  boost::shared_ptr<lhef::LHERunInfo> runInfoThis = partonLevel->getRunInfo();
471  if (runInfoThis != runInfoLast) {
472  runInfo = runInfoThis;
473  runInfoLast = runInfoThis;
474  }
475 }
boost::shared_ptr< lhef::LHEEvent > partonLevel
std::auto_ptr< lhef::LHEReader > reader_
boost::shared_ptr< lhef::LHERunInfo > runInfoLast
boost::shared_ptr< lhef::LHERunInfo > runInfo
void ExternalLHEProducer::produce ( edm::Event iEvent,
const edm::EventSetup iSetup 
)
overrideprivatevirtual

Implements edm::one::EDProducerBase.

Definition at line 151 of file ExternalLHEProducer.cc.

References LHEEventProduct::addComment(), LHERunInfoProduct::addComment(), LHERunInfoProduct::addHeader(), LHEEventProduct::addWeight(), nextEvent(), partonLevel, edm::Event::put(), runInfo, runInfoProducts, and wasMerged.

152 {
153  nextEvent();
154  if (!partonLevel)
155  return;
156 
157  std::auto_ptr<LHEEventProduct> product(
158  new LHEEventProduct(*partonLevel->getHEPEUP(),
159  partonLevel->originalXWGTUP())
160  );
161  if (partonLevel->getPDF()) {
162  product->setPDF(*partonLevel->getPDF());
163  }
164  std::for_each(partonLevel->weights().begin(),
165  partonLevel->weights().end(),
166  boost::bind(&LHEEventProduct::addWeight,
167  product.get(), _1));
168  product->setScales(partonLevel->scales());
169  product->setNpLO(partonLevel->npLO());
170  product->setNpNLO(partonLevel->npNLO());
171  std::for_each(partonLevel->getComments().begin(),
172  partonLevel->getComments().end(),
173  boost::bind(&LHEEventProduct::addComment,
174  product.get(), _1));
175 
176  iEvent.put(product);
177 
178  if (runInfo) {
179  std::auto_ptr<LHERunInfoProduct> product(new LHERunInfoProduct(*runInfo->getHEPRUP()));
180  std::for_each(runInfo->getHeaders().begin(),
181  runInfo->getHeaders().end(),
182  boost::bind(&LHERunInfoProduct::addHeader,
183  product.get(), _1));
184  std::for_each(runInfo->getComments().begin(),
185  runInfo->getComments().end(),
186  boost::bind(&LHERunInfoProduct::addComment,
187  product.get(), _1));
188 
189  if (!runInfoProducts.empty()) {
190  runInfoProducts.front().mergeProduct(*product);
191  if (!wasMerged) {
192  runInfoProducts.pop_front();
193  runInfoProducts.push_front(product);
194  wasMerged = true;
195  }
196  }
197 
198  runInfo.reset();
199  }
200 
201  partonLevel.reset();
202  return;
203 }
boost::shared_ptr< lhef::LHEEvent > partonLevel
void addHeader(const Header &header)
void addComment(const std::string &line)
void addWeight(const WGT &wgt)
OrphanHandle< PROD > put(std::auto_ptr< PROD > product)
Put a new product.
Definition: Event.h:116
boost::shared_ptr< lhef::LHERunInfo > runInfo
void addComment(const std::string &line)
boost::ptr_deque< LHERunInfoProduct > runInfoProducts
std::auto_ptr< std::string > ExternalLHEProducer::readOutput ( )
private

Definition at line 416 of file ExternalLHEProducer.cc.

References BUFSIZE, edm::hlt::Exception, n, outputFile_, SiPixelLorentzAngle_cfi::read, contentValuesCheck::ss, and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by beginRunProduce().

417 {
418  int fd;
419  ssize_t n;
420  char buf[BUFSIZE];
421 
422  if ((fd = open(outputFile_.c_str(), O_RDONLY)) == -1) {
423  throw cms::Exception("OutputOpenError") << "Unable to open script output file " << outputFile_ << " (errno=" << errno << ", " << strerror(errno) << ").";
424  }
425 
426  std::stringstream ss;
427  while ((n = read(fd, buf, BUFSIZE)) > 0 || (n == -1 && errno == EINTR)) {
428  if (n > 0)
429  ss.write(buf, n);
430  }
431  if (n == -1) {
432  throw cms::Exception("OutputOpenError") << "Unable to read from script output file " << outputFile_ << " (errno=" << errno << ", " << strerror(errno) << ").";
433  }
434 
435  if (unlink(outputFile_.c_str())) {
436  throw cms::Exception("OutputDeleteError") << "Unable to delete original script output file " << outputFile_ << " (errno=" << errno << ", " << strerror(errno) << ").";
437  }
438 
439  return std::auto_ptr<std::string>(new std::string(ss.str()));
440 }
#define BUFSIZE

Member Data Documentation

std::vector<std::string> ExternalLHEProducer::args_
private
uint32_t ExternalLHEProducer::nEvents_
private

Definition at line 89 of file ExternalLHEProducer.cc.

Referenced by beginRunProduce().

uint32_t ExternalLHEProducer::npars_
private

Definition at line 88 of file ExternalLHEProducer.cc.

Referenced by ExternalLHEProducer().

std::string ExternalLHEProducer::outputContents_
private

Definition at line 90 of file ExternalLHEProducer.cc.

Referenced by beginRunProduce().

std::string ExternalLHEProducer::outputFile_
private

Definition at line 86 of file ExternalLHEProducer.cc.

Referenced by readOutput().

boost::shared_ptr<lhef::LHEEvent> ExternalLHEProducer::partonLevel
private

Definition at line 95 of file ExternalLHEProducer.cc.

Referenced by nextEvent(), and produce().

std::auto_ptr<lhef::LHEReader> ExternalLHEProducer::reader_
private

Definition at line 92 of file ExternalLHEProducer.cc.

Referenced by beginRunProduce(), endJob(), and nextEvent().

boost::shared_ptr<lhef::LHERunInfo> ExternalLHEProducer::runInfo
private

Definition at line 94 of file ExternalLHEProducer.cc.

Referenced by beginRunProduce(), nextEvent(), and produce().

boost::shared_ptr<lhef::LHERunInfo> ExternalLHEProducer::runInfoLast
private

Definition at line 93 of file ExternalLHEProducer.cc.

Referenced by beginRunProduce(), and nextEvent().

boost::ptr_deque<LHERunInfoProduct> ExternalLHEProducer::runInfoProducts
private

Definition at line 96 of file ExternalLHEProducer.cc.

Referenced by beginRunProduce(), endRunProduce(), and produce().

std::string ExternalLHEProducer::scriptName_
private

Definition at line 85 of file ExternalLHEProducer.cc.

Referenced by executeScript().

bool ExternalLHEProducer::wasMerged
private

Definition at line 97 of file ExternalLHEProducer.cc.

Referenced by beginRunProduce(), and produce().