Решение для извлечения табличных данных из файла PDF (вроде)

Мне нужно было извлечь табличные данные на большом количестве страниц из многих PDF-документов. Использование встроенной возможности экспорта текста из Adobe Acrobat Reader было бесполезным - текст, извлеченный таким образом, теряет пространственные отношения, установленные таблицами. Было задано несколько вопросов, и я попробовал множество решений этой проблемы, но результаты варьировались от плохих до ужасных. Поэтому я приступил к разработке собственного решения. Он достаточно развит (я думаю), что готов поделиться здесь.


person Big_Al_Tx    schedule 23.08.2017    source источник


Ответы (1)


Сначала я попытался посмотреть на распределение текста (с точки зрения их расположения по осям x и y на странице), чтобы попытаться определить, где расположены разрывы строк и столбцов. Используя модуль Python «pdfminer», я извлек текст и параметры BoundingBox, просеял каждый фрагмент текста и сопоставил, сколько фрагментов текста было на странице для данного значения x или y. Идея заключалась в том, чтобы просмотреть распределение текста (по горизонтали для разрывов строк и по вертикали для разрывов столбцов), и когда плотность была равна нулю (что означает наличие четкого промежутка поперек или вверх / вниз таблицы), это позволило бы идентифицировать разрыв строки или столбца.

Идея действительно работает, но только иногда. Предполагается, что таблица имеет одинаковое количество и выравнивание ячеек по вертикали и горизонтали (простая сетка), и что между текстом соседних ячеек есть четкий зазор. Кроме того, если есть текст, который занимает несколько столбцов (например, заголовок над таблицей, нижний колонтитул под таблицей, объединенные ячейки и т. Д.), Идентификация разрывов столбцов затруднена - вы можете определить, какие текстовые элементы выше или ниже таблицы следует игнорировать, но я не смог найти хорошего подхода для работы с объединенными ячейками.

Когда пришло время посмотреть по горизонтали, чтобы определить разрывы строк, возникло несколько других проблем. Во-первых, pdfminer автоматически пытается сгруппировать фрагменты текста, расположенные рядом друг с другом, даже если они занимают более одной ячейки в таблице. В этих случаях BoundingBox для этого текстового объекта включает несколько строк, скрывая любые разрывы строк, которые могли быть пересечены. Даже если бы каждая строка текста была извлечена отдельно, проблема заключалась бы в том, чтобы различить, что было нормальным пространством, разделяющим последовательные строки текста, и что было разрывом строки.

Изучив различные обходные пути и проведя ряд тестов, я решил отступить и попробовать другой подход.

Таблицы, в которых были данные, необходимые для извлечения, имеют границы вокруг них, поэтому я решил, что смогу найти элементы в файле PDF, которые рисуют эти линии. Однако, когда я посмотрел на элементы, которые я мог извлечь из исходного файла, я получил удивительные результаты.

Вы могли подумать, что линии будут представлены как «линейный объект», но ошиблись (по крайней мере, для файлов, которые я просматривал). Если это не «линии», то, возможно, они просто рисуют прямоугольники для каждой ячейки, регулируя атрибут ширины линии, чтобы получить желаемую толщину линии, верно? Нет. Оказалось, что линии на самом деле были нарисованы как «прямоугольные объекты» с очень маленьким размером (узкая ширина для создания вертикальных линий или короткая высота для создания горизонтальных линий). И там, где кажется, что линии пересекаются в углах, прямоугольники нет - у них есть очень маленький прямоугольник, чтобы заполнить пробелы.

Как только я смог распознать, что искать, мне пришлось столкнуться с несколькими прямоугольниками, размещенными рядом друг с другом, чтобы создать толстые линии. В конце концов, я написал процедуру для группировки похожих значений и вычисления среднего значения, которое будет использоваться для разрывов строк и столбцов, которые я буду использовать позже.

Теперь дело было в обработке текста из таблицы. Я решил использовать базу данных SQLite для хранения, анализа и перегруппировки текста из файла PDF. Я знаю, что существуют и другие «питонические» варианты, и некоторые могут найти эти подходы более знакомыми и простыми в использовании, но я чувствовал, что объем данных, с которыми я буду иметь дело, лучше всего обрабатывать с помощью реального файла базы данных.

Как я упоминал ранее, pdfminer группирует текст, расположенный рядом друг с другом, и он может пересекать границы ячеек. Первоначальная попытка разделить фрагменты текста, показанные на отдельных строках в одной из этих текстовых групп, была лишь частично успешной; это одна из областей, которую я намерен развивать дальше (а именно, как обойти процедуру pdfminer LTTextbox, чтобы я мог получать части по отдельности).

Есть еще один недостаток модуля pdfminer, когда речь идет о вертикальном тексте. Мне не удалось определить какой-либо атрибут, который будет определять, когда текст расположен вертикально или под каким углом (например, +90 или -90 градусов) отображается текст. И процедура группировки текста, похоже, тоже не знает, что, поскольку текст повернут на +90 градусов (то есть повернут против часовой стрелки, когда буквы читаются снизу вверх), она объединяет буквы в обратном порядке, разделенные символами новой строки.

Приведенная ниже процедура работает довольно хорошо в данных обстоятельствах. Я знаю, что он все еще груб, есть несколько улучшений, и он не упакован таким образом, чтобы быть готовым к широкому распространению, но, похоже, он «сломал код» о том, как извлекать табличные данные из файла PDF (для большая часть). Надеюсь, другие смогут использовать это в своих целях и, возможно, даже улучшить.

Я приветствую любые идеи, предложения или рекомендации, которые могут у вас возникнуть.

РЕДАКТИРОВАТЬ: Я опубликовал исправленную версию, которая включает дополнительные параметры (cell_htol_up и т. Д.), Чтобы помочь «настроить» алгоритм относительно того, какие фрагменты текста принадлежат определенной ячейке в таблице.

# This was written for use w/Python 2.  Use w/Python 3 hasn't been tested & proper execution is not guaranteed.

import os                                                   # Library of Operating System routines
import sys                                                  # Library of System routines
import sqlite3                                              # Library of SQLite dB routines
import re                                                   # Library for Regular Expressions
import csv                                                  # Library to output as Comma Separated Values
import codecs                                               # Library of text Codec types
import cStringIO                                            # Library of String manipulation routines

from pdfminer.pdfparser import PDFParser                    # Library of PDF text extraction routines
from pdfminer.pdfdocument import PDFDocument, PDFNoOutlines
from pdfminer.pdfpage import PDFPage, PDFTextExtractionNotAllowed
from pdfminer.pdfinterp import PDFResourceManager, PDFPageInterpreter
from pdfminer.pdfdevice import PDFDevice
from pdfminer.layout import LAParams, LTTextBox, LTTextLine, LTFigure, LTImage, LTLine, LTRect, LTTextBoxVertical
from pdfminer.converter import PDFPageAggregator

#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

def add_new_value (new_value, list_values=[]):
    # Used to exclude duplicate values in a list
    not_in_list = True
    for list_value in list_values:
        # if list_value == new_value:
        if abs(list_value - new_value) < 1:
            not_in_list = False

    if not_in_list:
        list_values.append(new_value)

    return list_values

#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

def condense_list (list_values, grp_tolerance = 1):
    # Group values & eliminate duplicate/close values
    tmp_list = []
    for n, list_value in enumerate(list_values):
        if sum(1 for val in tmp_list if abs(val - list_values[n]) < grp_tolerance) == 0:
            tmp_val = sum(list_values[n] for val in list_values if abs(val - list_values[n]) < grp_tolerance) / \
                sum(1 for val in list_values if abs(val - list_values[n]) < grp_tolerance)
            tmp_list.append(int(round(tmp_val)))

    return tmp_list

#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

class UnicodeWriter:
    """
    A CSV writer which will write rows to CSV file "f", 
    which is encoded in the given encoding.
    """

    def __init__(self, f, dialect=csv.excel, encoding="utf-8", **kwds):
        # Redirect output to a queue
        self.queue = cStringIO.StringIO()
        self.writer = csv.writer(self.queue, dialect=dialect, quotechar = '"', quoting=csv.QUOTE_ALL, **kwds)
        self.stream = f
        self.encoder = codecs.getincrementalencoder(encoding)()

    def writerow(self, row):
        self.writer.writerow([unicode(s).encode("utf-8") for s in row])
        # Fetch UTF-8 output from the queue ...
        data = self.queue.getvalue()
        data = data.decode("utf-8")
        # ... and reencode it into the target encoding
        data = self.encoder.encode(data)
        # write to the target stream
        self.stream.write(data)
        # empty queue
        self.queue.truncate(0)

    def writerows(self, rows):
        for row in rows:
            self.writerow(row)

#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

# In case a connection to the database can't be created, set 'conn' to 'None'
conn = None

#^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
# Define variables for use later on
#_______________________________________________________________________________________________________________________

sqlite_file = "pdf_table_text.sqlite"                       # Name of the sqlite database file
brk_tol = 3                                                 # Tolerance for grouping LTRect values as line break points
                                                            # ***   This may require tuning to get optimal results   ***

cell_htol_lf = -2                                           # Horizontal & Vertical tolerances (up/down/left/right)
cell_htol_rt = 2                                            # for over-scanning table cell bounding boxes
cell_vtol_up = 8                                            # i.e., how far outside cell bounds to look for text to include
cell_vtol_dn = 0                                            # ***   This may require tuning to get optimal results   ***

replace_newlines = True                                     # Switch for replacing newline codes (\n) with spaces
replace_multspaces = True                                   # Switch for replacing multiple spaces with a single space

# txt_concat_str = "' '"                                    # Concatenate cell data with a single space
txt_concat_str = "char(10)"                                 # Concatenate cell data with a line feed

#=======================================================================================================================
# Default values for sample input & output files (path, filename, pagelist, etc.)

filepath = ""                                               # Path of the source PDF file (default = current folder)
srcfile = ""                                                # Name of the source PDF file (quit if left blank)
pagelist = [1, ]                                            # Pages to extract table data (Make an interactive input?)
                                                            # --> THIS MUST BE IN THE FORM OF A LIST OR TUPLE!

#=======================================================================================================================
# Impose required conditions & abort execution if they're not met

# Should check if files are locked:  sqlite database, input & output files, etc.

if filepath + srcfile == "" or pagelist == None:
    print "Source file not specified and/or page list is blank!  Execution aborted!"
    sys.exit()

dmp_pdf_data = "pdf_data.csv"
dmp_tbl_data = "tbl_data.csv"
destfile = srcfile[:-3]+"csv"

#=======================================================================================================================
# First test to see if this file already exists & delete it if it does

if os.path.isfile(sqlite_file):
    os.remove(sqlite_file)

#=======================================================================================================================
try:

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    # Open or Create the SQLite database file
    #___________________________________________________________________________________________________________________

    print "-" * 120
    print "Creating SQLite Database & working tables ..."

    # Connecting to the database file
    conn = sqlite3.connect(sqlite_file)
    curs = conn.cursor()

    qry_create_table = "CREATE TABLE {tn} ({nf} {ft} PRIMARY KEY)"
    qry_alter_add_column = "ALTER TABLE {0} ADD COLUMN {1}"

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    # Create 1st Table
    #___________________________________________________________________________________________________________________

    tbl_pdf_elements = "tbl_pdf_elements"                   # Name of the 1st table to be created
    new_field = "idx"                                       # Name of the index column
    field_type = "INTEGER"                                  # Column data type

    # Delete the table if it exists so old data is cleared out
    curs.execute("DROP TABLE IF EXISTS " + tbl_pdf_elements)

    # Create output table for PDF text w/1 column (index) & set it as PRIMARY KEY
    curs.execute(qry_create_table.format(tn=tbl_pdf_elements, nf=new_field, ft=field_type))

    # Table fields: index, text_string, pg, x0, y0, x1, y1, orient
    cols = ("'pdf_text' TEXT", 
            "'pg' INTEGER", 
            "'x0' INTEGER", 
            "'y0' INTEGER", 
            "'x1' INTEGER", 
            "'y1' INTEGER", 
            "'orient' INTEGER")

    # Add other columns
    for col in cols:
        curs.execute(qry_alter_add_column.format(tbl_pdf_elements, col))

    # Committing changes to the database file
    conn.commit()

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    # Create 2nd Table
    #___________________________________________________________________________________________________________________

    tbl_table_data = "tbl_table_data"                       # Name of the 2nd table to be created
    new_field = "idx"                                       # Name of the index column
    field_type = "INTEGER"                                  # Column data type

    # Delete the table if it exists so old data is cleared out
    curs.execute("DROP TABLE IF EXISTS " + tbl_table_data)

    # Create output table for Table Data w/1 column (index) & set it as PRIMARY KEY
    curs.execute(qry_create_table.format(tn=tbl_table_data, nf=new_field, ft=field_type))

    # Table fields: index, text_string, pg, row, column
    cols = ("'tbl_text' TEXT",
            "'pg' INTEGER",
            "'row' INTEGER",
            "'col' INTEGER")

    # Add other columns
    for col in cols:
        curs.execute(qry_alter_add_column.format(tbl_table_data, col))

    # Committing changes to the database file
    conn.commit()

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    # Start PDF text extraction code here
    #___________________________________________________________________________________________________________________

    print "Opening PDF file & preparing for text extraction:"
    print " -- " + filepath + srcfile

    # Open a PDF file.
    fp = open(filepath + srcfile, "rb")

    # Create a PDF parser object associated with the file object.
    parser = PDFParser(fp)

    # Create a PDF document object that stores the document structure.

    # Supply the password for initialization (if needed)
    # document = PDFDocument(parser, password)
    document = PDFDocument(parser)

    # Check if the document allows text extraction. If not, abort.
    if not document.is_extractable:
        raise PDFTextExtractionNotAllowed

    # Create a PDF resource manager object that stores shared resources.
    rsrcmgr = PDFResourceManager()

    # Create a PDF device object.
    device = PDFDevice(rsrcmgr)

    # Create a PDF interpreter object.
    interpreter = PDFPageInterpreter(rsrcmgr, device)

    # Set parameters for analysis.
    laparams = LAParams()

    # Create a PDF page aggregator object.
    device = PDFPageAggregator(rsrcmgr, laparams=laparams)
    interpreter = PDFPageInterpreter(rsrcmgr, device)

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    # Extract text & location data from PDF file (examine & process only pages in the page list)
    #___________________________________________________________________________________________________________________

    # Initialize variables
    idx1 = 0
    idx2 = 0
    lastpg = max(pagelist)

    print "Starting text extraction ..."

    qry_insert_pdf_txt = "INSERT INTO " + tbl_pdf_elements + " VALUES(?, ?, ?, ?, ?, ?, ?, ?)"
    qry_get_pdf_txt = "SELECT group_concat(pdf_text, " + txt_concat_str + \
        ") FROM {0} WHERE pg=={1} AND x0>={2} AND x1<={3} AND y0>={4} AND y1<={5} ORDER BY y0 DESC, x0 ASC;"
    qry_insert_tbl_data = "INSERT INTO " + tbl_table_data + " VALUES(?, ?, ?, ?, ?)"

    # Process each page contained in the document.
    for i, page in enumerate(PDFPage.create_pages(document)):

        interpreter.process_page(page)

        # Get the LTPage object for the page.
        lt_objs = device.get_result()
        pg = device.pageno - 1                              # Must subtract 1 to correct 'pageno'

        # Exit the loop if past last page to parse
        if pg > lastpg:
            break

        #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        # If it finds a page in the pagelist, process the contents

        if pg in pagelist:
            print "- Processing page {0} ...".format(pg)

            xbreaks = []
            ybreaks = []

            #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
            # Iterate thru list of pdf layout elements (LT* objects) then capture the text & attributes of each

            for lt_obj in lt_objs:

                # Examine LT objects & get parameters for text strings
                if isinstance(lt_obj, LTTextBox) or isinstance(lt_obj, LTTextLine):
                    # Increment index
                    idx1 += 1

                    # Assign PDF LTText object parameters to variables
                    pdftext = lt_obj.get_text()             # Need to convert escape codes & unicode characters!
                    pdftext = pdftext.strip()               # Remove leading & trailing whitespaces

                    # Save integer bounding box coordinates: round down @ start, round up @ end
                    # (x0, y0, x1, y1) = lt_obj.bbox
                    x0 = int(lt_obj.bbox[0])
                    y0 = int(lt_obj.bbox[1])
                    x1 = int(lt_obj.bbox[2] + 1)
                    y1 = int(lt_obj.bbox[3] + 1)

                    orient = 0                              # What attribute gets this value?

                    #---- These approaches don't work for identifying vertical text ... --------------------------------

                    # orient = lt_obj.rotate
                    # orient = lt_obj.char_disp

                    # if lt_obj.get_writing_mode == "tb-rl":
                        # orient = 90

                    # if isinstance(lt_obj, LTTextBoxVertical): # vs LTTextBoxHorizontal
                        # orient = 90

                    # if LAParams(lt_obj).detect_vertical:
                        # orient = 90

                    #---------------------------------------------------------------------------------------------------
                    # Split text strings at line feeds

                    if "\n" in pdftext:
                        substrs = pdftext.split("\n")
                        lineheight = (y1-y0) / (len(substrs) + 1)
                        # y1 = y0 + lineheight
                        y0 = y1 - lineheight
                        for substr in substrs:
                            substr = substr.strip()         # Remove leading & trailing whitespaces
                            if substr != "":
                                # Insert values into tuple for uploading into dB
                                pdf_txt_export = [(idx1, substr, pg, x0, y0, x1, y1, orient)]

                                # Insert values into dB
                                curs.executemany(qry_insert_pdf_txt, pdf_txt_export)
                                conn.commit()

                            idx1 += 1
                            # y0 = y1
                            # y1 = y0 + lineheight
                            y1 = y0
                            y0 = y1 - lineheight

                    else:
                        # Insert values into tuple for uploading into dB
                        pdf_txt_export = [(idx1, pdftext, pg, x0, y0, x1, y1, orient)]

                        # Insert values into dB
                        curs.executemany(qry_insert_pdf_txt, pdf_txt_export)
                        conn.commit()

                elif isinstance(lt_obj, LTLine):
                    # LTLine - Lines drawn to define tables
                    pass

                elif isinstance(lt_obj, LTRect):
                    # LTRect - Borders drawn to define tables

                    # Grab the lt_obj.bbox values
                    x0 = round(lt_obj.bbox[0], 2)
                    y0 = round(lt_obj.bbox[1], 2)
                    x1 = round(lt_obj.bbox[2], 2)
                    y1 = round(lt_obj.bbox[3], 2)
                    xmid = round((x0 + x1) / 2, 2)
                    ymid = round((y0 + y1) / 2, 2)

                    # rectline = lt_obj.linewidth

                    # If width less than tolerance, assume it's used as a vertical line
                    if (x1 - x0) < brk_tol:                 # Vertical Line or Corner
                        xbreaks = add_new_value(xmid, xbreaks)

                    # If height less than tolerance, assume it's used as a horizontal line
                    if (y1 - y0) < brk_tol:                 # Horizontal Line or Corner
                        ybreaks = add_new_value(ymid, ybreaks)

                elif isinstance(lt_obj, LTImage):
                    # An image, so do nothing
                    pass

                elif isinstance(lt_obj, LTFigure):
                    # LTFigure objects are containers for other LT* objects which shouldn't matter, so do nothing
                    pass

            col_breaks = condense_list(xbreaks, brk_tol)    # Group similar values & eliminate duplicates
            row_breaks = condense_list(ybreaks, brk_tol)

            col_breaks.sort()
            row_breaks.sort()

            #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
            # Regroup the text into table 'cells'
            #___________________________________________________________________________________________________________

            print "  -- Text extraction complete. Grouping data for table ..."

            row_break_prev = 0
            col_break_prev = 0

            table_data = []
            table_rows = len(row_breaks)
            for i, row_break in enumerate(row_breaks):
                if row_break_prev == 0:                             # Skip the rest the first time thru
                    row_break_prev = row_break
                else:
                    for j, col_break in enumerate(col_breaks):
                        if col_break_prev == 0:                     # Skip query the first time thru
                            col_break_prev = col_break
                        else:
                            # Run query to get all text within cell lines (+/- htol & vtol values)
                            curs.execute(qry_get_pdf_txt.format(tbl_pdf_elements, pg, col_break_prev + cell_htol_lf, \
                                col_break + cell_htol_rt, row_break_prev + cell_vtol_dn, row_break + cell_vtol_up))

                            rows = curs.fetchall()                  # Retrieve all rows

                            for row in rows:
                                if row[0] != None:                  # Skip null results
                                    idx2 += 1
                                    table_text = row[0]
                                    if replace_newlines:            # Option - Replace newline codes (\n) with spaces
                                        table_text = table_text.replace("\n", " ")

                                    if replace_multspaces:          # Option - Replace multiple spaces w/single space
                                        table_text = re.sub(" +", " ", table_text)

                                    table_data.append([idx2, table_text, pg, table_rows - i, j])

                        col_break_prev = col_break

                row_break_prev = row_break

            curs.executemany(qry_insert_tbl_data, table_data)
            conn.commit()

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    # Export the regrouped table data:

    # Determine the number of columns needed for the output file
    # -- Should the data be extracted all at once or one page at a time?

    print "Saving exported table data ..."

    qry_col_count = "SELECT MIN([col]) AS colmin, MAX([col]) AS colmax, MIN([row]) AS rowmin, MAX([row]) AS rowmax, " + \
        "COUNT([row]) AS rowttl FROM [{0}] WHERE [pg] = {1} AND [tbl_text]!=' ';"

    qry_sql_export = "SELECT * FROM [{0}] WHERE [pg] = {1} AND [row] = {2} AND [tbl_text]!=' ' ORDER BY [col];"

    f = open(filepath + destfile, "wb")
    writer = UnicodeWriter(f)

    for pg in pagelist:
        curs.execute(qry_col_count.format(tbl_table_data, pg))
        rows = curs.fetchall()

        if len(rows) > 1:
            print "Error retrieving row & column counts!  More that one record returned!"
            print " -- ", qry_col_count.format(tbl_table_data, pg)
            print rows
            sys.exit()

        for row in rows:
            (col_min, col_max, row_min, row_max, row_ttl) = row

        # Insert a page separator
        writer.writerow(["Data for Page {0}:".format(pg), ])

        if row_ttl == 0:
            writer.writerow(["Unable to export text from PDF file.  No table structure found.", ])

        else:
            k = 0
            for j in range(row_min, row_max + 1):
                curs.execute(qry_sql_export.format(tbl_table_data, pg, j))

                rows = curs.fetchall()

                if rows == None:                            # No records match the given criteria
                    pass

                else:
                    i = 1
                    k += 1
                    column_data = [k, ]                     # 1st column as an Index

                    for row in rows:
                        (idx, tbl_text, pg_num, row_num, col_num) = row

                        if pg_num != pg:                    # Exit the loop if Page # doesn't match
                            break

                        while i < col_num:
                            column_data.append("")
                            i += 1
                            if i >= col_num or i == col_max: break

                        column_data.append(unicode(tbl_text))
                        i += 1

                    writer.writerow(column_data)

    f.close()

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    # Dump the SQLite regrouped data (for error checking):

    print "Dumping SQLite table of regrouped (table) text ..."

    qry_sql_export = "SELECT * FROM [{0}] WHERE [tbl_text]!=' ' ORDER BY [pg], [row], [col];"
    curs.execute(qry_sql_export.format(tbl_table_data))
    rows = curs.fetchall()

    # Output data with Unicode intact as CSV
    with open(dmp_tbl_data, "wb") as f:
        writer = UnicodeWriter(f)
        writer.writerow(["idx", "tbl_text", "pg", "row", "col"])
        writer.writerows(rows)

    f.close()

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    # Dump the SQLite temporary PDF text data (for error checking):

    print "Dumping SQLite table of extracted PDF text ..."

    qry_sql_export = "SELECT * FROM [{0}] WHERE [pdf_text]!='  ' ORDER BY pg, y0 DESC, x0 ASC;"
    curs.execute(qry_sql_export.format(tbl_pdf_elements))
    rows = curs.fetchall()

    # Output data with Unicode intact as CSV
    with open(dmp_pdf_data, "wb") as f:
        writer = UnicodeWriter(f)
        writer.writerow(["idx", "pdf_text", "pg", "x0", "y0", "x1", "y2", "orient"])
        writer.writerows(rows)

    f.close()

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    print "Conversion complete."
    print "-" * 120

except sqlite3.Error, e:

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    # Rollback the last database transaction if the connection fails
    #___________________________________________________________________________________________________________________

    if conn:
        conn.rollback()

    print "Error '{0}':".format(e.args[0])
    sys.exit(1)

finally:

    #^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    # Close the connection to the database file
    #___________________________________________________________________________________________________________________

    if conn:
        conn.close()
person Big_Al_Tx    schedule 23.08.2017