FileServices Class Reference

A class to manage the files associated with each components of the simulation. More...

#include <fileservices.h>

Inheritance diagram for FileServices:

Collaboration diagram for FileServices:

Public Types
typedef std::list< FileHandler * >::const_iterator	file_it

Public Member Functions
	FileServices ()
virtual	~FileServices ()
virtual bool	init ()
virtual void	notify ()
bool	init (list< ParamSet * > &params)
	Checks if files with _basename already exist and save the simulation parameters in log files. More...
virtual Metapop *	get_pop_ptr ()
	Accessor to the pointer to the main population. More...
virtual void	set_pop_ptr (Metapop *pop)
	Sets the Metapop reference. More...
void	set_sampling_params (unsigned int size, age_t age)
	Set the population sampling params. More...
void	setMode (unsigned int m)
	Mode setter, determines if file will get overwritten or not. More...
unsigned int	getMode ()
	Writting mode getter. More...
void	setBasename (string name)
	Sets the base file name of the simulation. More...
void	setRootDir (string name)
	Sets the root directory of the simulation. More...
void	log_simparams ()
	Saves the current simulation parameters to the default parameter logfile. More...
void	log (string message)
	Write to the parameter logfile. More...
list< ParamSet * > &	get_params ()
	Accessor to the list of the current parameters of the simulation. More...
file_it	getFirstWriter ()
	Accessor to first element of the list of output FileHandlers. More...
file_it	getLastWriter ()
	Accessor to last element of the list of output FileHandlers. More...
file_it	getFirstReader ()
	Accessor to first element of the list of input FileHandlers. More...
file_it	getLastReader ()
	Accessor to last element of the list of input FileHandlers. More...
FileHandler *	getReader (string &type)
	Accessor to a specific file handler specified by its extension string. More...
string &	getBaseFileName ()
	Accessor to the base file name of the simulation. More...
string &	getRootDir ()
	Accessor to the name of the simulation's root output directory. More...
string	getReplicateCounter ()
	Accessor to the current replicate counter string. More...
string &	getFirstReplicateFileName ()
	Accessor to the first replicate file name. More...
string &	getReplicateFileName ()
	Accessor to the current replicate file name. More...
string	getGenerationCounter ()
	Accessor to the current generation counter string. More...
string	getGenerationReplicateFileName ()
	Accessor to the current file name with generation and replicate counters added. More...
Metapop *	getSampledPop ()
	Sets the down-sampled population and provides accessor to file handlers. More...
void	subSamplePatch (sex_t SEX, age_idx AGE, Patch *source_patch, Patch *patch)
virtual void	load (SimComponent *sc)
	Tells the SimComponent to load its file handlers. More...
virtual void	attach (Handler *FH)
	Attaches the FileHandler to the current list (_writers) of the FileServices. More...
virtual void	attach_reader (FileHandler *FH)
	Attaches the FileHandler to the current list (_readers) of the FileServices. More...
virtual void	reset ()
	Clears the list of FileHandlers. More...
Public Member Functions inherited from Service
	Service ()
virtual	~Service ()
virtual bool	init ()=0
	Inits internals. More...
virtual void	notify ()=0
	Notifies all observers to update their state. More...
virtual void	load (SimComponent *sc)=0
	Interface used by a simulation component to load its obervers onto a service provider. More...
virtual void	attach (Handler *h)=0
	Adds an observer to the list. More...
virtual void	reset ()=0
	Clears the observers list. More...

Private Attributes
Metapop *	_popPtr
	a pointer to the current Metapop More...
FHLogWriter *	_logWriter
	a FileHandler used to save the simulation parameters on disk. More...
list< FileHandler * >	_writers
	the list of the FileHandler's registered by the SimComponent in output mode More...
list< FileHandler * >	_readers
	the list of the FileHandler's registered by the SimComponent in input mode More...
string	_rep_filename
	the file name associated with the current simulation replicate More...
string	_basename
	the base file name of the simulation, read from the init file (param "filename") More...
string	_root_dir
	the root directory for the simulation's results, read from the init file (param "root_dir") More...
list< ParamSet * >	_params
	the list of the parameters of the current simulation. More...
unsigned int	_mode
	File mode, sets behavior when file must be overwritten or not. More...
unsigned int	_patch_sample_size
	Number of individuals to sample from each patch for the file handlers. More...
age_t	_patch_sample_age
int	_sampled_at_replicate
int	_sampled_at_generation
Metapop *	_sample_pop

Detailed Description

A class to manage the files associated with each components of the simulation.

Implements the Observer design pattern (is the concrete subject), stores the base filename of the simulation and updates the replicate filenames. It also performs files checking and saves the simulation parameters on init.

Member Typedef Documentation

file_it

typedef std::list<FileHandler*>::const_iterator FileServices::file_it

Constructor & Destructor Documentation

FileServices()

FileServices::FileServices

(

)

                            : _popPtr(0), _rep_filename(""), _basename(""), _root_dir(""),
    _patch_sample_size(0), _patch_sample_age(0), _sample_pop(0), _sampled_at_replicate(-1),
    _sampled_at_generation(-1)
{
  _logWriter = new FHLogWriter();
  attach(_logWriter);
}

References _logWriter, and attach().

~FileServices()

FileServices::~FileServices ( )

virtual

                            {
  if(_logWriter) delete _logWriter;
}

References _logWriter.

Member Function Documentation

attach()

void FileServices::attach ( Handler *  FH )

virtual

Attaches the FileHandler to the current list (_writers) of the FileServices.

Parameters

FH	the FileHandler

Implements Service.

{
//  Service::attach(FH);
  FileHandler* FH = dynamic_cast<FileHandler*> (H);
  _writers.push_back(FH);
  
  if(FH->get_isInputHandler()) attach_reader(FH);
  
  FH->set_service(this);
}

References _writers, attach_reader(), FileHandler::get_isInputHandler(), and FileHandler::set_service().

Referenced by FileServices(), BinaryDataSaver::loadFileServices(), LCE_Selection_base::loadFileServices(), Metapop::loadFileServices(), LCE_FileServicesNotifier::loadFileServices(), LCE_StatServiceNotifier::loadFileServices(), TProtoBDMI::loadFileServices(), TProtoDeletMutations_bitstring::loadFileServices(), TProtoNeutralGenes::loadFileServices(), TProtoQuanti::loadFileServices(), and LCE_Breed_Wolbachia::loadFileServices().

Here is the caller graph for this function:

attach_reader()

void FileServices::attach_reader ( FileHandler *  FH )

virtual

Attaches the FileHandler to the current list (_readers) of the FileServices.

Parameters

FH	the FileHandler

{
  _readers.push_back(FH);
  FH->set_service(this);
}

References _readers, and FileHandler::set_service().

Referenced by attach(), LCE_Cross::loadFileServices(), TProtoDeletMutations_bitstring::loadFileServices(), TProtoNeutralGenes::loadFileServices(), and TProtoQuanti::loadFileServices().

Here is the caller graph for this function:

get_params()

list< ParamSet * > & FileServices::get_params ( )

inline

Accessor to the list of the current parameters of the simulation.

{return _params;};

References _params.

Referenced by BinaryDataSaver::printHeader().

Here is the caller graph for this function:

get_pop_ptr()

virtual Metapop * FileServices::get_pop_ptr ( )

inlinevirtual

Accessor to the pointer to the main population.

Returns

the pointer to the current Metapop as set during simulation setup.

{return _popPtr;}

References _popPtr.

Referenced by TTNeutralGenesFH::FHread(), TTBDMI_FH::FHwrite(), TTDeletMutBitstrFH::FHwrite(), TTNeutralGenesFH::FHwrite(), TTQuantiFH::FHwrite(), TTQFreqExtractor::FHwrite(), FileHandler::init(), TTNeutralGenesFH::write_Fst_i(), TTQuantiFH::write_TABLE(), and TTNeutralGenesFH::write_varcompWC().

Here is the caller graph for this function:

getBaseFileName()

string & FileServices::getBaseFileName

(

)

Accessor to the base file name of the simulation.

{
  return _basename;
}

References _basename.

Referenced by FHLogWriter::createInitFile(), LCE_StatFH::FHwrite(), BinaryDataSaver::finish(), FileHandler::get_filename(), BinaryDataSaver::ifExist(), FileHandler::ifExist(), LCE_StatFH::ifExist(), SimRunner::printLog(), LCE_StatFH::PrintStat_byGen(), SimRunner::run(), and SimRunner::runPostExecReplicateWise().

Here is the caller graph for this function:

getFirstReader()

file_it FileServices::getFirstReader ( )

inline

Accessor to first element of the list of input FileHandlers.

{return _readers.begin();}

References _readers.

Referenced by getReader().

Here is the caller graph for this function:

getFirstReplicateFileName()

string & FileServices::getFirstReplicateFileName

(

)

Accessor to the first replicate file name.

{
  ostringstream rpl;
 
  rpl.fill('0');
  rpl.width( (int)log10((double)_popPtr->getReplicates()) + 1);
  rpl<< max( (unsigned)1, _myenv->workerRank() );
 
  _rep_filename = _basename + "_" + rpl.str();
 
  return _rep_filename;
}

References _basename, _myenv, _popPtr, _rep_filename, Metapop::getReplicates(), and MPIenv::workerRank().

getFirstWriter()

file_it FileServices::getFirstWriter ( )

inline

Accessor to first element of the list of output FileHandlers.

{return _writers.begin();}

References _writers.

Referenced by SimRunner::printLog().

Here is the caller graph for this function:

getGenerationCounter()

string FileServices::getGenerationCounter

(

)

Accessor to the current generation counter string.

{
  ostringstream gen;
  
  gen.fill('0');
  gen.width( (int)log10((double)_popPtr->getGenerations()) + 1);
  gen<<_popPtr->getCurrentGeneration();
  
  return gen.str();
}

References _popPtr, Metapop::getCurrentGeneration(), and Metapop::getGenerations().

Referenced by getGenerationReplicateFileName().

Here is the caller graph for this function:

getGenerationReplicateFileName()

string FileServices::getGenerationReplicateFileName

(

)

Accessor to the current file name with generation and replicate counters added.

{
  string name = _basename + "_" + getGenerationCounter() + "_" + getReplicateCounter();
  return name;
}

References _basename, getGenerationCounter(), and getReplicateCounter().

Referenced by TTDeletMutBitstrFH::FHwrite(), FileHandler::get_filename(), TTNeutralGenesFH::write_Fst_i(), TTNeutralGenesFH::write_FSTAT(), TTNeutralGenesFH::write_GENEPOP(), TTNeutralGenesFH::write_PLINK(), TTQuantiFH::write_PLINK(), TTNeutralGenesFH::write_TAB(), and TTNeutralGenesFH::write_varcompWC().

Here is the caller graph for this function:

getLastReader()

file_it FileServices::getLastReader ( )

inline

Accessor to last element of the list of input FileHandlers.

{return _readers.end();}

References _readers.

Referenced by getReader().

Here is the caller graph for this function:

getLastWriter()

file_it FileServices::getLastWriter ( )

inline

Accessor to last element of the list of output FileHandlers.

{return _writers.end();}  

References _writers.

Referenced by SimRunner::printLog().

Here is the caller graph for this function:

getMode()

unsigned int FileServices::getMode ( )

inline

Writting mode getter.

{return _mode;}

References _mode.

Referenced by BinaryDataSaver::finish().

Here is the caller graph for this function:

getReader()

FileHandler * FileServices::getReader

(

string &

type

)

Accessor to a specific file handler specified by its extension string.

{
  file_it file = getFirstReader(), last = getLastReader() ;
    
  for(;file != last; file++) {
    if( (*file)->get_extension().compare( type ) == 0) {
      return (*file);
    }
  }
  return 0;
}

References getFirstReader(), and getLastReader().

Referenced by Metapop::loadPopFromTraitFile().

Here is the caller graph for this function:

getReplicateCounter()

string FileServices::getReplicateCounter

(

)

Accessor to the current replicate counter string.

{
  ostringstream rpl;
  
  rpl.fill('0');
  rpl.width( (int)log10((double)_popPtr->getReplicates()) + 1);
  rpl<<_popPtr->getCurrentReplicate();
  
  return rpl.str();
}

References _popPtr, Metapop::getCurrentReplicate(), and Metapop::getReplicates().

Referenced by getGenerationReplicateFileName(), and getReplicateFileName().

Here is the caller graph for this function:

getReplicateFileName()

string & FileServices::getReplicateFileName

(

)

Accessor to the current replicate file name.

{
  _rep_filename = _basename + "_" + getReplicateCounter();
 
  return _rep_filename;
}

References _basename, _rep_filename, and getReplicateCounter().

Referenced by TTQFreqExtractor::FHwrite(), and FileHandler::get_filename().

Here is the caller graph for this function:

getRootDir()

std::string & FileServices::getRootDir

(

)

Accessor to the name of the simulation's root output directory.

{
  return _root_dir;
}

References _root_dir.

Referenced by FileHandler::set_path().

Here is the caller graph for this function:

getSampledPop()

Metapop * FileServices::getSampledPop

(

)

Sets the down-sampled population and provides accessor to file handlers.

{
  // if the sampling parameters haven't been set, we return the main pop ptr
  if(_patch_sample_size == 0 && _patch_sample_age == 0)
    return _popPtr;
 
  // if we already created a population sample, we return it:
  if( _popPtr->getCurrentReplicate() == _sampled_at_replicate &&
      _popPtr->getCurrentGeneration() == _sampled_at_generation )
  {
    return _sample_pop;
  }
 
#ifdef _DEBUG_
  message("FileServices::setting sub-sampled pop (size = %i, age = %i): ", _patch_sample_size, _patch_sample_age);
#endif
 
  // else, population hasn't been sampled yet, create sample:
 
  Patch *sample_patch, *src_patch;
 
  //first time it is called, the pointer should be NULL upon instantiation of FileServices
  if(!_sample_pop) {
 
    _sample_pop = new Metapop();
 
  } else {
 
    // sampled pop already exists, we empty it (without deleting the individuals)
 
    // remove the patches :
    for(unsigned int i = 0; i < _sample_pop->getPatchArraySize(); ) {
      // removePatch() resizes the array, i must stay = 0 to mimic pop_front() until array is empty
      sample_patch = _sample_pop->removePatch(i);
      sample_patch->clear(); // this resets all container's size to 0 without deleting content
      delete sample_patch;   // delete the patch, without deleting individuals because containers are seen as empty
    }
 
  }
  // check the age flag:
  if( _patch_sample_age != 0) {
 
    // check if current pop age flag is compatible with user's choice:
    // reset it to match with current age structure
    if( _popPtr->getCurrentAge() != _patch_sample_age)
      _patch_sample_age &= _popPtr->getCurrentAge();
 
  } else { // the age flag wasn't set by the user
 
    _patch_sample_age = _popPtr->getCurrentAge();
 
  }
 
  //need to set the age flag of the population
  _sample_pop->setCurrentAge( _patch_sample_age);
 
  // stop here if age flag is null after checking:
  if( _patch_sample_age == 0 )
    fatal("The population cannot be sub-sampled for the age-class chosen (parameter \"files_sample_age\")\n             Check your parameter file or contact the developers\n");
 
#ifdef _DEBUG_
  message("after check, sampling age is %i; ", _patch_sample_age);
#endif
 
  // add patches to match current parameters and patch sizes (discard empty patches)
 
  for(unsigned int i = 0; i < _popPtr->getPatchNbr(); ++i) {
 
    if( _popPtr->size(_patch_sample_age, i) == 0 ) continue; //skip empty patches
 
    src_patch = _popPtr->getPatch(i);
    // allocate new patches
    sample_patch = new Patch();
    sample_patch->setID(i);
    sample_patch->set_K(src_patch->get_K());
    sample_patch->set_KFem(src_patch->get_KFem());
    sample_patch->set_KMal(src_patch->get_KMal());
 
    // sub sample within patch, among offspring:
    if( _patch_sample_age & OFFSPRG) {
 
      subSamplePatch(FEM, OFFSx, src_patch, sample_patch);
      subSamplePatch(MAL, OFFSx, src_patch, sample_patch);
    }
 
    // sub sample within patch, among adults:
    if( _patch_sample_age & ADULTS) {
 
      subSamplePatch(FEM, ADLTx, src_patch, sample_patch);
      subSamplePatch(MAL, ADLTx, src_patch, sample_patch);
    }
 
    _sample_pop->addPatch( sample_patch );
 
  }
 
  _sample_pop->setPatchNbr(_sample_pop->getPatchArraySize());
  _sample_pop->setPatchSizes(*_popPtr->getPatchCapacities());
 
#ifdef _DEBUG_
  message("sampled pop is: \n");
  _sample_pop->show_up();
#endif
 
 
  _sampled_at_replicate = _popPtr->getCurrentReplicate();
  _sampled_at_generation = _popPtr->getCurrentGeneration();
 
  return _sample_pop;
}

References _patch_sample_age, _patch_sample_size, _popPtr, _sample_pop, _sampled_at_generation, _sampled_at_replicate, Metapop::addPatch(), ADLTx, ADULTS, Patch::clear(), fatal(), FEM, Patch::get_K(), Patch::get_KFem(), Patch::get_KMal(), Metapop::getCurrentAge(), Metapop::getCurrentGeneration(), Metapop::getCurrentReplicate(), Metapop::getPatch(), Metapop::getPatchArraySize(), Metapop::getPatchCapacities(), Metapop::getPatchNbr(), MAL, message(), OFFSPRG, OFFSx, Metapop::removePatch(), Patch::set_K(), Patch::set_KFem(), Patch::set_KMal(), Metapop::setCurrentAge(), Patch::setID(), Metapop::setPatchNbr(), Metapop::setPatchSizes(), Metapop::show_up(), Metapop::size(), and subSamplePatch().

Referenced by TTBDMI_FH::FHwrite(), TTDeletMutBitstrFH::FHwrite(), TTNeutralGenesFH::FHwrite(), and TTQuantiFH::FHwrite().

Here is the caller graph for this function:

init() [1/2]

virtual bool FileServices::init ( )

inlinevirtual

Implements Service.

{return false;}

Referenced by SimRunner::run().

Here is the caller graph for this function:

init() [2/2]

bool FileServices::init

(

list< ParamSet * > &

params

)

Checks if files with _basename already exist and save the simulation parameters in log files.

Parameters

params

a ref to the list of the current parameters of the simulation

Returns

true if the files check is ok

false if the user wants to skip this simulation

{
  char yn;
  bool ok;
  file_it HIT;
 
  _params = params;
  
  _logWriter->set(0, 0, 0, 0, 0, "");
 
  //first, build path and filename for each file handler
  HIT = _writers.begin();
 
  if(_myenv->isMaster()) message("    outputs: %s{",_root_dir.c_str());
 
  while(HIT != _writers.end()) {
    if(_myenv->isMaster())  message("%s%s*%s",
                                    (*HIT)->get_path().c_str(),
                                    ((*HIT)->get_path().size() !=0? "/":""),
                                    (*HIT)->get_extension().c_str());
    (*HIT)->init();
    HIT++;
 
    if(HIT != _writers.end() && _myenv->isMaster()) message(", ");
  }
  if(_myenv->isMaster()) message("}\n");
 
  //then check if any file already exists
check:
 
  ok = true;
  HIT = _writers.begin();
  vector<string> local_files, Xing_files;
 
  //we have to skip the first writer, it is the log-writer (always overwritten)
  while(++HIT != _writers.end()) {
 
    Xing_files = (*HIT)->ifExist();
 
    if( Xing_files.size() != 0 ) {
      local_files.insert(local_files.end(), Xing_files.begin(), Xing_files.end() );
      ok = false;
    } else
      ok &= true;
  }
 
  if(!ok) {
 
//    warning("simulation filename \"%s\" already used on disc!", getBaseFileName().c_str());
 
    for(unsigned int i=0; i < local_files.size(); ++i)
      warning("\"%s\" exists", local_files[i].c_str());
 
    //file mode is set during simulation setup, in SimRunner::init()
    if(_mode == 0) { //"run"
 
#if defined(_R_OUTPUT_) || defined(LOW_VERBOSE) || defined(USE_MPI)
      yn = 's';
      message("\nPlease choose an other base filename or move the existing file(s)\n");
#else
 
      message("\nDo you want to overwrite all the files that use it ? (y/n/s(kip)): ");
      cin>>yn;
#endif
 
    } else if( _mode == 1 ) { //"overwrite"
 
      warning("Overwriting existing files.\n\n");
      yn = 'y';
 
    } else if( _mode == 2 ) { //"skip" & "silent_run"
 
      error("Files with the same simulation name already exist on disk!\n");
      error("Choose another base filename or move the existing file(s)\n");
      yn = 's';
 
    } else if( _mode == 3 || _mode == 4) { // "dryrun" & "create_init"
      //dryrun, pretend overwriting, silently
      yn = 'y';      
    } else {
      fatal("Run mode not properly set, check simulation parameter \"run_mode\".\n");
    }
 
 
    switch(yn) {
      case 'y':
        break;
      case 's':
        error("Skipping this simulation\n");
        return false;
      default: {
        message("Please give a new output filename : ");
        cin>>_basename;
        goto check;
      }
    }
  }
  
  return true;
}

References _basename, _logWriter, _mode, _myenv, _params, _root_dir, _writers, error(), fatal(), MPIenv::isMaster(), message(), FileHandler::set(), and warning().

load()

void FileServices::load ( SimComponent *  sc )

virtual

Tells the SimComponent to load its file handlers.

Parameters

sc	the SimComponent

Implements Service.

{sc->loadFileServices(this);}

References SimComponent::loadFileServices().

Referenced by SimRunner::register_component().

Here is the caller graph for this function:

log()

void FileServices::log

(

string

message

)

Write to the parameter logfile.

{
  _logWriter->log_message(message);
}

References _logWriter, FHLogWriter::log_message(), and message().

Referenced by Metapop::loadPopFromBinarySource(), SimRunner::run(), and LCE_Selection_base::set_std_rate_of_change().

Here is the caller graph for this function:

log_simparams()

void FileServices::log_simparams

(

)

Saves the current simulation parameters to the default parameter logfile.

{
  if(_mode == 4)
    _logWriter->createInitFile(_params);
  else
    _logWriter->save_simparams(_params);
}

References _logWriter, _mode, _params, FHLogWriter::createInitFile(), and FHLogWriter::save_simparams().

Referenced by SimRunner::run().

Here is the caller graph for this function:

notify()

void FileServices::notify ( )

virtual

Implements Service.

{
  for (file_it file = _writers.begin(); file != _writers.end(); ++file) {
    (*file)->update();
  }
}

References _writers.

Referenced by LCE_FileServicesNotifier::execute(), and SimRunner::Replicate_LOOP().

Here is the caller graph for this function:

reset()

void FileServices::reset ( )

virtual

Clears the list of FileHandlers.

Implements Service.

{
  //Service::reset(); 
  _writers.clear(); _writers.push_back(_logWriter);
  _readers.clear();
}

References _logWriter, _readers, and _writers.

Referenced by SimRunner::reset_services().

Here is the caller graph for this function:

set_pop_ptr()

virtual void FileServices::set_pop_ptr ( Metapop *  pop )

inlinevirtual

Sets the Metapop reference.

{_popPtr = pop;}

References _popPtr.

Referenced by SimRunner::init_components().

Here is the caller graph for this function:

set_sampling_params()

void FileServices::set_sampling_params ( unsigned int  size, age_t  age  )

inline

Set the population sampling params.

{_patch_sample_size = size; _patch_sample_age = age;}

References _patch_sample_age, and _patch_sample_size.

Referenced by LCE_FileServicesNotifier::loadFileServices().

Here is the caller graph for this function:

setBasename()

void FileServices::setBasename

(

string

name

)

Sets the base file name of the simulation.

{
    _basename = name;
}

References _basename.

Referenced by SimRunner::init().

Here is the caller graph for this function:

setMode()

void FileServices::setMode ( unsigned int  m )

inline

Mode setter, determines if file will get overwritten or not.

{_mode = m;}

References _mode.

Referenced by SimRunner::init().

Here is the caller graph for this function:

setRootDir()

void FileServices::setRootDir

(

string

name

)

Sets the root directory of the simulation.

{
  _root_dir = name;
 
  if(_root_dir.size() != 0 && _root_dir[_root_dir.length()-1] != '/')
        _root_dir += "/";
  
}

References _root_dir.

Referenced by SimRunner::init().

Here is the caller graph for this function:

subSamplePatch()

void FileServices::subSamplePatch	(	sex_t	SEX,
		age_idx	AGE,
		Patch *	source_patch,
		Patch *	patch
	)

{
 
  int* sample = NULL;
  int size = (int)source_patch->size(SEX, AGE), sample_size;
  Individual *ind = 0;
 
  sample_size = (_patch_sample_size <  size ? _patch_sample_size : size);
 
  if( patch->size(SEX, AGE) != 0) fatal("FileServices::subSamplePatch::receiver patch container is not empty before sampling\n");
 
  if( sample_size != 0) {
 
    sample = new int[sample_size];
 
    RAND::Sample(0, size, sample_size, sample, false);
 
    for(unsigned int j = 0; j < sample_size; ++j) {
 
      ind = source_patch->get(SEX, AGE, sample[j]);
 
      patch->add(SEX, AGE, ind);
    }
 
    delete [] sample;
  }
}

References _patch_sample_size, Patch::add(), fatal(), Patch::get(), RAND::Sample(), and Patch::size().

Referenced by getSampledPop().

Here is the caller graph for this function:

Member Data Documentation

_basename

string FileServices::_basename

private

the base file name of the simulation, read from the init file (param "filename")

Referenced by getBaseFileName(), getFirstReplicateFileName(), getGenerationReplicateFileName(), getReplicateFileName(), init(), and setBasename().

_logWriter

FHLogWriter* FileServices::_logWriter

private

a FileHandler used to save the simulation parameters on disk.

Referenced by FileServices(), init(), log(), log_simparams(), reset(), and ~FileServices().

_mode

unsigned int FileServices::_mode

private

File mode, sets behavior when file must be overwritten or not.

Referenced by getMode(), init(), log_simparams(), and setMode().

_params

list< ParamSet* > FileServices::_params

private

the list of the parameters of the current simulation.

The list is created when init() is called from SimRunner::run().

Referenced by get_params(), init(), and log_simparams().

_patch_sample_age

age_t FileServices::_patch_sample_age

private

Referenced by getSampledPop(), and set_sampling_params().

_patch_sample_size

unsigned int FileServices::_patch_sample_size

private

Number of individuals to sample from each patch for the file handlers.

Referenced by getSampledPop(), set_sampling_params(), and subSamplePatch().

_popPtr

Metapop* FileServices::_popPtr

private

a pointer to the current Metapop

Referenced by get_pop_ptr(), getFirstReplicateFileName(), getGenerationCounter(), getReplicateCounter(), getSampledPop(), and set_pop_ptr().

_readers

list< FileHandler* > FileServices::_readers

private

the list of the FileHandler's registered by the SimComponent in input mode

Referenced by attach_reader(), getFirstReader(), getLastReader(), and reset().

_rep_filename

string FileServices::_rep_filename

private

the file name associated with the current simulation replicate

Referenced by getFirstReplicateFileName(), and getReplicateFileName().

_root_dir

string FileServices::_root_dir

private

the root directory for the simulation's results, read from the init file (param "root_dir")

Referenced by getRootDir(), init(), and setRootDir().

_sample_pop

Metapop* FileServices::_sample_pop

private

Referenced by getSampledPop().

_sampled_at_generation

int FileServices::_sampled_at_generation

private

Referenced by getSampledPop().

_sampled_at_replicate

int FileServices::_sampled_at_replicate

private

Referenced by getSampledPop().

_writers

list< FileHandler* > FileServices::_writers

private

the list of the FileHandler's registered by the SimComponent in output mode

Referenced by attach(), getFirstWriter(), getLastWriter(), init(), notify(), and reset().

---

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

• fileservices.h
• fileservices.cc