STK::DataFrame Class Reference
[project DManager (Data Management)]

DataFrame is a List and a 2D container containing Variables. More...

#include <STK_DataFrame.h>

Inherits List1D< IVariable * >, and IContainer2D< DataFrame >.

List of all members.

Public Member Functions
	DataFrame ()
	DataFrame (const DataFrame &T, const bool &ref=false)
virtual	~DataFrame ()
void	clear ()
IVariable *&	getElt (const Integer &i)
IVariable *const &	getElt (const Integer &i) const
DataFrame &	operator= (const DataFrame &T)
void	shift (const Integer &cbeg=1)
void	shift (Integer rbeg, Integer cbeg)
void	popBackCols (const Integer &n)
void	eraseCols (Integer pos, Integer n=1)
void	swapCols (Integer j1, Integer j2)
void	popBackRows (const Integer &n)
void	eraseRows (Integer pos, Integer n=1)
void	insertVariable (const Integer &pos, IVariable *const &V)
void	pushBackVariable (IVariable *const &V)
void	pushFrontVariable (IVariable *const &V)
void	insertDataFrame (Integer pos, const DataFrame &D)
void	pushBackDataFrame (DataFrame const &D)
void	pushFrontDataFrame (DataFrame const &D)
void	writeDataFrame (ostream &os, const Integer &left, const Integer &right) const
Protected Types
typedef List1D< IVariable * >	_BaseList
Protected Member Functions
void	freeMem ()
void	freeRows ()
void	pushBackCols (Integer n=1)
void	insertCols (Integer pos, Integer n=1)
void	pushBackRows (Integer n=1)
void	insertRows (Integer pos, Integer n=1)

---

Detailed Description

A DataFrame inherit from List1D and IContainer2D. It is essentially a List, except that each col (the variables) possess the same dimension. Each Cell of the List1D contain a pointer on a Variable.

Definition at line 55 of file STK_DataFrame.h.

---

Member Typedef Documentation

typedef List1D<IVariable*> STK::DataFrame::_BaseList [protected]

Type for the list container.

Definition at line 60 of file STK_DataFrame.h.

---

Constructor & Destructor Documentation

STK::DataFrame::DataFrame

(

)

Default Ctor, empty table.

Definition at line 48 of file STK_DataFrame.cpp.

                     : _BaseList()
                       , IContainer2D<DataFrame>(Inx(), Inx())
{ ;}

STK::DataFrame::DataFrame	(	const DataFrame &	T,
		const bool &	ref = false
	)

Copy Ctor. If ref is true, only references of the variables are copied into the DataFrame.

Parameters:

	T	the DataFrame to copy
	ref	true if we want to wrap the variables of T

Definition at line 53 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), and STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last().

                    : _BaseList(T)
                    , IContainer2D<DataFrame>(T)
{
  // the adress of the variables are copied in List1D
  // but we need to copy explicitly the data
  for (Integer j=first(); j<=last(); j++) // for all cols
    if (T[j])                // if there is data
      at(j) = T[j]->clone(ref); // set the adress of a clone
}

STK::DataFrame::~DataFrame

(

)

[virtual]

Dtor.

Definition at line 65 of file STK_DataFrame.cpp.

References freeRows().

{
  // free the rows as the destructor of _BaseList will not free the mem
  freeRows();
}

---

Member Function Documentation

void STK::DataFrame::clear

(

)

clear the object.

Reimplemented from STK::List1D< IVariable * >.

Definition at line 72 of file STK_DataFrame.cpp.

References freeMem(), STK::IContainer2D< DataFrame >::setRange(), and STK::ITContainer1D< IVariable *, List1D< IVariable * > >::setRange().

{
  freeMem();
  // set default range for list
  _BaseList::setRange();
  // set default range for container2D
  IContainer2D<DataFrame>::setRange();
}

IVariable* & STK::DataFrame::getElt

(

const Integer &

i

)

[inline]

access to one element.

Reimplemented from STK::List1D< IVariable * >.

Definition at line 85 of file STK_DataFrame.h.

References STK::List1D< IVariable * >::getElt().

Referenced by STK::ExportToCsv::ExportToCsv().

    { return _BaseList::getElt(i);}

IVariable* const& STK::DataFrame::getElt

(

const Integer &

i

)

const [inline]

access to one element for const.

Reimplemented from STK::List1D< IVariable * >.

Definition at line 89 of file STK_DataFrame.h.

References STK::List1D< IVariable * >::getElt().

    { return _BaseList::getElt(i);}

DataFrame & STK::DataFrame::operator=

(

const DataFrame &

T

)

Operator = : overwrite the DataFrame with T.

Definition at line 82 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), STK::ITContainer1D< TYPE, TContainer1D >::first(), STK::IContainer2D< Container2D >::getRangeHo(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last(), STK::ITContainer1D< TYPE, TContainer1D >::last(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::resize(), STK::IContainer2D< Container2D >::sizeHo(), and STK::IContainer2D< DataFrame >::sizeHo().

{
  // Resize if necessary.
  if (sizeHo() != T.sizeHo()) _BaseList::resize(T.getRangeHo());

  // Copy without overlapping.
  if ((T.first()>=first()))
  {
    for (Integer jt=T.first(), j=first(); jt<=T.last(); j++, jt++)
    {
      // clear old mem if any
      if (at(j)) delete at(j);
      // if there is a variable, create a copy
      if (T[jt]) at(j) = T[jt]->clone();
      else       at(j) = (IVariable*)NULL;
    }
  }
  else
  {
    for (Integer jt=T.last(), j=last(); jt>=T.first(); j--, jt--)
    {
      // clear old mem if any
      if (at(j)) delete at(j);
      // if there is a variable, create a copy
      if (T[jt]) at(j) = T[jt]->clone();
      else       at(j) = (IVariable*)NULL;
    }
  }
  return *this;
}

void STK::DataFrame::shift

(

const Integer &

cbeg = 1

)

New beginning index for the object.

Reimplemented from STK::List1D< IVariable * >.

Definition at line 114 of file STK_DataFrame.cpp.

References STK::IContainer2D< DataFrame >::setFirstHo(), and STK::List1D< IVariable * >::shift().

Referenced by shift().

{
  // list1D shift
  _BaseList::shift(cbeg);
  // IContainer2D shift for Col
  setFirstHo(cbeg);
}

void STK::DataFrame::shift	(	Integer	rbeg,
		Integer	cbeg
	)

New beginning index for the object.

Definition at line 173 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), STK::IContainer2D< DataFrame >::firstCol(), STK::IContainer2D< DataFrame >::firstRow(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last(), STK::IContainer2D< DataFrame >::setFirstVe(), STK::IVariable::shift(), and shift().

{
  // if there is something to do
  if ((rbeg - firstRow() != 0)||(cbeg - firstCol() != 0))
  {
    // list1D shift
    shift(cbeg);
    // For each col update Variable
    for (Integer j=first(); j<=last(); j++)
      if (at(j)) { at(j)->shift(rbeg);}
    // update range of the rows
    setFirstVe(rbeg);
  }
}

void STK::DataFrame::popBackCols

(

const Integer &

n

)

Del n col of the container.

Definition at line 123 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::IContainer2D< DataFrame >::decLastHo(), freeMem(), STK::IContainer2D< DataFrame >::getSizeHo(), STK::IContainer2D< DataFrame >::lastCol(), STK::List1D< IVariable * >::popBackElts(), and STK::IContainer2D< DataFrame >::sizeHo().

{
  // if n<=0 nothing to do
  if (n<=0) return;
  // if there is cols to erase
  if (getSizeHo()<n)
  { throw std::out_of_range("DataFrame::popBackCols(n) "
                       "getSizeHo() < n");
  }
  // for all cols, delete variables
  for (Integer j=lastCol() - n +1; j<=lastCol(); j++)
    if (at(j)) delete at(j);
  // popBackElts() of List1D
  _BaseList::popBackElts(n);
  // update IContainer2D
  decLastHo(n);
  // if it was the last elt, free mem
  if (this->sizeHo() == 0) freeMem();
}

void STK::DataFrame::eraseCols	(	Integer	pos,
		Integer	n = 1
	)

Del n cols at the position of the container.

Definition at line 144 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::IContainer2D< DataFrame >::decLastHo(), STK::List1D< IVariable * >::eraseElts(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), freeMem(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last(), and STK::IContainer2D< DataFrame >::sizeHo().

{
  // if n<=0 nothing to do
  if (n<=0) return;
  // check conditions
  if (pos<first())
  { throw std::out_of_range("DataFrame::eraseCols(pos, n) "
                       "pos < first()");
  }
  if (pos>last())
  { throw std::out_of_range("DataFrame::eraseCols(pos, n) "
                       "pos > last()");
  }
  if (last() < pos+n-1)
  { throw std::out_of_range("DataFrame::eraseCols(pos, n) "
                       "last() < pos+n-1");
  }
  // for all cols, delete variables
  for (Integer j=pos+n-1; j>=pos; j--)
    if (at(j)) { delete at(j);}
  // delete elements of the List1D
  eraseElts(pos, n);
  // update rangeHo_
  decLastHo(n);
  // if it was the last col, free mem
  if (this->sizeHo() == 0) freeMem();
}

void STK::DataFrame::swapCols	(	Integer	j1,
		Integer	j2
	)			[inline]

Swapping the j1th col and the j2th col.

Definition at line 114 of file STK_DataFrame.h.

References STK::List1D< IVariable * >::swapElts().

    { swapElts(j1, j2);}

void STK::DataFrame::popBackRows

(

const Integer &

n

)

Dell last row of the container.

Definition at line 189 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::IContainer2D< DataFrame >::decLastVe(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last(), STK::IVariable::popBackElts(), and STK::IContainer2D< DataFrame >::sizeVe().

{
  if (sizeVe() < n)
  { throw std::out_of_range("DataFrame::popBackRows(n) "
                       "sizeVe() < n");
  }
  // del last row to each variable
  for (Integer j=first(); j<=last(); j++)
    if (at(j)) { at(j)->popBackElts(n);}
  // update rangeVe_
  decLastVe(n);
}

void STK::DataFrame::eraseRows	(	Integer	pos,
		Integer	n = 1
	)

Dell n rows at the position to the container.

Definition at line 203 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::IContainer2D< DataFrame >::decLastVe(), STK::IVariable::eraseElts(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), STK::IContainer2D< DataFrame >::firstRow(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last(), and STK::IContainer2D< DataFrame >::lastRow().

{
  // if n<=0 nothing to do
  if (n<=0) return;
  // check conditions
  if (firstRow() > pos)
  { throw std::out_of_range("DataFrame::eraseRows(pos, n) "
                       "firstRow() > pos");
  }
  if (lastRow() < pos)
  { throw std::out_of_range("DataFrame::eraseRows(pos, n) "
                       "lastRow() < pos");
  }
  if (lastRow() < pos+n-1)
  { throw std::out_of_range("DataFrame::eraseRows(pos, n) "
                       "lastRow() < pos+n-1");
  }
  // for each variable erase elts
  for (Integer j=first(); j<=last(); j++)
    if (at(j)) { at(j)->eraseElts(pos, n);}
  // update rangeVe_
  decLastVe(n);
}

void STK::DataFrame::insertVariable	(	const Integer &	pos,
		IVariable *const &	V
	)

Insert a Vartiable at the specified position to the container.

Parameters:

pos

pos

Definition at line 228 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::IContainer2D< DataFrame >::firstCol(), STK::IContainer2D< DataFrame >::firstRow(), STK::IContainer2D< DataFrame >::incLastHo(), STK::IContainer2D< DataFrame >::incLastVe(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::insert(), STK::IContainer2D< DataFrame >::lastCol(), STK::IVariable::pushBackNA(), STK::IVariable::shift(), STK::IVariable::size(), and STK::IContainer2D< DataFrame >::sizeVe().

Referenced by pushFrontVariable().

{
  // List1D
  insert(pos, V);
  at(pos)->shift(firstRow());

  // update rows with NA values
  Integer inc = sizeVe() - V->size();
  // update LastHo
  incLastHo();
  if (inc == 0) return; // same size
  if (inc > 0) // V has less rows
  { // put NA values to the inserted cols
    at(pos)->pushBackNA(inc);
  }
  else
  { // put NA values to the oter cols
    for (Integer i=this->firstCol(); i <pos; i++)
      if (at(i)) { at(i)->pushBackNA(-inc);}
    for (Integer i=pos+1; i <=this->lastCol(); i++)
      if (at(i)) { at(i)->pushBackNA(-inc);}
    // update LastVe
    incLastVe(-inc);
  }
}

void STK::DataFrame::pushBackVariable

(

IVariable *const &

V

)

Append a DataFrame back.

Definition at line 256 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), STK::IContainer2D< DataFrame >::firstRow(), STK::IContainer2D< DataFrame >::incLastHo(), STK::IContainer2D< DataFrame >::incLastVe(), STK::IContainer2D< DataFrame >::lastCol(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::push_back(), STK::IVariable::pushBackNA(), STK::IVariable::shift(), STK::IVariable::size(), and STK::IContainer2D< DataFrame >::sizeVe().

Referenced by STK::ImportFromCsv::ImportFromCsv().

{
  // update LastHo
  incLastHo();
  // List1D
  push_back(V);
  at(lastCol())->shift(firstRow());
  // update rows with NA values
  Integer inc = sizeVe() - V->size();
  if (inc == 0) return; // same size
  if (inc > 0) //V has less rows
  { // put NA values to the inserted cols
    at(lastCol())->pushBackNA(inc);
  }
  else
  { // put NA values to the oter cols
    for (Integer i=this->first(); i <lastCol(); i++)
      if (at(i)) { at(i)->pushBackNA(-inc);}
    // update LastVe
    incLastVe(-inc);
  }
}

void STK::DataFrame::pushFrontVariable

(

IVariable *const &

V

)

[inline]

Append a DataFrame front.

Definition at line 135 of file STK_DataFrame.h.

References STK::IContainer2D< DataFrame >::firstCol(), and insertVariable().

    { insertVariable(firstCol(), V);}

void STK::DataFrame::insertDataFrame	(	Integer	pos,
		const DataFrame &	D
	)

Insert a DataFrame at the specified position to the container.

Definition at line 280 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::ITContainer1D< TYPE, TContainer1D >::at(), STK::IVariable::clone(), STK::IContainer2D< DataFrame >::firstCol(), STK::IContainer2D< Container2D >::firstCol(), STK::IContainer2D< DataFrame >::firstRow(), STK::IContainer2D< DataFrame >::incLastHo(), STK::IContainer2D< DataFrame >::incLastVe(), STK::List1D< IVariable * >::insertElts(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last(), STK::IContainer2D< Container2D >::lastCol(), STK::IVariable::pushBackNA(), STK::IVariable::shift(), STK::IContainer2D< Container2D >::sizeHo(), STK::IContainer2D< Container2D >::sizeVe(), and STK::IContainer2D< DataFrame >::sizeVe().

Referenced by pushFrontDataFrame().

{
  // List1D
  insertElts(pos, D.sizeHo());
  // insert all cols of D
  for (Integer i = D.firstCol(), icol = pos; i <=D.lastCol(); i++, icol++)
  {
    if (D.at(i))
    {
      at(icol) = D.at(i)->clone();
      at(icol)->shift(firstRow());
    }
  }
  // update LastHo
  incLastHo(D.sizeHo());
  // update rows with NA values
  Integer inc = sizeVe() - D.sizeVe();
  if (inc == 0) return; // same size
  if (inc > 0) // D has less rows
  { // put NA values to the inserted cols
    for (Integer i= pos+D.sizeHo()-1; i >=pos; i--)
      if (at(i)) { at(i)->pushBackNA(inc);}
  }
  else
  { // put NA values to the oter cols
    for (Integer i=this->firstCol(); i <pos; i++)
      if (at(i)) { at(i)->pushBackNA(-inc);}
    for (Integer i=pos+D.sizeHo(); i <=this->last(); i++)
      if (at(i)) { at(i)->pushBackNA(-inc);}
    // update LastVe
    incLastVe(-inc);
  }
}

void STK::DataFrame::pushBackDataFrame

(

DataFrame const &

D

)

Append a DataFrame back.

Definition at line 316 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::ITContainer1D< TYPE, TContainer1D >::at(), STK::IVariable::clone(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), STK::ITContainer1D< TYPE, TContainer1D >::first(), STK::IContainer2D< DataFrame >::firstRow(), STK::IContainer2D< DataFrame >::incLastHo(), STK::IContainer2D< DataFrame >::incLastVe(), STK::ITContainer1D< TYPE, TContainer1D >::last(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last(), STK::List1D< IVariable * >::pushBackElts(), STK::IVariable::pushBackNA(), STK::IVariable::shift(), STK::IContainer2D< Container2D >::sizeHo(), STK::IContainer2D< Container2D >::sizeVe(), and STK::IContainer2D< DataFrame >::sizeVe().

{
  // compute pos
  Integer pos(last()+1);
  // List1D
  pushBackElts(D.sizeHo());
  // insert all cols of D
  for (Integer i = D.first(), icol = pos; i <=D.last(); i++, icol++)
  {
    if (D.at(i))
    {
      at(icol) = D.at(i)->clone();
      at(icol)->shift(firstRow());
    }
  }
  // update LastHo
  incLastHo(D.sizeHo());
  // update rows with NA values
  Integer inc = sizeVe() - D.sizeVe();
  if (inc == 0) return; // same size
  if (inc > 0) // D has less rows
  { // put NA values to the inserted cols
    for (Integer i= last(); i >=pos; i--)
      if (at(i)) { at(i)->pushBackNA(inc);}
  }
  else
  { // put NA values to the oter cols
    for (Integer i=this->first(); i <pos; i++)
      if (at(i)) { at(i)->pushBackNA(-inc);}
    // update LastVe
    incLastVe(-inc);
  }
}

void STK::DataFrame::pushFrontDataFrame

(

DataFrame const &

D

)

[inline]

Append a DataFrame front.

Definition at line 147 of file STK_DataFrame.h.

References STK::IContainer2D< DataFrame >::firstCol(), and insertDataFrame().

    { insertDataFrame(firstCol(), D);}

void STK::DataFrame::writeDataFrame	(	ostream &	os,
		const Integer &	left,
		const Integer &	right
	)			const

write a DataFrame to the output stream os.

Definition at line 460 of file STK_DataFrame.cpp.

References STK::ExportToCsv::eraseReadWriteCsv(), STK::IContainer2D< DataFrame >::firstRow(), STK::ExportToCsv::getReadWriteCsv(), STK::IContainer2D< DataFrame >::lastRow(), STK::ReadWriteCsv::setDelimiters(), and STK::ReadWriteCsv::writeSelection().

Referenced by STK::operator<<().

{
  // Export  to csv the DataFrame
  ExportToCsv csv(*this);
  // get the csv
  ReadWriteCsv* pData = csv.getReadWriteCsv();
  // set delimiters to blanck
  pData->setDelimiters(STRING_BLANCK);
  // write the csv
  pData->writeSelection(os, firstRow(), lastRow(), left, right);
  // delete the csv
  csv.eraseReadWriteCsv();
}

void STK::DataFrame::freeMem

(

)

[protected]

function for memory desallocation.

Merge two dataframe (vertically) : The concatenation will be done using the names of the variables.

Reimplemented from STK::List1D< IVariable * >.

Definition at line 434 of file STK_DataFrame.cpp.

References STK::List1D< IVariable * >::freeMem(), freeRows(), STK::IContainer2D< DataFrame >::setRangeHo(), and STK::IContainer2D< DataFrame >::setRangeVe().

Referenced by clear(), eraseCols(), and popBackCols().

{
  // liberate variables
  freeRows();
  // call base freeMem
  _BaseList::freeMem();
  // set range to default
  setRangeVe();
  setRangeHo();
}

void STK::DataFrame::freeRows

(

)

[protected]

function for row memory desallocation.

Definition at line 446 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last(), and STK::IContainer2D< DataFrame >::setRangeVe().

Referenced by freeMem(), and ~DataFrame().

{
  // for all cols
  for (Integer j=first(); j<=last(); j++)
    if (at(j))                  // if there is mem allocated
    {
      delete at(j);             // erase
      at(j) = (IVariable*)NULL; // set default
    }
  // set default range
  setRangeVe();
}

void STK::DataFrame::pushBackCols

(

Integer

n = 1

)

[protected]

Add cols to the container.

Definition at line 353 of file STK_DataFrame.cpp.

References STK::IContainer2D< DataFrame >::incLastHo(), and STK::ITContainer1D< IVariable *, List1D< IVariable * > >::push_back().

{
  // if n<=0 nothing to do
  if (n <= 0) return;
  // add n cols to list1D
  _BaseList::push_back(n, (IVariable*)NULL);
  // update IContainer2D
  incLastHo(n);
}

void STK::DataFrame::insertCols	(	Integer	pos,
		Integer	n = 1
	)			[protected]

Insert cols at the specified position to the container.

Definition at line 364 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), STK::IContainer2D< DataFrame >::incLastHo(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::insert(), and STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last().

{
  if (n <= 0) return;        // if n<=0 nothing to do
  // check conditions
  if (pos<first())
  { throw std::out_of_range("DataFrame::insertElts(pos, n) "
                       "pos<first()");
  }
  if (pos>last())
  { throw std::out_of_range("Dataframe::insertElts(pos, n) "
                       "pos>last()");
  }
  // insert n elements in list1D
  _BaseList::insert(Inx(pos, pos+n-1), (IVariable*)NULL);
  // update IContainer2D
  incLastHo(n);
}

void STK::DataFrame::pushBackRows

(

Integer

n = 1

)

[protected]

Add n rows to the container.

Definition at line 383 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), STK::IContainer2D< DataFrame >::incRangeVe(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last(), and STK::IVariable::pushBackElts().

{
  // if n<=0 nothing to do
  if (n<=0) return;
  // for each col append row
  for (Integer j=first(); j<=last(); j++)
  {
    if (at(j))
    { at(j)->pushBackElts(n);}
  }
  // update range of the container
  incRangeVe(n);
}

void STK::DataFrame::insertRows	(	Integer	pos,
		Integer	n = 1
	)			[protected]

Insert n rows at the ith position of the container.

Definition at line 398 of file STK_DataFrame.cpp.

References STK::ITContainer1D< IVariable *, List1D< IVariable * > >::at(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::first(), STK::IContainer2D< DataFrame >::firstRow(), STK::IContainer2D< DataFrame >::getRangeVe(), STK::IContainer2D< DataFrame >::incLastVe(), STK::IVariable::insertElts(), STK::ITContainer1D< IVariable *, List1D< IVariable * > >::last(), and STK::IContainer2D< DataFrame >::lastRow().

{
  // if n<=0 nothing to do
  if (n<=0) return;
  // update range of the container
  getRangeVe();
  // check conditions
  if (firstRow() > pos)
  { throw std::out_of_range("DataFrame::insertRows(pos, n) "
                       "firstRow() > pos");
  }
  if (lastRow()+1 < pos)
  { throw std::out_of_range("DataFrame::insertRows(pos, n) "
                       "lastRow()+1 < pos");
  }
  // ins rows to each variables
  for (Integer j=first(); j<=last(); j++)
  {
    // if there is a variable
    if (at(j))
    { at(j)->insertElts(pos, n);}
  }
  // update rangeVe_
  incLastVe(n);
}

---

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

• STK_DataFrame.h
• STK_DataFrame.cpp