The Grammar of the Archaeological Record

2. The Manual

3. Folders and Files

Contents

Giorgio Buccellati – June 2010

Back to top: 3. Folders and Files

3.1: Input folders

The parent folder for everything being produced is \MZ\A (for Mozan\Archive).

Under it, there is a folder labeled after each unit (e.g., \MZ\A\A01 or \MZ\A\V19).

All input data for the stratigraphic units are within a folder labeled I (for Input).

The primary folder is I\J (for Input\Journal). This is the only folder accessed by the JD program suite, which produces the browser edition.

The I\R folder (for Input\Relays) contains the files that include the data input for relays. These files are processed by the RD program (see 22.3 and 22.11, for R and D programs, respectively), which produces a pertinent J file within the I\J folder, and also goes through all other intermediate steps all the way up to the browser edition.

The I\E folder (for Input\Entry Point) contains files that represent an intermediate output ready for further processing. This output has been automatically checked for format errors, and is ready for further processing. This is a blind output, in the sense that users need not refer to it. Files in the folder may be deleted at any time.

Input data that come to a stratigraphic unit from outside sources (e.g., from the photographer or from a typological specialist) are placed in the folder I\EXOGEN (for exogenous). It is the responsibility of unit directors to check these files and place them in the I\J folder for processing.

Back to top: 3. Folders and Files

3.2: Input files

The details of input file format and structure are given below in chapters 4, 5, and 6.

Back to top: 3. Folders and Files

3.3: Definition files

Definition files are entered manually in folder \MZ\DEPOT and provide data for programs to function automatically.

Back to top: 3. Folders and Files

3.3.1: -BOOK.DEF

The file -BOOK.DEF is used by all programs. Only one book can serve as default on any given drive. It is placed in the \MZ\DEPOT folder.

\-BOOK.DEF
A16    [book – required – no other entries]

Back to top: 3. Folders and Files

3.3.2: V-FILES.TXT and W-FILES.TXT

The files V-FILES.TXT and W-FILES.TXT are placed in the TEXTS\DF-FILES folder. Both are used by the JD5-B program.

Both files must be updated as new folders become available with either photos or drawings.

If no photos or drawings are available (thus regularly at the beginning of the season), the files V-FILES.TXT and/or W-FILES.TXT must still be placed as blank files in the TEXTS\DF-FILES. Otherwise, the program will stop and remind the user that the files are needed.

\MZ\A\A16\TEXTS\DF-FILES\V-FILES.TXT
'V folders for A16
'Oy13 gb
[All folders that contain files pertinent for a given book are listed below]
V14d40
V14d41
V14d42
V14d45
V14k50
V15d40
V15d41
V15d45
V15d46
V15d47
V16d50
V16d51



\MZ\A\A16\ TEXTS\DF-FILES \W-FILES.TXT
'W folders for A16
'Oy18 gb
W14a40
W14b40
W14c40
W14c45
W14c71
W14d40
W14d41
W14d42
W14d71
W15c40
W15c42
W15c43
W15c45
W15d45
W15d46
W16b50
W16b51
W16c54
W16d50
W16d51
W16d52
W16d53

Back to top: 3. Folders and Files

3.3.3: -VWX.DEF

The file -VWX.DEF is used by the VWX program. Only one book can serve as default on any given drive. It is placed in the root directory.

V18

Back to top: 3. Folders and Files

3.4: Blind index files

Some files are generated by programs to be used by other programs. They entail no data entry procedures – in this sense they are considered “blind.” They are described here for the programmer’s use, and to explain why these files appear in the record. They are all placed in the \MZ\DEPOT folder.

Back to top: 3. Folders and Files

3.4.1: File placed by JD1-J program in root folder

The file J-TEMP.TXT lists the book, the .E file label, the path and file label for the summary file, and the starting time. It is used by all subsequent programs in the suite. Each new file erases the previous one.

       J03
       Q3311220.E
       \MZ\A\J03\SUMMARY\Q3311220.TXT
       no     [stops between programs – not actually in use]
       12:20:44     [starttime]
       n     [do not process indices]

Back to top: 3. Folders and Files

3.4.2: File placed by JD1-J program in SUMMARY

The file\MZ\A\J03\SUMMARY\Q3311220.TXT (see 4.1) is updated by each subsequent program in the JD suite, and is used by the final program in the suite. In its final version it has the following format:


       Date: 03-31-2006
       Time started: 12:20:40
       Book: J03
       - INPUT
       Input path: \MZ\A\J03\I\J
       Input file(s): Q331GB.J
       Total input file(s): 1
       Entry level file: \MZ\A\J03\I\E\Q3311220.E
       Total entries processed: 21

       Output path: \MZ\A\J03\O
       Output folders: F I
       Total output files produced: 2 (2 new and 0 updates)

Back to top: 3. Folders and Files

3.4.3: Files placed by JD2-E program in root folder

The file E-FOR-O.TXT lists all the constituents treated in any given run of the E program. Each new file erases the previous one.

E-FOR-O.TXT
J02
\mz\a\J02\SUMMARY\Py030951.TXT
09:51:28
F
     0032
     0074
     0085
I
     0031
     0004
     0005
K
     0003
     0004
     0005
Q
     0174
     0178
     0182
     0331
QI
     017411
     017801
     018201
V
     0001
     0002
     002A

Back to top: 3. Folders and Files

3.4.4: Files placed by JD2-E program in I\E

INIT-ALL.TXT
gb ^V0035 ^B01 ^O725 ^L_V17d0182 J02v35 O727 gg x k5 e section [J02PXVV.J]
ap ^V0035 ^B01 ^O727 ^L_V17d0183 J02v36 O727 ap x section.jpg [J02PXVV.J]
fab ^V0037 ^B01 ^O731 ^L_V17d0184 J02v37 O731 fab.jpg [J02PXVV.J]
fab ^V0038 ^B01 ^O731 ^L_V17d0185 J02v38 O731 fab.jpg [J02PXVV.J]
fab ^V0039 ^B01 ^O731 ^L_V17d0186 J02v39 O731 fab.jpg [J02PXVV.J]
fab ^V0040 ^B01 ^O731 ^L_V17d0187 J02v40 O731 fab.jpg [J02PXVV.J]
gg ^V0041 ^B01 ^O729 ^L_V17d0188 J02v41 O729 gg.jpg [J02PXVV.J]



INIT-FIL.TXT
gb ^J02PXVV.J
ap ^J02PXVV.J
fab ^J02PXVV.J
fab ^J02PXVV.J
fab ^J02PXVV.J
fab ^J02PXVV.J
gg ^J02PXVV.J

Back to top: 3. Folders and Files

3.4.5: Files placed by JD2-E program in O

-FILEREF.SRT
J02Pxvv.J photos for views and items from V directoryV17 Cut-off date: none    
O707ap2.j daily journal, descriptions of f 33-46.   O710 ap
O710ap.j objects description   O710 ap
O710mh3.j aggregate log O710   O710 mh
O811ap.j view log (v43-v72)   O811 ap
TMPL-Pxq.J templates as of 10-26-2005      

Back to top: 3. Folders and Files

3.4.6: Files placed by JD3-O program in D\X\LABELS

All constituents found in the data generate a file with the constituent’s label in first position, hence F-LOG.TXT, I-LOG.TXT, etc.

F-LOG.TXT
0001
0002
0003
0004
0005
0006

Back to top: 3. Folders and Files

3.4.7: Files placed by JD3-O program in O

The file O-FILES.TXT is used by the OX program, to determine which files to open. This file is updated each time the JD suite is run, and remains always active.

O-FILES.TXT
a0007
a0008
f0005
f0018
i0001
i0002
q0062
q0066
qi006201
qi006202
v0001
v0002
v0002A

Back to top: 3. Folders and Files

3.4.8: Files placed by JD4-X program in O\X

Back to top: 3. Folders and Files

First output

CK: these files are used by MZX program first output:

O\X\SPREAD\SPREADF.TXT
0035 ^lense A ^ ^ ^ ^
0036 ^topsoil ^ ^ ^ ^
0037 ^lense D ^ ^ ^ ^
0038 ^topsoil ^ ^ ^ ^

Back to top: 3. Folders and Files

Parallel output

Parallel output – to be introduced if opening files during first output causes too many files:

O\X\XDF-FA.TXT
collapse ^a ^0006
pit ^a ^0007
lense A ^f ^0035
lense D ^f ^0037
topsoil ^f ^0038

Back to top: 3. Folders and Files

Second output

Decond output, sort of preceding:

O\X\XDF-FA.SRT
collapse ^a0006
lense A ^f0035
lense D ^f0037
pit ^a0007
topsoil ^f0036
topsoil ^f0038

Back to top: 3. Folders and Files

Third output

Third output, individual categories:

O\X\DEF\INDIV-FA\TOPSOIL.HTM
f0036
f0038

Back to top: 3. Folders and Files

3.4.9: File placed by the RD and PTD programs in root folder

\RPTforJ.TXT

Invoked and then deleted by JD program.

Back to top: 3. Folders and Files

3.5 Common files

There are two types of ContractDate.

[TEXT TO BE COMPLETED; ZGz05 mDP]

Back to top: 3. Folders and Files