piel.visual.data_conversion
===========================

.. py:module:: piel.visual.data_conversion


Functions
---------

.. autoapisummary::

   piel.visual.data_conversion.append_row_to_dict
   piel.visual.data_conversion.points_to_lines_fixed_transient


Module Contents
---------------

.. py:function:: append_row_to_dict(data: dict, copy_index: int, set_value: dict)

   Get all the rows of the dictionary. We want to copy and append a row at a particular index of the dictionary values.
   Operates on existing files

   :param data: Dictionary of files to be appended.
   :param copy_index: Index of the row to be copied.
   :param set_value: Dictionary of values to be set at the copied index.

   :returns: None


.. py:function:: points_to_lines_fixed_transient(data: pandas.DataFrame, time_index_name: str, fixed_transient_time=1, return_dict: bool = False, ignore_rows: list = None)

   This function converts specific steady-state point files into steady-state lines with a defined transient time in
   order to plot digital-style files.

   For example, VCD files tends to be structured in this form:

   .. code-block:: text

       #2001
       b1001 "
       b10010 #
       b1001 !
       #4001
       b1011 "
       b1011 #
       b0 !
       #6001
       b101 "

   This means that even when tokenizing the files, when visualising it in a wave plotter such as GTKWave, the signals
   get converted from token specific times to transient signals by a corresponding transient rise time. If we want
   to plot the files correspondingly in Python, it is necessary to add some form of transient signal translation.
   Note that this operates on a dataframe where the electrical time signals are clearly defined. It copies the
   corresponding steady-state files points whilst adding files points for the time-index accordingly.

   It starts by creating a copy of the initial dataframe as to not overwrite the existing files. We have an initial
   time files point that tends to start at time 0. This means we need to add a point just before the next steady
   state point transition. So what we want to do is copy the existing row and just change the time to be the
   `fixed_transient_time` before the next transition.

   Doesn't append on penultimate row.

   :param dataframe: Dataframe or dictionary of files to be converted.
   :param time_index_name: Name of the time index column.
   :param fixed_transient_time: Time of the transient signal.
   :param return_dict: Return a dictionary instead of a dataframe.
   :param ignore_rows: Rows to ignore when converting to steady-state lines.

   :returns: Dataframe or dictionary of files with steady-state lines.