lib/data_subs.pm

   1 This file contains the code for the subroutines in
   2 Perl-speaks-NONMEMs data module. It is not functional by itself.
   3 The code should be transferred to the module autogenerated by dia2code
   4 using the fill_diacode.pl script.
   5
   6 # {{{ include
   7
   8 start include statements
   9 use Digest::MD5 'md5_hex';
  10 use OSspecific;
  11 use File::Copy "cp";
  12 use Carp;
  13 use Carp qw(cluck);
  14 use Config;
  15 use Math::Random;
  16 use Storable;
  17 use debug;
  18 use ui;
  19 use status_bar;
  20 use Data::Dumper;
  21 use Time::HiRes qw(gettimeofday);
  22 my @primary_column_names = ('ID', 'DATE', 'DAT1', 'DAT2', 'DAT3' ,'L1', 'L2', 'DV', 'MDV', 'RAW_', 'MRG_', 'RPT_', 'TIME', 'DROP', 'SKIP', 'EVID', 'AMT', 'RATE', 'SS', 'II', 'ADDL', 'CMT', 'PCMT', 'CALL');
  23 end include
  24
  25 # }}} include statements
  26
  27 # {{{ description
  28
  29 start description
  30     # The structure of the data class is subject-centric, recognising that
  31     # the subjects included in a study often can be regarded as
  32     # independent. A class for the subject level exists within PsN and is
  33     # called the individual class. A data object consists of at least one
  34     # but probably many individual objects plus optional comments.
  35 end description
  36
  37 # }}} description
  38
  39 # {{{ synopsis
  40
  41 start synopsis
  42     #   use data;
  43     #
  44     #   my $data_obj = data -> new ( filename => 'test040314.dta' );
  45     #
  46     #   $data_obj -> renumber_ascending;
  47     #
  48     #   my $subsets_ref = $data_obj -> case_deletion( bins => 10 );
  49     #
  50     #   my @subsets = @{$subsets_ref};
  51 end synopsis
  52
  53 # }}} synopsis
  54
  55 # {{{ see_also
  56
  57 start see_also
  58     # =begin html
  59     #
  60     # <a HREF="model.html">model</a>, <a HREF="output.html">output</a>,
  61     # <a HREF="tool/modelfit.html">tool::modelfit</a>,
  62     # <a HREF="tool.html">tool</a>
  63     #
  64     # =end html
  65     #
  66     # =begin man
  67     #
  68     # model, output, tool::modelfit, tool
  69     #
  70     # =end man
  71 end see_also
  72
  73 # }}} see_also
  74
  75 # {{{ new
  76
  77 start new
  78       {
  79         # If the column holding the subject identifier is not the
  80         # first, it can be specified using the I<idcolumn> attribute
  81         #
  82         # I<ignoresign> determines which rows that are regarded as
  83         # comments. Corresponds to the IGNORE= option in the $DATA
  84         # record in a NONMEM model file.
  85
  86         $this -> {'use_data_table'} = 0;
  87
  88         ( $this -> {'directory'},
  89           $this -> {'filename'} ) = OSspecific::absolute_path( $this -> {'directory'},
  90                                                                $this->{'filename'} );
  91
  92         debug -> warn( level => 2,
  93                        message => "data -> new: Data object initialized from file: ".
  94                        $this -> full_name );
  95
  96 #       sub register_in_database {
  97 #         my $this = shift;
  98 #         # Backslashes messes up the sql syntax
  99 #         my $file_str = $this->{'filename'};
 100 #         my $dir_str = $this->{'directory'};
 101 #         $file_str =~ s/\\/\//g;
 102 #         $dir_str =~ s/\\/\//g;
 103
 104 #         # md5sum
 105 #         my $md5sum = md5_hex(OSspecific::slurp_file($this-> full_name ));
 106 #         my $dbh = DBI ->
 107 #             connect("DBI:mysql:host=".$PsN::config -> {'_'} -> {'database_server'}.
 108 #                     ";databse=".$PsN::config -> {'_'} -> {'project'},
 109 #                     $PsN::config -> {'_'} -> {'user'},
 110 #                     $PsN::config -> {'_'} -> {'password'},
 111 #                     {'RaiseError' => 1});
 112 #         my $sth;
 113 #         my $sth = $dbh -> prepare( "SELECT data_id FROM ".$PsN::config -> {'_'} -> {'project'}.
 114 #                              ".data ".
 115 #                                    "WHERE filename = '$file_str' AND ".
 116 #                                    "directory = '$dir_str' AND ".
 117 #                                    "md5sum = '".$md5sum."'" );
 118 #         $sth -> execute or debug -> die( message => $sth->errstr ) ;
 119 #         my $select_arr = $sth -> fetchall_arrayref;
 120 #         if ( scalar @{$select_arr} > 0 ) {
 121 #           debug -> warn( level   => 1,
 122 #                          message => "Found an old entry in the database matching the ".
 123 #                          "current data file" );
 124 #           if ( scalar @{$select_arr} > 1 ) {
 125 #             debug -> warn( level   => 1,
 126 #                            message => "Found more than one matching entry in database".
 127 #                            ", using the first" );
 128 #           }
 129 #           $this -> {'data_id'} = $select_arr->[0][0];
 130 #         } else {
 131 #           my ( $date_str, $time_str );
 132 #           if ( $Config{osname} eq 'MSWin32' ) {
 133 #             $date_str = `date /T`;
 134 #             $time_str = ' '.`time /T`;
 135 #           } else {
 136 #             # Assuming UNIX
 137 #             $date_str = `date`;
 138 #           }
 139 #           chomp($date_str);
 140 #           chomp($time_str);
 141 #           my $date_time = $date_str.$time_str;
 142 #           $sth = $dbh -> prepare("INSERT INTO ".$PsN::config -> {'_'} -> {'project'}.
 143 #                              ".data (filename,date,directory,md5sum) ".
 144 #                                  "VALUES ('$file_str', '$date_time', '$dir_str','".
 145 #                                  $md5sum."' )");
 146 #           $sth -> execute;
 147 #           $this -> {'data_id'} = $sth->{'mysql_insertid'};
 148 #         }
 149 #         $sth -> finish;
 150 #         $dbh -> disconnect;
 151 #         }
 152
 153
 154         unless ( ( defined $this -> {'header'} and
 155                    scalar @{$this -> {'header'}} > 0 ) or
 156                  ( defined $this -> {'individuals'} and
 157                    scalar @{$this -> {'individuals'}} > 0 ) ) {
 158           if ( -e $this -> full_name ) {
 159             if ( $this -> {'target'} eq 'mem' ) {
 160 #             &register_in_database( $this ) if ( $PsN::config -> {'_'} -> {'use_database'} and
 161 #                                                 $this -> {'use_data_table'} );
 162               $this -> _read_header;
 163               $this -> _read_individuals;
 164               $this -> {'synced'} = 1;
 165             } else {
 166               $this -> {'synced'} = 0;
 167             }
 168           } else {
 169             debug -> die(message => "No header, individuals, and no file " . $this -> full_name . " on disk.")
 170               unless $this -> {'ignore_missing_files'};
 171             $this ->  {'synced'} = 0;
 172           }
 173         } else {
 174           if ( $this -> {'target'} eq 'mem') {
 175             if ( -e $this -> {'filename'} ) {
 176               $this -> _read_header;
 177 #             &register_in_database if ( $PsN::config -> {'_'} -> {'use_database'} and
 178 #                                        $this -> {'use_data_table'} );
 179               $this -> _read_individuals;
 180               $this -> {'synced'} = 1;
 181             } else {
 182               debug -> die(message => "No file:".$this->{'filename'}." on disk" )
 183                   unless $this -> {'ignore_missing_files'};
 184               $this -> {'synced'} = 0;
 185             }
 186           } else {
 187             $this -> flush;
 188           }
 189         }
 190
 191         if ( $this -> {'synced'} ) {
 192           my $i = 1;
 193           foreach my $head ( @{$this -> {'header'}} ) {
 194             $this -> {'column_head_indices'} -> {$head} = $i;
 195             $i++;
 196           }
 197         }
 198 #       $Data::Dumper::Maxdepth = 3;
 199 #       die Dumper $this -> {'individuals'};
 200       }
 201 end new
 202
 203 # }}} new
 204
 205 # {{{ register_in_database
 206 start register_in_database
 207     if ( $PsN::config -> {'_'} -> {'use_database'} ) {
 208       # Backslashes messes up the sql syntax
 209       my $file_str = $self->{'filename'};
 210       my $dir_str = $self->{'directory'};
 211       $file_str =~ s/\\/\//g;
 212       $dir_str =~ s/\\/\//g;
 213
 214       my $project = $PsN::config -> {'_'} -> {'project'};
 215       # md5sum
 216       my $md5sum = md5_hex(OSspecific::slurp_file($self-> full_name ));
 217
 218       my $dbh = DBI -> connect("DBI:mysql:host=".$PsN::config -> {'_'} -> {'database_server'}.
 219                                ";databse=".$project,
 220                                $PsN::config -> {'_'} -> {'user'},
 221                                $PsN::config -> {'_'} -> {'password'},
 222                                {'RaiseError' => 1});
 223
 224       my $sth;
 225
 226       my $select_arr = [];
 227
 228       if ( not $force ) {
 229         my $sth = $dbh -> prepare( "SELECT data_id FROM ".$project.
 230                                    ".data ".
 231                                    "WHERE filename = '$file_str' AND ".
 232                                    "directory = '$dir_str' AND ".
 233                                    "md5sum = '".$md5sum."'" );
 234         $sth -> execute or debug -> die( message => $sth->errstr ) ;
 235         $select_arr = $sth -> fetchall_arrayref;
 236       }
 237
 238       if ( scalar @{$select_arr} > 0 ) {
 239         'debug' -> warn( level   => 1,
 240                          message => "Found an old entry in the database matching the ".
 241                          "current data file" );
 242         if ( scalar @{$select_arr} > 1 ) {
 243           'debug' -> warn( level   => 1,
 244                            message => "Found more than one data matching entry in database".
 245                            ", using the first" );
 246         }
 247         $self -> {'data_id'} = $select_arr->[0][0];
 248         # Find the id's
 249         my $sth = $dbh -> prepare( "SELECT individual_id FROM ".$project.".data_individual ".
 250                                    "WHERE data_id = '".$self -> {'data_id'}."'" );
 251         $sth -> execute or debug -> die( message => $sth->errstr ) ;
 252         my $id_arr = $sth -> fetchall_arrayref;
 253         map( $_ = $_ -> [0], @{$id_arr} );
 254         $self -> {'individual_ids'} = $id_arr;
 255       } elsif ( defined $self -> {'individuals'} ) {
 256         my ( $date_str, $time_str );
 257         if( $Config{osname} eq 'MSWin32' ){
 258           $date_str = `date /T`;
 259           $time_str = ' '.`time /T`;
 260         } else {
 261           # Assuming UNIX
 262           $date_str = `date`;
 263         }
 264         chomp($date_str);
 265         chomp($time_str);
 266         my $date_time = $date_str.$time_str;
 267         my ( $columns, $values );
 268         my $res_str = $resampled ? '1' : '0';
 269         if ( defined $model_id ) {
 270           $columns = '(model_id, filename, date, directory, md5sum, resampled)';
 271           $values = "('$model_id', '$file_str', '$date_time', '$dir_str','".
 272               $md5sum."', '$res_str' )";
 273         } else {
 274           $columns = '(filename, date, directory, md5sum, resampled)';
 275           $values = "('$file_str', '$date_time', '$dir_str','".$md5sum."', '$res_str' )";
 276         }
 277         $sth = $dbh -> prepare("INSERT INTO ".$PsN::config -> {'_'} -> {'project'}.
 278                                ".data $columns VALUES $values");
 279         $sth -> execute;
 280         $self -> {'data_id'} = $sth->{'mysql_insertid'};
 281
 282         if ( defined $self -> {'data_id'} ) {
 283           my $values;
 284           my $columns = "( id_key, id )";
 285           if( $#individual_ids >= 0 ) {
 286             $self -> register_di_relation( individual_ids => \@individual_ids );
 287           } else {
 288             my $inds = scalar @{$self -> {'individuals'}};
 289             $dbh -> do( "LOCK TABLES ".$PsN::config -> {'_'} -> {'project'}.
 290                         ".individual WRITE" );
 291 #           $sth = $dbh -> prepare( "SELECT MAX(individual_id)".
 292 #                                   " FROM ".$PsN::config -> {'_'} -> {'project'}.
 293 #                                   ".individual" );
 294             $dbh -> do( 'USE '.$PsN::config -> {'_'} -> {'project'} );
 295             $sth = $dbh -> prepare( "SHOW TABLE STATUS LIKE 'individual'" );
 296             $sth -> execute or debug -> die( message => $sth->errstr ) ;
 297             my $select_arr = $sth -> fetchall_arrayref;
 298             my $first_id_id = $select_arr -> [0][10] ?
 299                 $select_arr -> [0][10] : 0;
 300 #           my $first_id_id = $select_arr -> [0][0] ? ($select_arr -> [0][0] + 1) : 0;
 301             my $last_id_id = $first_id_id + $inds - 1;
 302             for( my $i = 0; $i < $inds; $i++ ) {
 303               if( defined $self -> {'individuals'}[$i] ) {
 304                 my $id_id = $self -> {'individuals'}[$i] -> idnumber;
 305                 $values = $values."," if ( defined $values );
 306                 $values = $values."( $i, $id_id )";
 307               }
 308             }
 309             $sth = $dbh -> prepare( "INSERT INTO ".$PsN::config -> {'_'} -> {'project'}.
 310                                     ".individual $columns VALUES $values" );
 311             $sth -> execute;
 312             $dbh -> do( "UNLOCK TABLES" );
 313             @individual_ids = ($first_id_id .. $last_id_id);
 314             $self -> register_di_relation( individual_ids => \@individual_ids );
 315           }
 316           $self -> {'individual_ids'} = \@individual_ids;
 317         }
 318         $sth -> finish;
 319         $dbh -> disconnect;
 320       }
 321       $data_id = $self -> {'data_id'}; # return the data_id
 322     }
 323 end register_in_database
 324 # }}} register_in_database
 325
 326 # {{{ register_di_relation
 327 start register_di_relation
 328   if ( $PsN::config -> {'_'} -> {'use_database'} and
 329        defined $self -> {'data_id'} and $#individual_ids >= 0 ) {
 330     my $dbh = DBI -> connect("DBI:mysql:host=".$PsN::config -> {'_'} -> {'database_server'}.
 331                              ";databse=".$PsN::config -> {'_'} -> {'project'},
 332                              $PsN::config -> {'_'} -> {'user'},
 333                              $PsN::config -> {'_'} -> {'password'},
 334                              {'raiseerror' => 1});
 335     my $sth;
 336     my $values;
 337     my $columns = "( data_id, individual_id )";
 338     foreach my $individual_id ( @individual_ids ) {
 339       if ( defined $individual_id ) {
 340         $values = $values."," if ( defined $values );
 341         $values = $values."(".$self -> {'data_id'}.", $individual_id )";
 342       }
 343     }
 344     $sth = $dbh -> prepare( "INSERT INTO ".$PsN::config -> {'_'} -> {'project'}.
 345                                ".data_individual $columns VALUES $values" );
 346     $sth -> execute;
 347     $sth -> finish if ( defined $sth );
 348     $dbh -> disconnect;
 349   }
 350 end register_di_relation
 351 # }}} register_di_relation
 352
 353 # {{{ full_name
 354
 355 start full_name
 356       {
 357         $full_name = $self -> {'directory'} . $self -> {'filename'};
 358       }
 359 end full_name
 360
 361 # }}}
 362
 363 # {{{ bootstrap
 364
 365 start bootstrap
 366       {
 367         # The bootstrap method draws I<samples> number of boostrap
 368         # samples from the data set. The I<subjects> arguments
 369         # determines the size of each sample (default equals to the
 370         # number of individuals in the original data set). The method
 371         # returns references to three arrays: I<boot_samples_ref>,
 372         # which holds the bootstrap data sets, I<incl_individuals_ref>
 373         # which holds arrays containing the subject identifiers (ID's)
 374         # for the included individuals of each bootstrap data set and
 375         # I<included_keys_ref> which holds the key or index of the
 376         # included individuals. The key or index is an integer
 377         # starting at 1 for the first individual in the original data
 378         # set and increasing by one for each following.
 379         $self -> synchronize;
 380         my @header      = @{$self -> {'header'}};
 381         my $individuals = $self -> {'individuals'};
 382         my $key_ref;
 383
 384         my $status_bar = status_bar -> new( steps => $samples );
 385         ui -> print( category => 'bootstrap',
 386                      message => $status_bar -> print_step,
 387                      newline => 0);
 388
 389         for ( my $i = 1; $i <= $samples; $i++ ) {
 390           my $new_name = defined $name_stub ? $name_stub."_$i.dta" : "bs$i.dta";
 391           $new_name = $directory.'/'.$new_name;
 392           my ( $boot, $incl_ind_ref, $incl_key_ref ) =
 393             $self -> resample( subjects    => $subjects,
 394                                resume      => $resume,
 395                                new_name    => $new_name,
 396                                target      => $target,
 397                                stratify_on => $stratify_on,
 398                                model_id    => $model_ids[$i-1] );
 399           push( @included_keys, $incl_key_ref );
 400           push( @incl_individuals, $incl_ind_ref );
 401 #         $boot -> renumber_ascending;
 402           push( @boot_samples, $boot );
 403 #          $boot -> synchronize;
 404 #          $boot -> flush;
 405           if( $status_bar -> tick() ){
 406             ui -> print( category => 'bootstrap',
 407                          message => $status_bar -> print_step,
 408                          newline => 0,
 409                          wrap => 0);
 410           }
 411 #         print Dumper \@boot_samples;
 412 #         sleep(10);
 413         }
 414         ui -> print( category => 'bootstrap',
 415                      message => ' ... done' );
 416       }
 417 end bootstrap
 418
 419 # }}} bootstrap
 420
 421 # {{{ resample
 422
 423 start resample
 424       {
 425         $self -> synchronize;
 426         my ( @header, $individuals, @bs_inds, $key_ref, @id_ids, @bs_id_ids );
 427         @id_ids = @{$self -> {'individual_ids'}} if( defined $self -> {'individual_ids'} );
 428         if ( defined $stratify_on ) {
 429           unless ( $resume and -e $new_name ) {
 430             @header = @{$self -> {'header'}};
 431             $individuals = $self -> {'individuals'};
 432             my %strata;
 433             if( $stratify_on =~ /\D/ ){
 434               %strata = %{$self -> factors( column_head => $stratify_on )};
 435               if ( $strata{'Non-unique values found'} eq '1' ) {
 436                 debug -> die( message => "Individuals were found to have multiple values in the $stratify_on column. ".
 437                               "The column $stratify_on cannot be used for stratification of the resampling." );
 438               }
 439             } else {
 440               %strata = %{$self -> factors( column => $stratify_on )};
 441               if ( $strata{'Non-unique values found'} eq '1' ) {
 442                 debug -> die( message => "Individuals were found to have multiple values in column number $stratify_on. ".
 443                               "Column $stratify_on cannot be used for stratification of the resampling." );
 444               }
 445             }
 446
 447             while( my ( $factor, $key_list ) = each %strata ) {
 448               my $keys = scalar @{$key_list};
 449               for ( my $i = 0; $i < $keys; $i++ ) {
 450                 my $list_ref = random_uniform_integer(1,0,$keys-1);
 451                 push( @bs_inds, $individuals ->
 452                       [ $key_list -> [$list_ref] ] -> copy );
 453                 push( @included_keys, $key_list -> [$list_ref] );
 454                 push( @incl_individuals, $individuals ->
 455                       [ $key_list -> [$list_ref] ] -> idnumber );
 456                 push( @bs_id_ids, $id_ids[ $key_list -> [$list_ref] ] );
 457               }
 458             }
 459
 460             $boot = data -> new( header      => \@header,
 461                                  idcolumn    => $self -> {'idcolumn'},
 462                                  ignoresign  => $self -> {'ignoresign'},
 463                                  individuals => \@bs_inds,
 464                                  filename    => $new_name,
 465                                  ignore_missing_files => 1,
 466                                  target      => 'mem' );
 467             $boot -> renumber_ascending;
 468             $boot -> _write;
 469             $boot -> flush;
 470             #$boot -> target( $target );
 471           }
 472         } else {
 473           unless ( $resume and -e $new_name ) {
 474             @header = @{$self -> {'header'}};
 475             $individuals = $self -> {'individuals'};
 476             for ( my $i = 1; $i <= $subjects; $i++ ) {
 477               $key_ref = random_uniform_integer(1,0,scalar @{$individuals}-1);
 478               push( @bs_inds, $individuals -> [ $key_ref ] -> copy );
 479               push( @included_keys, $key_ref );
 480               push( @incl_individuals, $individuals -> [ $key_ref ] -> idnumber );
 481               push( @bs_id_ids, $id_ids[ $key_ref ] );
 482             }
 483
 484             # MUST FIX: If a file already exists with the same name,
 485             # the created bs data set will be appended to this. IT
 486             # MUST BE OVERWRITTEN!
 487             $boot = data -> new( header      => \@header,
 488                                  idcolumn    => $self -> {'idcolumn'},
 489                                  ignoresign  => $self -> {'ignoresign'},
 490                                  individuals => \@bs_inds,
 491                                  filename    => $new_name,
 492                                  ignore_missing_files => 1,
 493                                  target      => 'mem' );
 494             $boot -> renumber_ascending;
 495             $boot -> _write;
 496             $boot -> target( $target );
 497           } else {
 498             # If we are resuming, we still need to generate the
 499             # pseudo-random sequence and initiate a data object
 500             for ( my $i = 1; $i <= $subjects; $i++ ) {
 501               random_uniform_integer(1,0,scalar @{$individuals}-1)
 502             }
 503             $boot = data -> new( idcolumn    => $self -> {'idcolumn'},
 504                                  ignoresign  => $self -> {'ignoresign'},
 505                                  filename    => $new_name,
 506                                  ignore_missing_files => 1,
 507                                  target      => $target );
 508             $boot -> _write;
 509             $boot -> flush;
 510           }
 511           if( $target eq 'disk'){
 512             $boot -> flush;
 513           }
 514         }
 515         $boot -> register_in_database( individual_ids => \@bs_id_ids,
 516                                        resampled      => 1,
 517                                        model_id       => $model_id );
 518       }
 519 end resample
 520
 521 # }}} resample
 522
 523 # {{{ case_deletion
 524
 525 start case_deletion
 526       {
 527         # case_deletion creates subsets of the data. The number of
 528         # subsets is specified by the bins argument. The individuals
 529         # of each subset is selected randomly or in ascending
 530         # numerical order depending on the selection argument that can
 531         # be either 'consecutive' or 'random'. case_column must be
 532         # specified to give the method something to base the selection
 533         # on. Valid case_column values are either the column number
 534         # (pure digits) or the name of the column in the (optional)
 535         # header row.
 536         $self -> synchronize;
 537         my @header    = @{$self -> {'header'}};
 538         if ( not defined $case_column ) {
 539           debug -> die( message => "case_column must be specified" );
 540         } else {
 541           if ( not $case_column =~ /^\d/ ) {
 542             for ( my $i = 0; $i <= $#header; $i++ ) {
 543               $case_column = $i+1 if ( $header[$i] eq $case_column );
 544             }
 545           }
 546         }
 547         $bins = defined $bins ? $bins :
 548           scalar keys %{$self -> factors( column => $case_column)};
 549         my %factors   = %{$self -> factors( column => $case_column )};
 550         if ( $factors{'Non-unique values found'} eq '1' ) {
 551           debug -> die( message => "Individuals were found to have multiple values in column number $case_column. ".
 552                         "Column $case_column cannot be used for case deletion." );
 553         }
 554
 555         my $maxbins   = scalar keys %factors;
 556         my @ftrs      = sort { $a <=> $b } keys %factors;
 557         my $individuals = $self -> {'individuals'};
 558         my $maxkey    = scalar @{$individuals} - 1;
 559
 560         my ( @tmp_ftrs, @binsize ) =
 561             ((),());
 562         my ( $k, $j, $i ) = ( 0, 0, 0 );
 563         # Create the binsizes
 564         for ( $j = 0; $j < $maxbins; $j++ ) {
 565           $binsize[ $k++ ]++;
 566           $k = 0 if( $k >= $bins );
 567         }
 568         $self -> _fisher_yates_shuffle( array => \@ftrs ) if( $selection eq 'random' );
 569         for ( $k = 0; $k < $bins; $k++ ) {
 570           for ( $j = 0; $j < $binsize[ $k ]; $j++ ) {
 571 #           print "SK: ",$skipped_keys[ $k ]," F: ",$factors{ $ftrs[ $i ] },"\n";
 572             push( @{$skipped_keys[ $k ]}, @{$factors{ $ftrs[ $i ] }} );
 573             push( @{$skipped_values[ $k ]}, $ftrs[ $i++ ] );
 574           }
 575         }
 576
 577         for ( $k = 0; $k < $bins; $k++ ) {
 578           my @cd_inds = ();
 579           my @del_inds = ();
 580         SELKEYS: foreach my $key ( 0..$maxkey ) {
 581           foreach my $skipped ( @{$skipped_keys[ $k ]} ) {
 582             if ( $key == $skipped ) {
 583               push( @{$skipped_ids[ $k ]}, $individuals ->
 584                     [ $skipped ] -> idnumber );
 585               push( @del_inds, $individuals -> [ $key ] -> copy );
 586               next SELKEYS;
 587             }
 588           }
 589           push( @cd_inds, $individuals -> [ $key ] -> copy );
 590         }
 591           # Set ignore_missing_files = 1 to make it possible to get the result
 592           # in memory only
 593           my $newdata = data ->
 594               new ( header      => \@header,
 595                     ignoresign  => $self -> {'ignoresign'},
 596                     idcolumn    => $self -> {'idcolumn'},
 597                     individuals => \@cd_inds,
 598                     target      => $target,
 599                     filename    => $directory.'/cdd_'.($k+1).'.dta',
 600                     ignore_missing_files => 1 );
 601           my $deldata = data ->
 602               new ( header      => \@header,
 603                     ignoresign  => $self -> {'ignoresign'},
 604                     idcolumn    => $self -> {'idcolumn'},
 605                     individuals => \@del_inds,
 606                     target      => $target,
 607                     filename    => $directory.'/rem_'.($k+1).'.dta',
 608                     ignore_missing_files => 1 );
 609           push( @subsets, $newdata );
 610           push( @remainders, $deldata );
 611           $newdata -> _write;
 612           $newdata -> flush;
 613           $deldata -> _write;
 614           $deldata -> flush;
 615         }
 616       }
 617 end case_deletion
 618
 619 # }}} case_deletion
 620
 621 # {{{ copy
 622 start copy
 623       {
 624         # filename: new data file name.
 625         #
 626         # target: keep the copy in memory ('mem') or write it to disk and flush the memory ('disk').
 627
 628         ($directory, $filename) = OSspecific::absolute_path( $directory, $filename );
 629
 630         # Clone self into new data object. Why don't the individuals get cloned too?
 631         # strange. need to set synced to 0 AND set the {'individuals'} to undef.
 632         cp($self -> full_name, $directory.$filename );
 633         $new_data = Storable::dclone( $self );
 634         $new_data -> {'synced'} = 0;
 635         $new_data -> {'individuals'} = undef;
 636         $new_data -> synchronize;
 637
 638         # Set the new file name for the copy
 639         $new_data -> directory( $directory );
 640         $new_data -> filename( $filename );
 641       }
 642 end copy
 643
 644 # }}} copy
 645
 646 # {{{ column_to_array
 647 start column_to_array
 648 {
 649   $self -> synchronize;
 650
 651   if ( not $column =~ /^\d/ ) {
 652     $column = $self -> {'column_head_indices'} -> {$column} - 1;
 653   }
 654
 655   if( $column < 0 or $column > $#{$self -> {'header'}} ){
 656     return [];
 657   }
 658
 659   foreach my $individual ( @{$self -> individuals} ){
 660     foreach my $individual_row( @{$individual -> subject_data} ){
 661       my @row = split(/,/ , $individual_row);
 662       push( @array, $row[$column] );
 663     }
 664   }
 665 }
 666 end column_to_array
 667 # }}}
 668
 669 # {{{ count_ind
 670
 671 start count_ind
 672       {
 673         # Returns the number of individuals in the data set.
 674         $self -> synchronize;
 675         $num = scalar @{$self -> {'individuals'}};
 676       }
 677 end count_ind
 678
 679 # }}} count_ind
 680
 681 # {{{ diff
 682 start diff
 683 {
 684   $self -> synchronize;
 685
 686   my $first_id = $self -> {'individuals'}[0];
 687
 688   debug -> die( message => "No individuals defined in data object based on ".
 689                 $self -> full_name ) unless ( defined $first_id );
 690
 691   # Check if $column(-index) is defined and valid, else try to find index
 692   # using column_head
 693
 694   my @data_row = split( /,/, $first_id -> subject_data -> [0] );
 695   if( $#columns >= 0 ) {
 696     foreach my $column ( @columns ) {
 697       unless ( defined $column && defined( $data_row[$column-1] ) ) {
 698         debug -> die( message => "Error in data -> factors: ".
 699                       "invalid column number: \"$column\"\n".
 700                       "Valid column numbers are 1 to ".
 701                       scalar @{$first_id -> subject_data ->[0]}."\n" );
 702       }
 703     }
 704   } elsif ( $#column_heads >= 0 ) {
 705     foreach my $column_head ( @column_heads ) {
 706       unless (defined($column_head) && defined($self -> {'column_head_indices'}{$column_head})) {
 707         debug -> die( message => "Error in data -> factors: unknown column: \"$column_head\" ".
 708                       "Valid column headers are (in no particular order):\n".
 709                       join(', ',keys(%{$self -> {'column_head_indices'}})) );
 710       } else {
 711         my $column = $self -> {'column_head_indices'}{$column_head};
 712         push( @columns, $column );
 713         debug -> warn( level   => 2,
 714                        message => "$column_head is in column number $column" );
 715       }
 716     }
 717   } else {
 718     debug -> die( message => "No column or column_head defined" );
 719   }
 720
 721   if( $global_largest or $global_smallest or
 722       $largest_per_individual or $smallest_per_individual ) {
 723     if( not scalar @{$self -> {'individuals'}} == scalar @{$against_data -> individuals} ) {
 724       debug -> die( message => "Both data object must hold the same number of individuals ".
 725                     "and observations when calling data -> diff" );
 726     }
 727     for( my $i = 0; $i < scalar @{$self -> {'individuals'}}; $i++ ) {
 728       my %id_diffs = %{$self -> {'individuals'}[$i] ->
 729                            diff( against_individual => $against_data -> individuals -> [$i],
 730                                  columns            => \@columns,
 731                                  absolute_diff      => $absolute_diff,
 732                                  diff_as_fraction   => $diff_as_fraction,
 733                                  largest            => ( $global_largest or $largest_per_individual ),
 734                                  smallest           => ( $global_smallest or $smallest_per_individual ) )};
 735       if( $global_largest ) {
 736         for( my $j = 0; $j <= $#columns; $j++ ) {
 737           my $label = defined $column_heads[$j] ? $column_heads[$j] : $columns[$j];
 738           if( not defined $diff_results{$label} or not defined $diff_results{$label}{'diff'} or
 739               $id_diffs{$columns[$j]}{'diff'} > $diff_results{$label}{'diff'} ) {
 740             $diff_results{$label}{'diff'} = $id_diffs{$columns[$j]}{'diff'};
 741             $diff_results{$label}{'self'} = $id_diffs{$columns[$j]}{'self'};
 742             $diff_results{$label}{'test'} = $id_diffs{$columns[$j]}{'test'};
 743           }
 744         }
 745       }
 746     }
 747   } else {
 748     die "data -> diff is only implemented for finding the largest difference at any observation at this point\n";
 749   }
 750 }
 751 end diff
 752 # }}} diff
 753
 754 # {{{ filename
 755 start filename
 756       {
 757         if ( defined $parm and $parm ne $self -> {'filename'} ) {
 758           $self -> {'filename'} = $parm;
 759           $self -> {'data_id'} = undef;
 760 #         $self -> _write;
 761         }
 762       }
 763 end filename
 764 # }}} filename
 765
 766 # {{{ fractions
 767
 768 start fractions
 769       {
 770         my %factors = $self -> factors( 'return_occurences' => 1,
 771                                         'unique_in_individual' => $unique_in_individual,
 772                                         'column_head' => $column_head,
 773                                         'column' => $column);
 774
 775         my $sum = 0;
 776         while (my ($factor, $amount) = each %factors) {
 777           if ( $factor == $self -> {'missing_data'} && $ignore_missing ) {
 778             next;
 779           } else {
 780             $sum += $amount;
 781           }
 782         }
 783         while (my ($factor, $amount) = each %factors) {
 784           if ( $factor == $self -> {'missing_data'} && $ignore_missing ) {
 785             next;
 786           } else {
 787             $fractions{$factor} = $amount/$sum;
 788           }
 789         }
 790       }
 791 end fractions
 792
 793 # }}} fractions
 794
 795 # {{{ factors
 796
 797 start factors
 798       {
 799         # Either column (number, starting at 1) or column_head must be specified.
 800         #
 801         # The default behaviour is to return a hash with the factors as keys
 802         # and as values references to arrays with the order numbers (not the ID numbers)
 803         # of the individuals that contain this factor
 804         #
 805         # If unique_in_individual is true (1), the returned hash will contain
 806         # an element with key 'Non-unique values found' and value 1 if any
 807         # individual contain more than one value in the specified column.
 808         #
 809         # Return occurences will calculate the occurence of each
 810         # factor value. Several occurences in one individual counts as
 811         # one occurence. The elements of the returned hash will have the factors
 812         # as keys and the number of occurences as values.
 813         #
 814
 815         $self -> synchronize;
 816
 817         # Check if $column(-index) is defined and valid, else try to find index
 818         # using column_head
 819         my $first_id = $self -> {'individuals'}[0];
 820
 821         debug -> die( message => "No individuals defined in data object based on ".
 822                       $self -> full_name ) unless ( defined $first_id );
 823
 824         my @data_row = split( /,/, $first_id -> subject_data -> [0] );
 825         unless ( defined $column && defined( $data_row[$column-1] ) ) {
 826           unless (defined($column_head) && defined($self -> {'column_head_indices'}{$column_head})) {
 827             debug -> die( message => "Error in data -> factors: unknown column: \"$column_head\" ".
 828                           "or invalid column number: \"$column\".\n".
 829                           "Valid column numbers are 1 to ".scalar @data_row ."\n".
 830                           "Valid column headers are (in no particular order):\n".
 831                           join(', ',keys(%{$self -> {'column_head_indices'}})) );
 832           } else {
 833             $column = $self -> {'column_head_indices'}{$column_head};
 834             debug -> warn( level   => 2,
 835                            message => "$column_head is in column number $column" );
 836           }
 837         }
 838
 839         my $key = 0;
 840         foreach my $individual ( @{$self -> {'individuals'}} ) {
 841           my @ifactors = keys %{$individual -> factors( column => $column )};
 842           if ( scalar @ifactors > 1 and $unique_in_individual ) {
 843             %factors = ( 'Non-unique values found' => 1 );
 844             last;
 845           }
 846           debug -> die( message => "No value found in column $column in individual ".
 847                         $individual -> idnumber ) if ( scalar @ifactors == 0 );
 848
 849           # Return occurences will calculate the occurence of each
 850           # factor value. Several occurences in one individual counts as
 851           # one occurence.
 852
 853           if ( $return_occurences ) {
 854             foreach my $ifactor ( @ifactors ) {
 855               $factors{$ifactor}++;
 856             }
 857           } else {
 858             foreach my $ifactor ( @ifactors ) {
 859               push( @{$factors{$ifactor}}, $key );
 860             }
 861           }
 862           $key++;
 863         }
 864       }
 865 end factors
 866
 867 # }}} factors
 868
 869 # {{{ find_individual
 870
 871 # start find_individual
 872 #         foreach my $tmp_ind ( @{$self -> individuals} ) {
 873 #         if ( $tmp_ind -> key == $key ) {
 874 #           $individual = $tmp_ind;
 875 #           last;
 876 #         }
 877 #       }
 878 #         if ( defined $individual ) {
 879 #         if ( $copy ) {
 880 #           $individual = $individual -> copy;
 881 #         }
 882 #       } else {
 883 #         print "No individual with key $key found in call to ".
 884 #           "data -> find_individual\n" if ( $self -> debug );
 885 #         }
 886 # end find_individual
 887
 888 # }}}
 889
 890 # {{{ format_data
 891
 892 start format_data
 893       {
 894         my $header = $self -> {'header'};
 895
 896         # format the data for NONMEM (simple comma-separated layout)
 897         if ( defined $self -> {'comment'} ) {
 898           my @comment   = @{$self -> {'comment'}};
 899           for ( @comment ) {
 900             push( @form_data );
 901           }
 902         }
 903
 904         my $wrap = ( defined $self -> {'wrap_column'} and
 905                      defined $self -> {'cont_column'} );
 906
 907         my @primary_columns = defined $self -> {'primary_columns'} ?
 908           @{$self -> {'primary_columns'}} : ();
 909         my @secondary_columns = defined $self -> {'secondary_columns'} ?
 910           @{$self -> {'secondary_columns'}} : ();
 911         if ( defined $header and defined $self -> {'ignoresign'} ) {
 912           my $istr;
 913           if ( $self -> {'ignoresign'} ne '@' ) {
 914             $istr = $self -> {'ignoresign'};
 915           }
 916           if ( $wrap ) {
 917             my @h_data;
 918             for ( my $i = 0; $i <= $#secondary_columns ; $i++ ) {
 919               my $sstr = $istr;
 920               for ( my $j = 0; $j < scalar @{$secondary_columns[$i]} ; $j++ ) {
 921                 my $jstr = $j == 0 ? '' : ',';
 922                 $sstr = $sstr.$jstr.$secondary_columns[$i][$j][0];
 923               }
 924               push( @h_data, $sstr."\n" );
 925             }
 926             push( @form_data, @h_data );
 927             my $pstr = $istr;
 928             for ( my $i = 0; $i <= $#primary_columns ; $i++ ) {
 929               my $jstr = $i == 0 ? '' : ',';
 930               $pstr = $pstr.$jstr.$primary_columns[$i][0];
 931             }
 932             push( @form_data, $pstr."\n" );
 933           } else {
 934             push( @form_data, $istr.join(',',@{$self -> {'header'}})."\n" );
 935           }
 936         }
 937         if ( $wrap ) {
 938           foreach my $individual ( @{$self -> {'individuals'}} ) {
 939             foreach my $row ( @{$individual -> subject_data} ) {
 940               my @r_data;
 941               for ( my $i = 0; $i <= $#secondary_columns ; $i++ ) {
 942                 my $sstr = '';
 943                 for ( my $j = 0; $j < scalar @{$secondary_columns[$i]} ; $j++ ) {
 944                   my $jstr = $j == 0 ? '' : ',';
 945                   if ( $secondary_columns[$i][$j][0] eq 'CONT' ) {
 946                     $sstr = $sstr.$jstr.'1';
 947                   } else {
 948                     my @data_row = split( /,/, $row );
 949                     $sstr = $sstr.$jstr.$data_row[$secondary_columns[$i][$j][1]];
 950                   }
 951                 }
 952                 push( @r_data, $sstr."\n" );
 953               }
 954               push( @form_data, @r_data );
 955               my $pstr = '';
 956               for ( my $i = 0; $i <= $#primary_columns ; $i++ ) {
 957                 my $jstr = $i == 0 ? '' : ',';
 958                 if ( $primary_columns[$i][0] eq 'CONT' ) {
 959                   $pstr = $pstr.$jstr.'0';
 960                 } else {
 961                   my @data_row = split( /,/, $row );
 962                   $pstr = $pstr.$jstr.$data_row[$primary_columns[$i][1]];
 963                 }
 964               }
 965               push( @form_data, $pstr."\n" );
 966             }
 967           }
 968         } else {
 969           foreach my $individual ( @{$self -> {'individuals'}} ) {
 970             foreach my $row ( @{$individual -> subject_data} ) {
 971               push( @form_data, $row ."\n" );
 972             }
 973           }
 974         }
 975       }
 976 end format_data
 977
 978 # }}} format_data
 979
 980 # {{{ drop_dropped
 981
 982 start drop_dropped
 983       {
 984         # This method removes columns that has '=DROP' value in the
 985         # model header as given by $INPUT. The model header must be
 986         # transfered to this method through the model_header
 987         # argument. The model_header argument should be a
 988         # two-dimensional array where each position in the first
 989         # dimension should be a reference to a 1*2 array holding the
 990         # column name and value. Any ignore-sign must be removed.
 991
 992         debug -> die( message => 'model header must be defined' )
 993           if ( $#model_header < 0 );
 994         # Important that the drop_dropped method of the model::problem
 995         # class is in sync with this method.
 996         $self -> synchronize;
 997
 998         $self -> {'header'} = [];
 999         my @drop;
1000         my $counter = 1;
1001         for( my $i = 0; $i <= $#model_header; $i++ ) {
1002           $self -> {'idcolumn'} = $counter if ( $model_header[$i][0] eq 'ID' );
1003           if( $model_header[$i][1] eq 'DROP' and
1004               not $model_header[$i][0] =~ /DAT(E|1|2|3)/ ) {
1005             push( @drop, 1 );
1006           } else {
1007             $counter++;
1008             push( @drop, 0 );
1009             push( @{$self -> {'header'}}, $model_header[$i][0] );
1010           }
1011         }
1012
1013         foreach my $individual ( @{$self -> {'individuals'}} ) {
1014           $individual -> drop_columns( drop => \@drop );
1015         }
1016
1017         $self -> {'synced'} = 0;
1018 #       $Data::Dumper::Maxdepth = 2;
1019 #       die Dumper $self;
1020 #       die Dumper $self -> {'individuals'};
1021       }
1022 end drop_dropped
1023
1024 # }}} drop_dropped
1025
1026 # {{{ wrap
1027 start wrap
1028       {
1029         $self -> synchronize;
1030         $self -> cont_column( $cont_column ) if ( defined $cont_column );
1031         $self -> wrap_column( $wrap_column ) if ( defined $wrap_column );
1032         $self -> prepare_wrap( model_header => \@model_header );
1033         @secondary_columns = @{$self -> {'secondary_columns'}}
1034           if ( defined $self -> {'secondary_columns'} );
1035         @primary_columns = @{$self -> {'primary_columns'}}
1036           if ( defined $self -> {'primary_columns'} );
1037       }
1038 end wrap
1039 # }}} wrap
1040
1041 # {{{ unwrap
1042 start unwrap
1043       {
1044         $self -> {'cont_column'} = undef;
1045         $self -> {'wrap_column'} = undef;
1046         $self -> {'secondary_columns'} = undef;
1047         $self -> {'primary_columns'} = undef;
1048       }
1049 end unwrap
1050 # }}} unwrap
1051
1052 # {{{ prepare_wrap
1053
1054 start prepare_wrap
1055       {
1056         my $cont_column = $self -> {'cont_column'};
1057         my $wrap_column = $self -> {'wrap_column'};
1058         debug -> die( message => 'cont_column ('.$cont_column.') must be less or equal '.
1059                       'to the requested number of columns in each row ('.
1060                       ($wrap_column).')' )
1061           if ( $cont_column > $wrap_column );
1062         my @header;
1063         if ( scalar @model_header > 0 ) {
1064           @header = @model_header;
1065         } else {
1066           @header = @{$self -> {'header'}};
1067         }
1068
1069         my ( @primary, @secondary, @date_columns );
1070
1071         for ( my $i = 0; $i <= $#header; $i++ ) {
1072           my $name  = ref( $header[$i] ) eq 'ARRAY' ? $header[$i][0] : $header[$i];
1073           my $value = ref( $header[$i] ) eq 'ARRAY' ? $header[$i][1] : undef;
1074           next if ( $name eq 'ID' );
1075           my $found = 0;
1076           foreach my $prim ( @primary_column_names ) {
1077             if ( not $found and
1078                  ( $name eq $prim or $value eq $prim ) ) {
1079               push( @primary, [$name, $i, $value] );
1080               $found = 1;
1081               my $col = ($#primary+2)>= $cont_column ? ($#primary+3) : ($#primary+2);
1082               push( @date_columns, $col ) if ( $name =~ /DAT(E|1|2|3)/ );
1083             }
1084           }
1085           push( @secondary, [$name, $i, $value] ) if ( not $found );
1086         }
1087
1088         my $prim_num = scalar @primary;
1089         debug -> die( message => 'The number of primary columns (that need to '.
1090                       'be part of the row with CONT=0) ('.($prim_num+1).
1091                       ') is larger than the required number of columns (wrap_column='.
1092                       $wrap_column.') - 1' )
1093           if ( scalar $prim_num > ($wrap_column-2) );
1094
1095         my ( $i, $dum ) = ( 0, 1 );
1096         my @tmp;
1097         for ( my $j = 1; $j <= $wrap_column; $j++ ) {
1098           if( $j == 1 ) {
1099             push( @tmp, ['ID', $self -> {'idcolumn'}-1] );
1100           } elsif ( $j == $wrap_column ) {
1101             if ( $j == $cont_column ) {
1102               push( @tmp, ['CONT', undef] );
1103             } else {
1104               my $val;
1105               if ( defined $primary[$i] ) {
1106                 $val = $primary[$i];
1107               } elsif ( defined $secondary[0] ) {
1108                 $val = shift(@secondary);
1109               } else {
1110                 $val = ['XX'.$dum++,$self -> {'idcolumn'}-1];
1111               }
1112               push( @tmp, $val );
1113               $i++;
1114             }
1115             push( @{$self -> {'primary_columns'}}, @tmp );
1116           } else {
1117             if ( $j == $cont_column ) {
1118               push( @tmp, ['CONT', undef] );
1119             } else {
1120               if ( $i <= $#primary ) {
1121                 push( @tmp, $primary[$i] );
1122                 $i++;
1123               } else {
1124                 my $val = defined $secondary[0] ? shift(@secondary) :
1125                   ['XX'.$dum++,$self -> {'idcolumn'}-1];
1126                 push( @tmp, $val );
1127               }
1128             }
1129           }
1130         }
1131
1132         my $i = 0;
1133         while ( $i <= $#secondary ) {
1134           my @tmp;
1135           for ( my $j = 1; $j <= $wrap_column; $j++ ) {
1136             if( $j == 1 ) {
1137               push( @tmp, ['ID', $self -> {'idcolumn'}-1] );
1138             } elsif ( $j == $wrap_column ) {
1139               if ( $j == $cont_column ) {
1140                 push( @tmp, ['CONT', undef] );
1141               } else {
1142                 my $val = defined $secondary[$i] ? $secondary[$i] :
1143                   ['XX'.$dum++,$self -> {'idcolumn'}-1];
1144                 push( @tmp, $val );
1145                 $i++;
1146               }
1147               unshift( @{$self -> {'secondary_columns'}}, \@tmp );
1148             } else {
1149               if ( $j == $cont_column ) {
1150                 push( @tmp, ['CONT', undef] );
1151               } else {
1152                 my $isdate = 0;
1153                 if ( $#date_columns >= 0 ) {
1154                   foreach my $col ( @date_columns ) {
1155                     # This is a date column which may have to be dropped
1156                     # and thus will not appear as a secondary
1157                     # column. Nothing should be pushed. The indexes in
1158                     # model::problem::pk::_format_record will be ok.
1159                     $isdate = 1 if ( $col == $j ) ;
1160                   }
1161                 }
1162                 if ( $isdate ) {
1163                   push( @tmp, ['XX'.$dum++,$self -> {'idcolumn'}-1] );
1164                 } else {
1165                   if ( $i <= $#secondary ) {
1166                     push( @tmp, $secondary[$i] );
1167                     $i++;
1168                   } else {
1169                     push( @tmp, ['XX'.$dum++,$self -> {'idcolumn'}-1] );
1170                   }
1171                 }
1172               }
1173             }
1174           }
1175         }
1176       }
1177 end prepare_wrap
1178
1179 # }}} prepare_wrap
1180
1181 # {{{ have_missing_data
1182 start have_missing_data
1183       {
1184         # Either I<column> or I<column_head> must be specified.
1185         #
1186         # This method looks through the data column with index I<column> or
1187         # (optional) header name I<column_head> and returns O if no missing
1188         # data indicator was found or 1 otherwise.
1189
1190         $self -> synchronize;
1191         my $first_id = $self -> {'individuals'}[0];
1192         debug -> die( message => "No individuals defined in data object based on ".
1193                       $self -> full_name ) unless ( defined $first_id );
1194         my @data_row = split( /,/ , $first_id -> subject_data -> [0] );
1195         unless ( defined $column  && defined( $data_row[$column-1] ) ) {
1196           unless(defined($column_head) && defined($self -> {'column_head_indices'}{$column_head})){
1197             die "Error in data -> have_missing_data: unknown column: \"$column_head\" or invalid column number: \"$column\"\n";
1198           } else {
1199             $column = $self -> {'column_head_indices'}{$column_head};
1200           }
1201         }
1202         $self -> flush if ( $self -> {'target'} eq 'disk' );
1203
1204         # In case anyone wonders, the ternary statment ( bool ? true :
1205         # false ) below will possibly make a minuscle memory
1206         # optimization. But hey, why not :)
1207
1208         $return_value = defined $self -> {'have_missing_data'} ? $self -> {'have_missing_data'} -> {$column} : 0;
1209       }
1210 end have_missing_data
1211 # }}} have_missing_data
1212
1213 # {{{ merge
1214 start merge
1215       {
1216         #$self -> synchronize;
1217         push( @{$self -> {'individuals'}}, @{$mergeobj -> individuals} );
1218       }
1219 end merge
1220 # }}} merge
1221
1222 # {{{ max
1223
1224 start max
1225       {
1226         # Either column or column_head must be specified. Column_head must be a string that
1227         # identifies a column in the (optional ) data file header.
1228
1229 # The if-statement below used to be a cache of allready calculated
1230 # means. But since individuals can be accessed in so many ways, we
1231 # don't know when this cache should be updated. Its easier to
1232 # recalculate the max. Maybe we can include this optimization in the
1233 # future, if it turns out to be a bottleneck
1234 #       my $tmp_column = $self -> {'column_head_indices'}{$column_head};
1235 #       if ( defined $self -> {'max'}[$tmp_column] ) {
1236 #         $return_value = $self -> {'max'}[$tmp_column] ;
1237 #       } else {
1238           $self -> synchronize;
1239           my $first_id = $self -> {'individuals'}[0];
1240           debug -> die( message => "data -> max: No individuals defined in data object based on " .
1241                         $self -> full_name ) unless defined $first_id;
1242
1243           my @data_row = split( /,/ , $first_id -> subject_data ->[0] );
1244
1245           unless ( defined $column  && defined( $data_row[$column-1] ) ) {
1246             unless (defined($column_head) && defined($self -> {'column_head_indices'}{$column_head})) {
1247               die "Error in data -> max: unknown column: \"$column_head\" or invalid column number: \"$column\"\n";
1248             } else {
1249               $column = $self -> {'column_head_indices'}{$column_head};
1250             }
1251           }
1252           foreach my $individual ( @{$self -> {'individuals'}} ) {
1253             my $ifactors = $individual -> factors( 'column' => $column );
1254             foreach ( keys %{$ifactors} ) {
1255               next if ( $_ == $self -> {'missing_data_token'} );
1256               if ( defined ($return_value) ) {
1257                 $return_value = $_ > $return_value ? $_ : $return_value;
1258               } else {
1259                 $return_value = $_;
1260               }
1261             }
1262           }
1263
1264 #         $self -> {'max'}[$column] = $return_value;
1265           $self -> flush if ( $self -> {'target'} eq 'disk' );
1266 #       }
1267       }
1268 end max
1269
1270 # }}} max
1271
1272 # {{{ min
1273
1274 start min
1275       {
1276         # See L</max>.
1277         my $tmp_column = $self -> {'column_head_indices'}{$column_head};
1278
1279 # The if-statement below used to be a cache of allready calculated
1280 # means. But since individuals can be accessed in so many ways, we
1281 # don't know when this cache should be updated. Its easier to
1282 # recalculate the min. Maybe we can include this optimization in the
1283 # future, if it turns out to be a bottleneck
1284 #       if ( defined $self -> {'min'}[$tmp_column] ) {
1285 #         $return_value = $self -> {'min'}[$tmp_column] ;
1286 #       } else {
1287           $self -> synchronize;
1288           my $first_id = $self -> {'individuals'}[0];
1289           die "data -> min: No individuals defined in data object based on ",
1290             $self -> full_name,"\n" unless defined $first_id;
1291
1292           my @data_row = split( /,/ , $first_id -> subject_data ->[0] );
1293
1294           unless ( defined $column  && defined( $data_row[$column-1] ) ) {
1295             unless (defined($column_head) && defined($self -> {'column_head_indices'}{$column_head})) {
1296               die "Error in data -> min: unknown column: \"$column_head\" or invalid column number: \"$column\"\n";
1297             } else {
1298               $column = $self -> {'column_head_indices'}{$column_head};
1299             }
1300           }
1301           foreach my $individual ( @{$self -> {'individuals'}} ) {
1302             my $ifactors = $individual -> factors( 'column' => $column );
1303             foreach ( keys %{$ifactors} ) {
1304               next if ( $_ == $self -> {'missing_data_token'} );
1305               if ( defined ($return_value) ) {
1306                 $return_value = $_ < $return_value ? $_ : $return_value;
1307               } else {
1308                 $return_value = $_;
1309               }
1310             }
1311           }
1312 #         $self -> {'min'}[$column] = $return_value;
1313           $self -> flush if ( $self -> {'target'} eq 'disk' );
1314 #       }
1315       }
1316 end min
1317
1318 # }}} min
1319
1320 # {{{ median
1321
1322 start median
1323       {
1324           # See L</max>.
1325         $self -> synchronize;
1326         my $first_id = $self -> {'individuals'}[0];
1327         die "data -> median: No individuals defined in data object based on ",
1328           $self -> full_name,"\n" unless defined $first_id;
1329
1330         my @data_row = split( /,/ , $first_id -> subject_data ->[0] );
1331
1332         unless ( defined $column  && defined( $data_row[$column-1] ) ) {
1333           unless(defined($column_head) && defined($self -> {'column_head_indices'}{$column_head})){
1334             die "Error in data -> median: unknown column: \"$column_head\" or invalid column number: \"$column\"\n";
1335           } else {
1336             $column = $self -> {'column_head_indices'}{$column_head};
1337           }
1338         }
1339
1340         if( defined $self -> {'median'}[$column] ){
1341           return $self -> {'median'}[$column];
1342         }
1343
1344         my @median_array;
1345
1346         foreach my $individual ( @{$self -> {'individuals'}} ) {
1347           if( $unique_in_individual ){
1348             my $ifactors = $individual -> factors( 'column' => $column );
1349
1350             foreach ( keys %{$ifactors} ) {
1351               next if ( $_ == $self -> {'missing_data_token'} );
1352               push( @median_array, $_ );
1353             }
1354           } else {
1355             my $ifactors = $individual -> subject_data;
1356
1357             for(my $i=0; $i<=$#{$ifactors}; $i++ ) {
1358               my @data_row = split( /,/ , $ifactors -> [$i] );
1359               next if ( $data_row[$column-1] == $self -> {'missing_data_token'} );
1360               push(@median_array, $data_row[$column-1]);
1361             }
1362           }
1363         }
1364         @median_array = sort {$a <=> $b} @median_array ;
1365
1366         if( @median_array % 2 ){
1367           $return_value = $median_array[$#median_array / 2];
1368         } else {
1369           $return_value = ( $median_array[@median_array / 2] +
1370                             $median_array[(@median_array - 2) / 2] ) / 2;
1371         }
1372
1373         $self -> {'median'}[$column] = $return_value;
1374       }
1375 end median
1376
1377 # }}} median
1378
1379 # {{{ mean
1380
1381 start mean
1382   {
1383      # Returns mean value of a column
1384      # If a individual contains more then 1 value (i.e. if an
1385      # individual has different values in different samples a mean
1386      # value of all individuals if calculate first, then the mean
1387      # value of the column If hi_cutoff is defined the mean function
1388      # will cut all value below the cutoff, and set their value to
1389      # 0. It's used to calculate the HI-mean/LOW-mean of a column for
1390      # e.g. Hockey-stick covariates If both hi_cutoff and low_cutoff
1391      # are defined only the hi_cutoff will be used.  See L</max>.
1392      my $tmp_column = $self -> {'column_head_indices'}{$column_head};
1393      $self -> synchronize;
1394      my $first_id = $self -> {'individuals'}[0];
1395        die "data -> mean: No individuals defined in data object based on ",
1396         $self -> full_name,"\n" unless defined $first_id;
1397
1398      my @data_row = split( /,/, $first_id -> subject_data ->[0] );
1399
1400      unless ( defined $column  && defined( $data_row[$column-1] ) ) {
1401        unless (defined($column_head) && defined($self -> {'column_head_indices'}{$column_head})) {
1402          die "Error in data -> mean: unknown column: \"$column_head\" or invalid column number: \"$column\"\n";
1403        } else {
1404               $column = $self -> {'column_head_indices'}{$column_head};
1405          }
1406      }
1407
1408         ## Here the calculation starts
1409         my $num_individuals = 0;
1410         my $sum = 0;
1411
1412      my $all_data_rows=0;
1413         foreach my $individual ( @{$self ->{'individuals'}} ) {
1414
1415           my $ifactors = $individual -> subject_data;
1416           my $individual_sum = 0;
1417           my $data_rows = 0;
1418           for(my $i=0; $i<=$#{$ifactors}; $i++ ) {
1419
1420             # data is stored in strings. We need to split them into an
1421             # array.
1422
1423             my @data_row = split( /,/, $ifactors -> [$i] );
1424             if ( $data_row[$column-1] == $self -> {'missing_data_token'} ) {
1425 #             print "Skipping row with missing data\n";
1426               next;
1427             }
1428
1429             if( defined $subset_column and not eval ( $data_row[$subset_column-1].$subset_syntax ) ) {
1430 #             print "Skipping row outside subset: syntax: ".($subset_column-1)." $subset_syntax\n";
1431               next;
1432             }
1433
1434             if (defined $hi_cutoff) {
1435               if ($data_row[$column-1]>$hi_cutoff) {
1436                 $individual_sum += $data_row[$column-1]-$hi_cutoff;
1437               }
1438             }
1439             else {
1440               if (defined $low_cutoff) {
1441                 if ($data_row[$column-1]<$low_cutoff) {
1442                   $individual_sum += $low_cutoff - $data_row[$column-1];
1443                 }
1444               }
1445               else {
1446                 $individual_sum += $data_row[$column-1];
1447               }
1448             }
1449             $data_rows++;
1450           }
1451           if( $global_mean ) {
1452             $sum += $individual_sum;
1453             $num_individuals += $data_rows;
1454           } else {
1455             if( $data_rows != 0 ) {
1456               $sum += $individual_sum/$data_rows;
1457             }
1458             $num_individuals ++;
1459           }
1460           $all_data_rows += $data_rows;
1461         }
1462      if( $num_individuals != 0 ) {
1463        $return_value = $sum / $num_individuals;
1464      }
1465 #     print "DR: $all_data_rows\n";
1466 #     print "\nNIM: $num_individuals $return_value\n";
1467 }
1468
1469 end mean
1470
1471 # }}} mean
1472
1473 # {{{ sd
1474
1475 start sd
1476   {
1477     # This sub returns standard deviation for a specific column
1478     # If there are more than one sample/individual the value used for that specific
1479     # individual is the mean value of its samples.
1480     # The cut-offs are for hockey stick variables. I.e. If one individual value is
1481     # lower than the hi-cutoff the individual value will be zero.
1482     # HI_cutoff is used to calculate the HI-mean of a column.
1483     # If cut_off is undef it won't be used
1484     # See L</max>.
1485      my $tmp_column = $self -> {'column_head_indices'}{$column_head};
1486      $self -> synchronize;
1487      my $first_id = $self -> {'individuals'}[0];
1488      debug -> die( message => "No individuals defined in data object based on ".
1489                    $self -> full_name ) unless defined $first_id;
1490
1491      my @data_row = split( /,/ , $first_id -> subject_data ->[0] );
1492
1493      unless ( defined $column  && defined( $data_row[$column-1] ) ) {
1494        unless (defined($column_head) && defined($self -> {'column_head_indices'}{$column_head})) {
1495          debug -> die( message => "Unknown column: \"$column_head\" or "
1496                        ."invalid column number: \"$column\"" );
1497        } else {
1498          $column = $self -> {'column_head_indices'}{$column_head};
1499        }
1500      }
1501
1502      ## Here the calculation starts
1503      my $num_individuals = 0;
1504      my $sum = 0;
1505      my $mean;
1506      if (defined $hi_cutoff) {
1507        $mean = $self->mean(column   => $column,
1508                            hi_cutoff => $hi_cutoff,
1509                            global_mean => $global_sd );
1510      } elsif (defined $low_cutoff) {
1511        $mean = $self->mean(column   => $column,
1512                            low_cutoff => $low_cutoff,
1513                            global_mean => $global_sd );
1514      } else {
1515        $mean = $self->mean( column        => $column,
1516                             subset_column => $subset_column,
1517                             subset_syntax => $subset_syntax,
1518                             global_mean => $global_sd );
1519      }
1520
1521      foreach my $individual ( @{$self -> {'individuals'}} ) {
1522        my $ifactors = $individual -> subject_data;
1523        my $individual_sum = 0;
1524        my $data_rows = 0;
1525        for(my $i=0; $i<=$#{$ifactors}; $i++ ) {
1526
1527          # data is stored in strings. We need to split them into an
1528          # array.
1529
1530          my @data_row = split( /,/, $ifactors -> [$i] );
1531
1532          if ( $data_row[$column-1] == $self -> {'missing_data_token'} ) {
1533 #          print "Skipping row with missing data\n";
1534            next;
1535          }
1536
1537          if( defined $subset_column and not eval ( $data_row[$subset_column-1].$subset_syntax ) ) {
1538 #          print "Skipping row outside subset: syntax: ".($subset_column-1)." $subset_syntax\n";
1539            next;
1540          }
1541
1542          if (defined $hi_cutoff) {
1543            if ($data_row[$column-1]>$hi_cutoff) {
1544              if( $global_sd ) {
1545                $individual_sum += ($data_row[$column-1] - $hi_cutoff - $mean) ** 2;
1546              } else {
1547                $individual_sum += $data_row[$column-1]-$hi_cutoff;
1548              }
1549            }
1550          } else {
1551            if (defined $low_cutoff) {
1552              if ($data_row[$column-1]<$low_cutoff) {
1553                if( $global_sd ) {
1554                  $individual_sum += ($low_cutoff - $data_row[$column-1] - $mean) ** 2;
1555                } else {
1556                  $individual_sum += $low_cutoff - $data_row[$column-1];
1557                }
1558              }
1559            } else {
1560              if( $global_sd ) {
1561                $individual_sum += ($data_row[$column-1] - $mean) ** 2;
1562              } else {
1563                $individual_sum += $data_row[$column-1];
1564              }
1565            }
1566          }
1567          $data_rows++;
1568        }
1569        if( $global_sd ) {
1570          $sum += $individual_sum;
1571          $num_individuals += $data_rows;
1572        } else {
1573          if( $data_rows != 0 ) {
1574            $sum += ($individual_sum/$data_rows - $mean) ** 2;
1575          }
1576          $num_individuals++;
1577        }
1578      }
1579      if( $num_individuals < 2 ) {
1580        $return_value = 0;
1581      } else {
1582        if( $num_individuals != 0 ) {
1583          $return_value = (1/($num_individuals-1)*$sum) ** 0.5;
1584        }
1585      }
1586    }
1587
1588 end sd
1589
1590 # }}} sd
1591
1592 # {{{ range
1593 start range
1594       {
1595         # See L</max>.
1596         my $tmp_column = $self -> {'column_head_indices'}{$column_head};
1597         if ( defined $self -> {'range'}[$tmp_column] ) {
1598           $return_value = $self -> {'range'}[$tmp_column];
1599         } else {
1600           my $old_target = $self -> {'target'};
1601           $self -> {'target'} = 'mem';
1602           $self -> synchronize;
1603           $return_value = $self -> max( column      => $column,
1604                                         column_head => $column_head ) -
1605                                           $self -> min( column      => $column,
1606                                                         column_head => $column_head );
1607           $self -> {'range'}[$column] = $return_value;
1608           if ( $old_target eq 'disk' ) {
1609             $self -> flush if ( $self -> {'target'} eq 'disk' );
1610             $self -> {'target'} = 'disk';
1611           }
1612         }
1613       }
1614 end range
1615 # }}} range
1616
1617 # {{{ recalc_column
1618 start recalc_column
1619       {
1620           # Recalculates a column based on expression. Also, see L</max>.
1621         $self -> synchronize;
1622
1623         # Check if $column(-index) is defined and valid, else try to find index using column_head
1624         my $first_id = $self -> {'individuals'}[0];
1625         die "data -> recalc_column: No individuals defined in data object based on ",
1626           $self -> full_name,"\n" unless defined $first_id;
1627
1628         my @data_row = split( /,/ , $first_id -> subject_data ->[0] );
1629
1630         unless ( defined $column  && defined( $data_row[$column-1] ) ) {
1631           if(defined($column_head) && defined($self -> {'column_head_indices'}{$column_head})){
1632             die "Error in data -> recalc_column: unknown column: \"$column_head\" or column number: \"$column\"\n";
1633           } else {
1634             $column = $self -> {'column_head_indices'}{$column_head};
1635           }
1636         }
1637
1638         for my $individual ( @{$self -> {'individuals'}} ) {
1639           $individual -> recalc_column( column     => $column,
1640                                         expression => $expression );
1641         }
1642       }
1643 end recalc_column
1644 # }}} recalc_column
1645
1646 # {{{ renumber_ascending
1647
1648 start renumber_ascending
1649       {
1650 # Renumbers the individuals (changes the subject identifiers) so that
1651 # all have unique integer numbers starting with start_at and
1652 # ascending. The primary use of this
1653 # method is not to order the individuals after their identifiers but to
1654 # ensure that all individuals have unique identifiers.
1655
1656         $self -> synchronize;
1657         foreach my $individual ( @{$self -> {'individuals'}} ) {
1658           $individual -> idnumber ( $start_at++ );
1659         }
1660         $self -> {'synced'} = 0;
1661       }
1662 end renumber_ascending
1663
1664 # }}} renumber_ascending
1665
1666 # {{{ renumber_descending
1667
1668 start renumber_descending
1669       {
1670           # See L</renumber_ascending>.
1671         $self -> synchronize;
1672         foreach my $individual ( @{$self -> {'individuals'}} ) {
1673           $individual -> idnumber ( $start_at-- );
1674         }
1675         $self -> {'synced'} = 0;
1676       }
1677 end renumber_descending
1678
1679 # }}} renumber_descending
1680
1681 # {{{ single_valued_data
1682
1683 start single_valued_data
1684       {
1685         # Usage:
1686         #
1687         # ($single_value_data_set, $remainder, $column_indexes) =
1688         #      $data_object -> single_valued_data( subset_name         => 'subset.dta',
1689         #                                          remainder_name      => 'remainder.dta',
1690         #                                          target              => 'disk',
1691         #                                          do_not_test_columns => [1..18,24,26];
1692         #
1693         # my $single_value_column_indexes = $column_indexes -> [0];
1694         # my $all_other_column_indexes    = $column_indexes -> [1];
1695         #
1696         # Analyses the content of each column, based on the
1697         # ID column, and returns two new data objects: One
1698         # that contains all columns that is has only one value per
1699         # individual and one that contains the
1700         # remainding data. This is useful for creating compact 'extra'
1701         # data sets that can be read in via user-defined sub-routines
1702         # when the number of columns needed exceeds the maximum that
1703         # NONMEM allows (e.g. 20 in NONMEM version V).
1704         #
1705         # The I<do_not_test_columns> argument specifies on which columns
1706         # to skip the single value test
1707
1708         my @multi_value_flags;
1709         my @individuals = @{$self -> {'individuals'}};
1710         # Initiate the flags:
1711         if ( defined $individuals[0] ) {
1712           my @data = @{$individuals[0] -> {'subject_data'}};
1713           my @data_row = split( /,/ , $data[0] );
1714           for ( my $i = 0; $i < scalar @data_row; $i++ ) {
1715             my $dnt_flag = 0;
1716             foreach my $dntc ( @do_not_test_columns ) {
1717               $dnt_flag = 1 if ( $i == $dntc - 1 );
1718             }
1719             $multi_value_flags[$i] = $dnt_flag;
1720           }
1721         } else {
1722           die "data -> single_valued_data: No data in ID number 1\n";
1723         }
1724         # Collect the stats
1725         for ( my $id = 0; $id <= $#individuals; $id++ ) {
1726           my @data = @{$individuals[$id] -> {'subject_data'}};
1727           my @data_row = split( /,/, $data[0] );
1728           for ( my $j = 0; $j < scalar @data_row; $j++ ) {
1729             my %col_unique;
1730             for ( my $i = 0; $i <= $#data; $i++ ) {
1731               my @data_row = split( /,/ , $data[$i] );
1732               $col_unique{$data_row[$j]}++;
1733             }
1734             my $factors = scalar keys %col_unique;
1735             $multi_value_flags[$j]++ if ( $factors > 1 );
1736           }
1737         }
1738         for ( my $i = 0; $i <= $#multi_value_flags; $i++ ) {
1739           if ( $multi_value_flags[$i] ) {
1740             push ( @{$column_indexes[1]}, $i + 1);
1741           } else {
1742             push ( @{$column_indexes[0]}, $i + 1);
1743           }
1744         }
1745         ( $single_value_data_set, $remainder ) =
1746           $self -> subset_vertically( column_indexes      => $column_indexes[0],
1747                                       subset_name         => $subset_name,
1748                                       return_remainder    => 1,
1749                                       remainder_name      => $remainder_name,
1750                                       target              => $target,
1751                                       keep_first_row_only => 1);
1752       }
1753 end single_valued_data
1754
1755 # }}}
1756
1757 # {{{ subset_vertically
1758
1759 start subset_vertically
1760       {
1761         # Usage:
1762         #
1763         # $subset = $data_object -> subset_vertically ( column_indexes => [1,2,6],
1764         #                                               subset_name    => 'subset.dta' );
1765         #
1766         # This basic usage returns a new data object containing
1767         # columns 1,2 and 6 from the original data plus the
1768         # idcolumn. The new data object will be associated with the
1769         # file 'subset.dta'.
1770         #
1771         # You get the remaining data, i.e. the original data minus
1772         # the created subset by specifying
1773         #
1774         # ( $subset, $remainder ) =
1775         #      $data_object -> subset_vertically ( column_indexes   => [1,2,6],
1776         #                                          subset_name      => 'subset.dta',
1777         #                                          return_remainder => 1,
1778         #                                          remainder_name   => 'remainder.dta' );
1779         #
1780         # If you would like to flush the created data sets to disk and
1781         # save memory, set the I<target> argument to 'disk'. The
1782         # default value 'mem' will keep the whole data object in RAM.
1783         #
1784         # The I<keep_first_row_only> argument can be used to reduce
1785         # the size of the subset data obejct by excluding all but the
1786         # first row of data from each individual.
1787         #
1788         my @individuals = @{$self -> {'individuals'}};
1789         # Create remainder index array if necessary
1790         my @remainder_indexes;
1791         if ( defined $individuals[0] ) {
1792           my @data = @{$individuals[0] -> {'subject_data'}};
1793           my $idcolumn = $individuals[0] -> {'idcolumn'};
1794 #         print "IC: $idcolumn\n";
1795           my $id_flag = 0;
1796           foreach my $use_index ( @column_indexes ) {
1797             $id_flag = 1 if ( $use_index == $idcolumn );
1798           }
1799           if ( $return_remainder ) {
1800 #           @remainder_indexes = ( $idcolumn );
1801             for ( my $i = 0; $i < scalar split(/,/,$data[0]); $i++ ) {
1802               my $rem_flag = 1;
1803               foreach my $use_index ( @column_indexes ) {
1804                 $rem_flag = 0 if ( $i == $use_index -1 );
1805 # or
1806 #                                  $i == $idcolumn -1 );
1807               }
1808               push( @remainder_indexes, $i + 1 ) if ( $rem_flag );
1809             }
1810             unshift( @remainder_indexes, $idcolumn ) if ( $id_flag );
1811           }
1812           unshift( @column_indexes, $idcolumn ) unless ( $id_flag );
1813         } else {
1814           die "data -> single_valued_data: No data in ID number 1\n";
1815         }
1816
1817 #       print "SS: @column_indexes\n";
1818 #       print "R : @remainder_indexes\n";
1819
1820         my @new_ids;
1821         my @new_ids_2;
1822         for ( my $id = 0; $id <= $#individuals; $id++ ) {
1823           my $idnumber = $individuals[$id] -> idnumber;
1824           my $idcolumn = $individuals[$id] -> idcolumn;
1825           my @data = @{$individuals[$id] -> {'subject_data'}};
1826           my @new_data;
1827           my @new_data_2;
1828           my $use_rows = $keep_first_row_only ? 0 : $#data;
1829           for ( my $i = 0; $i <= $use_rows; $i++ ) {
1830             my @new_row;
1831             my @data_row = split( /,/, $data[$i] );
1832             foreach my $use_index ( @column_indexes ) {
1833               push( @new_row, $data_row[$use_index-1] );
1834             }
1835 #           print "@new_row $#new_row\n";
1836             push( @new_data, join( ',', @new_row ) );
1837           }
1838           for ( my $i = 0; $i <= $#data; $i++ ) {
1839             if ( $return_remainder ) {
1840               my @new_row_2;
1841               my @data_row = split( /,/, $data[$i] );
1842               foreach my $use_index ( @remainder_indexes ) {
1843                 push( @new_row_2, $data_row[$use_index-1] );
1844               }
1845 #             print "@new_row_2 $#new_row_2\n";
1846               push( @new_data_2, join( ',' , @new_row_2 ) );
1847             }
1848           }
1849           my $new_id = data::individual -> new( idnumber     => $idnumber,
1850                                                 idcolumn     => $idcolumn,
1851                                                 subject_data => \@new_data );
1852           push( @new_ids, $new_id );
1853           if ( $return_remainder ) {
1854             my $new_id_2;
1855             $new_id_2 = data::individual -> new( idnumber     => $idnumber,
1856                                                  idcolumn     => $idcolumn,
1857                                                  subject_data => \@new_data_2 );
1858           push( @new_ids_2, $new_id_2 );
1859           }
1860         }
1861         my @header = @{$self -> {'header'}};
1862         my @new_header;
1863         foreach my $use_index ( @column_indexes ) {
1864           push( @new_header, @header[$use_index-1] );
1865         }
1866         my $comment;
1867         if( defined $self -> {'comment'} ){
1868           my @comment = @{$self -> {'comment'}};
1869           $comment = \@comment;
1870         }
1871         $subset = data -> new ( filename             => $subset_name,
1872                                 directory            => $self -> {'directory'},
1873                                 ignoresign           => $self -> {'ignoresign'},
1874                                 header               => \@new_header,
1875                                 comment              => $comment,
1876                                 individuals          => \@new_ids,
1877                                 target               => $target,
1878                                 ignore_missing_files => 1 );
1879         if ( $return_remainder ) {
1880           my @new_header_2;
1881           foreach my $use_index ( @remainder_indexes ) {
1882             push( @new_header_2, @header[$use_index-1] );
1883           }
1884           $remainder = data -> new ( filename             => $remainder_name,
1885                                      directory            => $self -> {'directory'},
1886                                      ignoresign           => $self -> {'ignoresign'},
1887                                      header               => \@new_header_2,
1888                                      comment              => $comment,
1889                                      individuals          => \@new_ids_2,
1890                                      target               => $target,
1891                                      ignore_missing_files => 1 );
1892         }
1893       }
1894 end subset_vertically
1895
1896 # }}}
1897
1898 # {{{ subsets
1899
1900 start subsets
1901       {
1902 #       if ( defined $expression and defined $bins ) {
1903 #         die "data -> subset: expression and bins may not both be specified\n";
1904 #       }
1905 #       if ( not ( defined $expression or defined $bins ) ) {
1906 #         die "data -> subset: expression or bins must be specified\n";
1907 #       }
1908         $self -> synchronize;
1909         my @header  = @{$self -> {'header'}};
1910         my @comment = defined $self -> {'comment'} ? @{$self -> {'comment'}} : ();
1911         my @subset_ids= ();
1912         my %rnd_ids;
1913         my $key = 0;
1914         my @ids = @{$self -> {'individuals'}};
1915         if ( defined $stratify_on ) {
1916           my $work_data = $self -> copy( filename => 'work_data.dta',
1917                                          target   => 'mem' );
1918           my %strata = %{$work_data -> factors( column => $stratify_on )};
1919 #         $Data::Dumper::Maxdepth = 1;
1920 #         print Dumper \%strata;
1921
1922           while ( my ( $factor, $keys ) = each %strata ) {
1923               foreach my $key ( @{$keys} ) {
1924                   my $rnd_num = rand;
1925                   while ( defined $rnd_ids{$factor}{$rnd_num} ) {
1926                       $rnd_num = rand;
1927                   }
1928                   $rnd_ids{$factor}{$rnd_num} = $ids[$key];
1929               }
1930           }
1931           my $first = 1;
1932           while ( my ( $factor, $rnd_nums ) = each %rnd_ids ) {
1933               my @sort_rnd_nums = sort { $a <=> $b } keys %{$rnd_nums};
1934               for ( my $i = 0; $i <= $#sort_rnd_nums; $i ) {
1935                   for ( my $j = 0; $j < $bins; $j++ ) {
1936                       if ( $first ) {
1937                           push( @subset_ids, [$rnd_ids{$factor}{$sort_rnd_nums[$i]} -> copy] );
1938                           push( @incl_ids, [$rnd_ids{$factor}{$sort_rnd_nums[$i]} -> idnumber] );
1939                       } else {
1940                           push( @{$subset_ids[$j]}, $rnd_ids{$factor}{$sort_rnd_nums[$i]} -> copy );
1941                           push( @{$incl_ids[$j]}, $rnd_ids{$factor}{$sort_rnd_nums[$i]} -> idnumber );
1942                       }
1943                       $i++;
1944                       last if $i > $#sort_rnd_nums;
1945                   }
1946                   $first = 0;
1947               }
1948           }
1949           for ( my $j = 0; $j < $bins; $j++ ) {
1950             my $sdata = data -> new ( header               => \@header,
1951                                       comment              => \@comment,
1952                                       ignoresign           => $self -> {'ignoresign'},
1953                                       individuals          => $subset_ids[$j],
1954                                       ignore_missing_files => 1,
1955                                       target               => 'disk',
1956                                       idcolumn             => $self -> {'idcolumn'},
1957                                       filename             => "subset_$j.dta" );
1958             #$sdata -> _write;
1959             push( @subsets, $sdata );
1960           }
1961         } else {
1962           for ( my $i = 0; $i <= $#ids; $i++ ) {
1963             my $rnd_num = rand;
1964             while ( defined $rnd_ids{$rnd_num} ) {
1965               $rnd_num = rand;
1966             }
1967             $rnd_ids{$rnd_num} = $ids[$i];
1968           }
1969           my @keys = sort { $a <=> $b } keys %rnd_ids;
1970           my $first = 1;
1971           for ( my $i = 0; $i <= $#keys; $i ) {
1972             for ( my $j = 0; $j < $bins; $j++ ) {
1973               if ( $first ) {
1974                 push( @subset_ids, [$rnd_ids{$keys[$i]} -> copy] );
1975                 push( @incl_ids, [$rnd_ids{$keys[$i]} -> idnumber] );
1976               } else {
1977                 push( @{$subset_ids[$j]}, $rnd_ids{$keys[$i]} -> copy );
1978                 push( @{$incl_ids[$j]}, $rnd_ids{$keys[$i]} -> idnumber );
1979               }
1980               $i++;
1981               last if $i > $#keys;
1982             }
1983             $first = 0;
1984           }
1985           for ( my $j = 0; $j < $bins; $j++ ) {
1986             my $sdata = data -> new ( header               => \@header,
1987                                       comment              => \@comment,
1988                                       ignoresign           => $self -> {'ignoresign'},
1989                                       individuals          => $subset_ids[$j],
1990                                       ignore_missing_files => 1,
1991                                       target               => $target,
1992                                       idcolumn             => $self -> {'idcolumn'},
1993                                       filename             => "subset_$j.dta" );
1994             #$sdata -> _write;
1995             push( @subsets, $sdata );
1996           }
1997         }
1998       }
1999 end subsets
2000
2001 # }}} subsets
2002
2003 # {{{ subset
2004
2005 start subset
2006       {
2007         $self -> synchronize;
2008         my @header  = @{$self -> {'header'}};
2009         my @comment = defined $self -> {'comment'} ? @{$self -> {'comment'}} : ();
2010         my @subset_inds = ();
2011         my $key = 0;
2012         foreach my $individual ( @{$self -> {'individuals'}} ) {
2013           if ( $individual -> evaluate_expression( column     => $based_on,
2014                                                    expression => $expression ) ) {
2015             push( @subset_inds, $individual -> copy );
2016             push( @incl_individuals, $individual -> idnumber );
2017             push( @included_keys, $key );
2018           }
2019           $key++;
2020         }
2021         $subset = data -> new ( header      => \@header,
2022                                 comment     => \@comment,
2023                                 ignoresign  => $self -> {'ignoresign'},
2024                                 individuals => \@subset_inds,
2025                                 idcolumn    => $self -> {'idcolumn'},
2026                                 filename    => "subset.dta" );
2027       }
2028 end subset
2029
2030 # }}} subset
2031
2032 # {{{ target
2033
2034 start target
2035       {
2036         if ( $parm eq 'disk' and $self -> {'target'} eq 'mem' ) {
2037           $self -> {'target'} = 'disk';
2038           $self -> flush;
2039         } elsif ( $parm eq 'mem' and $self -> {'target'} eq 'disk' ) {
2040           $self -> {'target'} = 'mem';
2041           $self -> synchronize;
2042         }
2043       }
2044 end target
2045
2046 # }}}
2047
2048 # {{{ _write
2049
2050 start _write
2051     {
2052       die "ERROR: data -> _write: No filename set in data object.\n"
2053           if( $filename eq '' );
2054
2055 #      $Data::Dumper::Maxdepth = 2;
2056 #      die Dumper $self -> {'individuals'};
2057
2058       if( not defined $self -> {'individuals'} ){
2059
2060         # If we don't have any individuals and write to a new
2061         # filename, we must first read individuals from the old
2062         # file. A call to synchronize will do that. There is no risk
2063         # of a infinite loop here since synchronize allways writes to
2064         # "full_name".
2065
2066         unless( $filename eq $self -> full_name ){
2067           $self -> synchronize;
2068         }
2069       }
2070
2071       open(FILE,">$filename") ||
2072           die "Could not create $filename\n";
2073       my $data_ref = $self -> format_data;
2074       my @data = @{$data_ref};
2075       for ( @data ) {
2076         print ( FILE );
2077       }
2078       close(FILE);
2079
2080 #       if ( $PsN::config -> {'_'} -> {'use_database'} and
2081 #          $self -> {'use_data_table'} ) {
2082 #       # Backslashes messes up the sql syntax
2083 #       my $file_str = $self->{'filename'};
2084 #       my $dir_str = $self->{'directory'};
2085 #       $file_str =~ s/\\/\//g;
2086 #       $dir_str =~ s/\\/\//g;
2087
2088 #       # md5sum
2089 #       my $md5sum = md5_hex(OSspecific::slurp_file($self-> full_name ));
2090 #       my ( $date_str, $time_str );
2091 #       if ( $Config{osname} eq 'MSWin32' ) {
2092 #         $date_str = `date /T`;
2093 #         $time_str = ' '.`time /T`;
2094 #       } else {
2095 #         # Assuming UNIX
2096 #         $date_str = `date`;
2097 #       }
2098 #       chomp($date_str);
2099 #       chomp($time_str);
2100 #       my $date_time = $date_str.$time_str;
2101 #       my $dbh = DBI -> connect("DBI:mysql:host=".$PsN::config -> {'_'} -> {'database_server'}.
2102 #                              ";databse=".$PsN::config -> {'_'} -> {'project'},
2103 #                                $PsN::config -> {'_'} -> {'user'},
2104 #                               $PsN::config -> {'_'} -> {'password'},
2105 #                                {
2106 #                                 'RaiseError' => 1});
2107 #       my $sth;
2108 #       if ( defined $self -> {'data_id'} ) {
2109 #         $sth = $dbh -> prepare( "UPDATE ".$PsN::config -> {'_'} -> {'project'}.
2110 #                              ".data ".
2111 #                                 "SET filename='$file_str',date='$date_time',".
2112 #                                 "directory='$dir_str',md5sum='$md5sum' ".
2113 #                                 "WHERE data_id='".$self -> {'data_id'}."'" );
2114 #         $sth -> execute or debug -> die( message => $sth->errstr ) ;
2115 #       } else {
2116 #         $sth = $dbh -> prepare("INSERT INTO ".$PsN::config -> {'_'} -> {'project'}.
2117 #                              ".data (filename,date,directory,md5sum) ".
2118 #                                "VALUES ('$file_str', '$date_time', '$dir_str','".
2119 #                                $md5sum."' )");
2120 #         $sth -> execute;
2121 #         $self -> {'data_id'} = $sth->{'mysql_insertid'};
2122 #       }
2123 #       $sth -> finish;
2124 #       $dbh -> disconnect;
2125 #       }
2126     }
2127 end _write
2128
2129 # }}} _write
2130
2131 # {{{ flush
2132 start flush
2133     {
2134       # synchronizes the object with the file on disk and empties
2135       # most of the objects attributes to save memory.
2136       if( defined $self -> {'individuals'} and
2137           ( !$self -> {'synced'} or $force ) ) {
2138         $self -> _write;
2139       }
2140 #      $self -> {'header'} = undef;
2141       $self -> {'comment'} = undef;
2142       $self -> {'individuals'} = undef;
2143       $self -> {'synced'} = 0;
2144       $self -> {'column_head_indices'} = undef;
2145       $self -> {'have_missing_data'} = undef;
2146     }
2147 end flush
2148 # }}} flush
2149
2150 # {{{ synchronize
2151
2152 start synchronize
2153     {
2154       # synchronizes the object with the file on disk
2155       unless( $self -> {'synced'} ){
2156         if( defined $self -> {'individuals'} and
2157             scalar @{$self -> {'individuals'}} > 0 ){
2158           # We should not read new data from file if we
2159           # have an individuals defined?
2160           # Perhaps there should be an attribute
2161           # 'from_file' that overrides this and reads in
2162           # the data from the file specified in filename
2163           # and overwrites whatever the object already
2164           # contains?
2165 #           if( -e $self -> {'filename'} ){
2166 #             $self -> _read_header;
2167 #             $self -> _read_individuals;
2168 #           }
2169           $self -> _write;
2170         } else {
2171           if( -e $self -> full_name ){
2172             unless( defined $self -> {'header'} and scalar @{$self -> {'header'}} > 0 ){
2173               $self -> _read_header;
2174             }
2175             $self -> _read_individuals;
2176           } else {
2177             debug -> die( message => "Fatal error: datafile: " . $self -> full_name . " does not exist." );
2178             return;
2179           }
2180         }
2181       }
2182       my $i = 1;
2183       foreach my $head ( @{$self -> {'header'}} ){
2184         $self -> {'column_head_indices'} -> {$head} = $i;
2185         $i++;
2186       }
2187       $self -> {'synced'} = 1;
2188     }
2189 end synchronize
2190
2191 # }}} synchronize
2192
2193 # {{{ _fisher_yates_shuffle
2194
2195 start _fisher_yates_shuffle
2196       {
2197         my $arr_ref = $parm{'array'};
2198         debug -> warn( level   => 1,
2199                        message => "Array of zero length received" )
2200           if ( scalar @{$arr_ref} < 1 );
2201         my $i;
2202         for ($i = @$arr_ref; --$i; ) {
2203           my $j = random_uniform_integer(1,0,$i);
2204 #          my $j = int rand ($i+1);
2205 #         print "$j $j_new\n";
2206           @$arr_ref[$i,$j] = @$arr_ref[$j,$i];
2207         }
2208       }
2209 end _fisher_yates_shuffle
2210
2211 # }}} _fisher_yates_shuffle
2212
2213 # {{{ _read_header
2214
2215 start _read_header
2216       {
2217         my $filename   = $self -> full_name;
2218         my $ignoresign = $self -> ignoresign;
2219         my ( @data, @new_record, $row, $tmp_row, @header, $hdrstring );
2220
2221         open(DATAFILE,"$filename") ||
2222           die "Could not open $filename for reading";
2223         my $columns;
2224         while (<DATAFILE>) {
2225           $tmp_row    = $_;
2226           #     @new_record = split(/\,|\s+/,$_);
2227           if ( ! (/^\s*\d+|^\s*\./) ) {
2228             $data[$row] = $tmp_row;
2229             $row++;
2230           } else {
2231             # We have reached the first data-row, return.
2232             $columns = scalar split(/\,\s*|\s+/);
2233             last;
2234           }
2235         }
2236         close(DATAFILE);
2237
2238         if ( defined $self -> {'cont_column'} and not $self -> {'table_file'} ) {
2239           my $data_len = $#data;
2240           for ( my $i = $data_len; $i >= 0; $i-- ) {
2241             my @arr = split(/\,\s*|\s+/,$data[$i]);
2242             if ( $arr[$self -> {'cont_column'}-1] eq 'CONT' ) {
2243               my $start = $i == $data_len ? 0 : 1;
2244               for ( my $j = $start; $j <= $#arr; $j++ ) {
2245                 if ( $j != ($self -> {'cont_column'}-1) ) {
2246                   push( @header, $arr[$j] );
2247                 }
2248               }
2249               pop( @data );
2250             }
2251           }
2252           $header[0] =~ s/$ignoresign//
2253               if ( defined $self->ignoresign );
2254           shift( @header ) if ( $header[0] eq "" );
2255         } else {
2256           chomp( $hdrstring = pop(@data));
2257           @header = split(/\,\s*|\s+/,$hdrstring);
2258           $header[0] =~ s/$ignoresign//
2259               if ( defined $self->ignoresign );
2260           shift( @header ) if ( $header[0] eq "" );
2261           if( $self -> {'table_file'} ) {
2262             my @new_header;
2263             for( my $i = 1; $i <= scalar @header; $i++ ) {
2264               if( $header[$i-1] eq 'CONT' ) {
2265                 if ( defined $self -> {'cont_column'} and not $i == $self -> {'cont_column'} ) {
2266                   debug -> warn( level   => 1,
2267                                  message => "The supplied columns for the CONT data item (".
2268                                  $self -> {'cont_column'}.") does not match the column where the CONT ".
2269                                  "header was found ($i), using $i" );
2270                 }
2271                 $self -> {'cont_column'} = $i;
2272               } else {
2273                 push( @new_header, $header[$i-1] );
2274               }
2275             }
2276             @header = @new_header;
2277             for( my $i = 1; $i <= scalar @header; $i++ ) {
2278               if( $header[$i-1] eq 'ID' ) {
2279                 if ( defined $self -> {'idcolumn'} and not $i == $self -> {'idcolumn'} ) {
2280                   debug -> warn( level   => 1,
2281                                  message => "The supplied columns for the ID data item (".
2282                                  $self -> {'idcolumn'}.") does not match the column where the CONT ".
2283                                  "header was found ($i), using $i" );
2284                 }
2285                 $self -> {'idcolumn'} = $i;
2286               }
2287             }
2288           }
2289         }
2290
2291 # I'm not certain on how to deal with this conflict. I'm leaving it commented because I believe this code should not be here.
2292 #
2293 #<<<<<<< data_subs.pm
2294 #       $header[0] =~ s/$ignoresign//
2295 #         if ( defined $self->ignoresign );
2296 #       shift( @header ) if ( $header[0] eq "" );
2297 #=======
2298 #>>>>>>> 1.28
2299
2300 # It is ok with data sets without a header.
2301 #       unless( scalar @header > 0 ){ debug -> die( message => 'Datafile ' . $self -> full_name . ' is empty.' ); }
2302
2303         $self -> {'header'} = \@header;
2304         $self -> {'comment'} = \@data;
2305 #       if ( $PsN::config -> {'_'} -> {'use_database'} and
2306 #            $self -> {'use_data_table'} ) {
2307 #         my $dbh = DBI -> connect("DBI:mysql:host=".$PsN::config -> {'_'} -> {'database_server'}.
2308 #                              ";databse=".$PsN::config -> {'_'} -> {'project'},
2309 #                                  $PsN::config -> {'_'} -> {'user'},
2310 #                               $PsN::config -> {'_'} -> {'password'},
2311 #                                  {'RaiseError' => 1});
2312 #         if ( scalar @header < 1 ) {
2313 #           for ( my $i = 1; $i <= $columns; $i++ ) {
2314 #             push( @header, $i );
2315 #           }
2316 #         }
2317 #         for ( my $i = 0; $i <= $#header; $i++ ) {
2318 #           my $sth = $dbh -> prepare("INSERT INTO ".$PsN::config -> {'_'} -> {'project'}.
2319 #                              ".data_column ".
2320 #                                     "(name,number,data_id) ".
2321 #                                     "VALUES ('".$header[$i]."', '".($i+1).
2322 #                                     "', '".$self -> {'data_id'}."' )");
2323 #           $sth -> execute;
2324 #           push( @{$self -> {'data_column_ids'}}, $sth->{'mysql_insertid'} );
2325 #           $sth -> finish;
2326 #         }
2327 #         $dbh -> disconnect;
2328 #       }
2329       }
2330 end _read_header
2331
2332 # }}} _read_header
2333
2334 # {{{ _read_individuals
2335
2336 start _read_individuals
2337       {
2338         my $idcol        = $self -> idcolumn;
2339         my $filename     = $self -> full_name;
2340         debug -> warn( level   => 1,
2341                        message => "Building array of individuals from file " . $self -> {'filename'} );
2342         open(DATAFILE,"$filename") ||
2343           die "Could not open $filename for reading";
2344         my ( @new_row, $new_ID, $old_ID, @init_data );
2345         my $buffer;
2346         my $lines = 0;
2347         while (sysread DATAFILE, $buffer, 4096) {
2348           $lines += ($buffer =~ tr/\n//);
2349         }
2350         seek( DATAFILE, 0,0 );
2351
2352         # For status bar:
2353         my $status_bar = status_bar -> new( steps => $lines );
2354
2355         ui -> print( category => 'scm',
2356                      message  => "Reading data file: ".$self -> filename );
2357         ui -> print( category => 'scm',
2358                      message => $status_bar -> print_step(),
2359                      newline => 0);
2360
2361         my ( $sth, $dbh, $first_row_id, $first_value_id );
2362         my $insert = 1;
2363 #       if ( $PsN::config -> {'_'} -> {'use_database'} and
2364 #            $self -> {'use_data_table'} ) {
2365 #         $dbh = DBI -> connect("DBI:mysql:host=".$PsN::config -> {'_'} -> {'database_server'}.
2366 #                              ";databse=".$PsN::config -> {'_'} -> {'project'},
2367 #                               $PsN::config -> {'_'} -> {'user'},
2368 #                               $PsN::config -> {'_'} -> {'password'},
2369 #                               {'RaiseError' => 1});
2370 #         my $sth = $dbh -> prepare( "SELECT data_row_id FROM ".$PsN::config -> {'_'} -> {'project'}.
2371 #                              ".data_row ".
2372 #                                    "WHERE data_id='".$self -> {'data_id'}."'" );
2373 #         $sth -> execute or debug -> die( message => $sth->errstr ) ;
2374 #         my $select_arr = $sth -> fetchall_arrayref;
2375 #         if ( scalar @{$select_arr} > 0 ) {
2376 #           for ( my $i = 0; $i < scalar @{$select_arr}; $i++ ) {
2377 #             push( @{$self -> {'data_row_ids'}}, $select_arr->[$i][0] );
2378 #           }
2379 #           $sth = $dbh -> prepare( "SELECT data_value_id FROM ".$PsN::config -> {'_'} -> {'project'}.
2380 #                              ".data_value ".
2381 #                                   "WHERE data_id='".$self -> {'data_id'}."'" );
2382 #           $sth -> execute or debug -> die( message => $sth->errstr ) ;
2383 #           my $select_val = $sth -> fetchall_arrayref;
2384 #           for ( my $i = 0; $i < scalar @{$select_val}; $i++ ) {
2385 #             push( @{$self -> {'data_value_ids'}}, $select_val->[$i][0] );
2386 #           }
2387 #           $insert = 0;
2388 #           $dbh -> disconnect;
2389 #         } else {
2390 #           $dbh -> do( "LOCK TABLES ".$PsN::config -> {'_'} -> {'project'}.
2391 #                              ".data_row WRITE, ".$PsN::config -> {'_'} -> {'project'}.
2392 #                              ".data_value WRITE" );
2393 #           $sth = $dbh -> prepare( "SELECT MAX(data_row_id) FROM ".$PsN::config -> {'_'} -> {'project'}.
2394 #                              ".data_row" );
2395 #           $sth -> execute or debug -> die( message => $sth->errstr ) ;
2396 #           my $select_arr = $sth -> fetchall_arrayref;
2397 #           $first_row_id = defined $select_arr -> [0][0] ? $select_arr -> [0][0] : 0;
2398 #           $sth = $dbh -> prepare( "SELECT MAX(data_value_id) FROM ".$PsN::config -> {'_'} -> {'project'}.
2399 #                              ".data_value" );
2400 #           $sth -> execute or debug -> die( message => $sth->errstr ) ;
2401 #           my $select_arr = $sth -> fetchall_arrayref;
2402 #           $first_value_id = defined $select_arr -> [0][0] ? $select_arr -> [0][0] : 0;
2403 #         }
2404 #         $sth -> finish;
2405 #       }
2406
2407         my $insert_rows;
2408         my $insert_values;
2409         my $row_counter = 0;
2410         my $full_row;
2411       ROW: while ( <DATAFILE> ) {
2412           s/^ *//;
2413           my @new_row   = split(/\,\s*|\s+/);
2414           # This regexp check is not time consuming.
2415           if ( /^\s*\d+|^\s*\./ ) {
2416             if ( defined $self -> {'cont_column'} ) {
2417               if ( $new_row[$self -> {'cont_column'} - 1] == 1 ) {
2418                 if ( not $self -> {'table_file'} ) { # Skip the CONT=1 rows if this is a table file
2419                   for ( my $i = $#new_row; $i > 0; $i-- ) {
2420                     if ( $i != ($self -> {'cont_column'} - 1) ) {
2421                       unshift( @{$full_row}, $new_row[$i] );
2422                     }
2423                   }
2424                 }
2425                 next ROW;
2426               } else {
2427                 for ( my $i = $#new_row; $i >= 0; $i-- ) {
2428 #                 if ( $i != ($self -> {'cont_column'} - 1) or $self -> {'table_file'} ) {
2429                   if ( $i != ($self -> {'cont_column'} - 1) ) {
2430                     unshift( @{$full_row}, $new_row[$i] );
2431                   }
2432                 }
2433               }
2434             } else {
2435               @{$full_row} = @new_row;
2436             }
2437             $new_ID = $full_row -> [$idcol-1]; # index starts at 0
2438             $old_ID = $new_ID if ( not defined $old_ID );
2439
2440             # Check if column miss data at some row (This adds about 30% of init time)
2441             my $mdt = $self -> {'missing_data_token'};
2442             for( my $i = 0; $i <= $#{$full_row}; $i++ ){
2443                 $self -> {'have_missing_data'} -> {$i+1} = 1
2444                   if( $full_row -> [$i] == $mdt ); # == is slower but safer than eq
2445             }
2446 #           if ( $PsN::config -> {'_'} -> {'use_database'} and
2447 #                $self -> {'use_data_table'} and $insert ) {
2448 #             $row_counter++;
2449 #             $insert_rows = $insert_rows."," if ( defined $insert_rows );
2450 #             $insert_rows = $insert_rows.
2451 #               "('$row_counter', '".$self -> {'data_id'}."' )";
2452 #             for ( my $j = 0; $j <= $#{$full_row}; $j++ ) {
2453 #               $insert_values = $insert_values."," if ( defined $insert_values );
2454 #               $insert_values = $insert_values.
2455 #                 "('".$full_row -> [$j]."', '".
2456 #                   ($first_row_id+$row_counter)."', '".
2457 #                     $self -> {'data_column_ids'}->[$j].
2458 #                       "', '".$self -> {'data_id'}."' )";
2459 #             }
2460 #           }
2461
2462             if ( $new_ID != $old_ID ) {
2463               my @subject_data = @init_data;
2464               my $id = data::individual -> new ( idcolumn     => $idcol,
2465                                                  subject_data => \@subject_data,
2466                                                  data_id      => $self -> {'data_id'} );
2467               push( @{$self -> {'individuals'}}, $id );
2468               @init_data =(join( ",", @{$full_row}));
2469             } else {
2470               push( @init_data, join( ",", @{$full_row}) );
2471             }
2472             $old_ID = $new_ID;
2473             $full_row = undef;
2474           }
2475           if ( $status_bar -> tick() ) {
2476             ui -> print( category => 'scm',
2477                          message  => $status_bar -> print_step(),
2478                          wrap     => 0,
2479                          newline  => 0 );
2480           }
2481         }
2482
2483 #       if ( $PsN::config -> {'_'} -> {'use_database'} and
2484 #            $self -> {'use_data_table'} and $insert ) {
2485 #         $dbh -> do("INSERT INTO ".$PsN::config -> {'_'} -> {'project'}.
2486 #                    ".data_row ".
2487 #                    "(number,data_id) ".
2488 #                    "VALUES ".$insert_rows);
2489 #         push( @{$self -> {'data_row_ids'}}, ($first_row_id..$first_row_id+$row_counter) );
2490 #         $dbh -> do( "INSERT INTO ".$PsN::config -> {'_'} -> {'project'}.
2491 #                     ".data_value ".
2492 #                     "(value,data_row_id,data_column_id,data_id) ".
2493 #                     "VALUES ".$insert_values );
2494 #         push( @{$self -> {'data_value_ids'}},
2495 #               ($first_value_id..$first_value_id+($row_counter*
2496 #                                                  scalar @{$self->{'data_column_ids'}})));
2497 #         $dbh -> do( "UNLOCK TABLES" );
2498 #         $dbh -> disconnect;
2499 #       }
2500
2501         if ( $#init_data >= 0 ) {
2502           push( @{$self -> {'individuals'}},
2503                 data::individual -> new ( idcolumn     => $idcol,
2504                                           subject_data => \@init_data ) );
2505         }
2506         ui -> print( category => 'scm',
2507                      message  => " ... done" );
2508         close(DATAFILE);
2509 #       $self -> _write( filename => 'test.dta' );
2510       }
2511 end _read_individuals
2512
2513 # }}} _read_individuals
2514