Back to top: 23. Extra-Unit Programs
23.1: Overview
These programs are run outside the excavation units. The results are utilized in different ways.
The first two programs generate J files that are used by the individual units (the J files are placed in their EXOGEN folder). They also generate files that are for general use, both on an ad hoc basis (e.g., the photographer can check whether the photo of a given item has already been taken) and for use within the MZ sitewide book.
The other programs generate files that are for use outside the individual excavation units.
Back to top: 23. Extra-Unit Programs
23.2: TP: typology of pottery
The program takes as a starting point an Excel file (see FORMS F20 and F21 in section 13.2) that follows the exact format of the pottery encoding sheets, for either body or shape sherds. This file must first exported as a text file, and given a different extension.
The J file it generates allows the individual unit books to integrate into the record the full details of pottery analysis.
Input
See under “Secondary Input” (section 5.9) for input.
The input file must contain data belonging to only a single book (e.g., J3).
Save the Excel file as a text file (tab delimited, answer YES to the question about incompatible features). Change the filename to a name of the type J03PQ3A1.TP.
| J03 | book (for Outer City books it will not be possible to have a sequential index | |
| P | pottery | |
| Q3A | date: for day 1-9 enter the digit, for later days, enter a letter as follows: A=10, B=11, C=12, etc. (hence Q3A stands for Q310, or March 10, 2006) | |
| 1 | sequential index (used when more than one file is processed for the same book in the same day) |
The .TP file must be placed in a folder of the type TP\TP-INPUT\J03.
Output
The TP program converts the file to a.J format, with extension.TP2 and places the new file (e.g.,J03PQ3A1.TP2)in the same directory (TP\TP-INPUT\J03). It changes the extension of the original file from.TP to.-TP.
Move the newly created.TP2 file to the exogen folder of the pertinent book. The unit will change the extension to.J and process it as a normal.J file.
Back to top: 23. Extra-Unit Programs
23.3: TZ-KN: produces Excel file from KNOCOD
The program produces a single Excel file from a .SKE (and eventually other) files as outputted by KNOCOD program.
It is tied to KNOCOD unit numbers, that have to be translated to qb lot numbers. It is best to have lot numbers (rather than features) because then one can have photos of individual bones as components tied to numbering system.
Back to top: 23. Extra-Unit Programs
23.4: VWX: produces indices from V and W books and input .J files for unit books (white on black)
The program produces overall indices by photo and by view/item for any given V or W book, and new J files for individual books within its own subfolder UNITBKS.
The program is run by the photo registrar, who then sends the resulting J files to the EXOGEN folder of the pertinent book.
It also produces the filelists within the individual V or W books, which are required by the JD suite.
It further produces two HTML files for the sitewide index of photographs and drawings (within the book XVW): VWX-TOC.HTM and VWX-TOT.HTM. These are stored within the book XVW.
The indices are kept by the photo registrar for general use and for integration in the MZ sitewide book.
Input
To run the program, it must be started with batch file VWX.BAT.
First, the program produces filelists (VWX1.TXT) for each individual folder within a given V or W book.
The program uses file …\G\LoRes\VWX1.TXT as input. It is created by the batch file VWX.BAT within directory of type V13\G\LoRes (see above, 6.4.1).
The program uses the file \MZ\A\XVW\VWX\VWX-ALL.PRU as a starting point for the cumulative index of all photos and drawings.
The program accepts only a path of the type \MZ\A\V14\G\LoRes\L_V14d40 and a filename of the type L_V14d4002 A16v89a M903 gg x x.JPG (x x are optional fields).
Operations
The program asks for a cut-off date. This is the date after the one when the previous program has been run. If no cut-off date is specified, all files are processed.
\MZ\A\XVW\VWX\VWX-ALL.PRU must be available to the local computer (for photos or for drawings) in order to update it.
The file \MZ\A\XVW\VWX\VWX-ALL.PRU plus the entire XVW\VWX folder must be copied to the server from the [… TEXT TO BE COMPLETED?, ZGz20 mDP].
Output
The program creates files of the following type:
| Index file by photo: | \MZ\A\V18\G\LoRes\V18-Q419.TXT | |
| Index file by view/item: | \MZ\A\V18\G\LoRes\V18-Q419.TXT | |
| Cumulative index: | \MZ\A\XVW\VXW-ALL.PRU | |
| ToC for Mozan Sitewide | \MZ\A\XVW\VWX\VXW-TOC.HTM | |
| Totals for Mozan Sitewide | \MZ\A\XVW\VWX\VXW-TOT.HTM | |
| Discards: | \MZ\A\V18\G\LoRes\V18-Q419.DIS | |
| Errors: | \MZ\A\V18\G\LoRes\V18-Q419.ERR | |
| J-files for other books: | \MZ\A\V18\G\LoRes\UNITBKS | |
| Filelists: | \MZ\A\V18\G\LoRes\FILELIST |
Sample output for file in Unitbooks:
.bk J03
.fl J03VQ7A.J
.fd photos for views and items from V directory V18
.fn Cut-off date: none
.rd Q710
.ri !!!
.rd P801
.ri dm
v 0010a
B1 L_V18d3002 J3v10a P801 dM.jpg
B2 0010a L_V18d3002 J3v10a P801 dM.jpg
The J files in the UNITBOOKS folder are to be entered in the EXOGEN folder of the pertinent book for processing within that book.
Back to top: 23. Extra-Unit Programs
23.5: VWH: produces HTML for photos and drawings
Input
[TEXT TO BE WRITTEN, ZGz20 mDP]
Operations
[TEXT TO BE WRITTEN, ZGz20 mDP]
Output
[TEXT TO BE WRITTEN, ZGz20 mDP]
Back to top: 23. Extra-Unit Programs
23.6: M: produces Y01\O.O files in Y01\O\M
Input
The program uses the input of the .M files (above, 4.6.9).
Operations
No special condition.
Output
The program creates a set of individual .O files in the Y01\O\M directory, and updates a cumulative index of markers as Y01\O\M-M.X. The individual marker files are used by the JD suite to calculate the coordinates taken through relays, and by the MOD program to create individual marker files for display.
Sample output for .O file:
m 2527
B01 Rebar on grid 10m W.2517
D04 41128
D05 36811
D06 8756
Sample output for –M.X file:
Y01m | North | East | elev | comments |
||||
2500 | 41869 | 37508 | 9097 | NWS A16 Nblk K1 |
||||
2501 | 41514 | 37485 | 9015 | NWS A16 Eblk K1 |
||||
2502 | 41212 | 37317 | 8905 | NWS A16 Eblk K4 |
Back to top: 23. Extra-Unit Programs
23.7: MOD: produces Y01\D.HTM files from O\M
Input
[TEXT TO BE WRITTEN, ZGz20 mDP]
Operations
[TEXT TO BE WRITTEN, ZGz20 mDP]
Output
[TEXT TO BE WRITTEN, ZGz20 mDP]
Back to top: 23. Extra-Unit Programs
23.8: CerPhaS: produces CERAMICS\TEXTS\C2.HTM files from O
The program produces ceramics overall indices by phase/stratum/shape, a spreadsheet of the data and information of each phase/stratum/shape.
To run the program execute \PA\CerPhaS\CerPhaS.py.
Input
All files in EXOGEN\STRATA\ as the input list of sherds.
For each sherd, data O files are read (from \MZ\A..).
Abbreviation conversion from \PA\UGR_lexica.txt and \MZ\A\MZ\TEXTS\A2\mza-lexicon.txt.
Operations
No special condition.
Output
HTML files: \MZ\A\CERAMICS\TEXTS\C2\index.htm, \MZ\A\CERAMICS\TEXTS\C2\index_vessel.htm, for each phase/stratum/shape a file in \MZ\A\CERAMICS\TEXTS\C2\strata\.<
Tab separated spreadsheet: \MZ\A\CERAMICS\TEXTS\C2\database\spreadsheet.txt.
Lists of errors found: \MZ\A\CERAMICS- non-canonical\to be checked - CerPhaS\.
Console log: \PA\CerPhaS\CerPhaS.log.
Back to top: 23. Extra-Unit Programs