Skip to content

Latest commit

 

History

History
44 lines (32 loc) · 2.17 KB

README.md

File metadata and controls

44 lines (32 loc) · 2.17 KB

cdr-gen

This is a Call Detail Record (CDR) generator based on the CDR Tool, developed by Paul Kinlan.

Command-line Usage

To generate a dataset of CDR records and save at <output_file>:

java -jar cdr-gen.jar <output_file> [<config_file>]

The default configuration file is at src/main/resources/config.json, but a custom configuration can be given at <config_file>.

API Usage

// load the default configuration file
CDRGen generator = new CDRGen();
        
Population population = new Population(generator.getConfig());
population.create();

List<Person> customers = population.getPopulation();

for (Person p : customers) {
    for (Call c : p.getCalls()) {
        // do something
    }
}

Configuration Options

  • callsMade: the average and standard deviation number of calls made by each customer.
  • numAccounts: the number of customers that will generate calls.
  • startDate and endDate: the period when the calls will be made.
  • callTypes: a list with all the call types, for now the Local type is the only obligatory.
  • dayDistribution: the probabilities of a call happening in each day of the week.
  • offPeakTimePeriod: the off peak is a period of time with reduced prices, it happens in the weekends and in the weekdays in a certain period of time, configured by this parameter.
  • outgoingCallParams: for each type of call it gives the cost of the minute, the average and standard deviation of the duration of a call within or not the off peak period and the probability of the call type happening.
  • outgoingNumberDistribution: the average and standard deviation number of phone number for each type of call. It is used to build the set of phone numbers that a customer can call.
  • phoneLines: how many phone lines a customer can have. The number of lines for a customer is randomly generated (gaussian), according to the average and standard deviation.
  • timeDistCsv [optional]: the full path to the file that contains the information about the probabilities of call happening in a given time in a weekday of weekend.