[Up][Contents][Index]

Entering Information

As has been explained in the Program Operation information can either be entered using the Windows interface (which is fairly self explanatory) or in the form of commands in a run file. The `CQL Command Summary' section gives a complete description of how each of the command is used and shows the icon used in the Windows interface. In this section only the commands will be referred to for reasons of brevity. If you cannot find the appropriate icon for any operation in the selection tree you should look it up in the `CQL Command Summary'.

In addition to the information here you should now be in a position to make sense of the commands given in the section on `Archaeological Considerations' and you should also be able to call up the example run files either using the button or simply by clicking on the example file icon in this manual.


Chronological Information

This is normally entered using R_Date in the case of radiocarbon dates and C_Date for calendar dates. If the errors on calendar dates are asymmetric (such as 1066+100-60) they can also be entered using C_Date (as in C_Date 1066 100 60;). Radiocarbon dates are always entered in radiocarbon years BP. Calendar dates can be either entered as BP or AD depending on the setting of the options set. If you are using BC/AD, BC dates should be entered as negative numbers thus C_Date -100 10 implies a calendar date of 100BC with a ten year error.

Within multi-plots or other groups dates can be offset using the Offset command. For example a carved piece of wood thought to be 60+-10 years old at the time of felling might have been radiocarbon dated. A probability distribution for its felling date would then be given by the two commands:

R_Date 980 50; 
Offset 60 10;
Note that the offset is positive to produce a later probability distribution.

Luminescence dates are another type of chronological information that can be entered. Assuming you are not simply entering them as calendar ages, the year of measurement, dose rate and error in the dose rate must be entered. Instead of entering the calendar ages you can then enter the sample estimated doses (prefixed by `d'). For example:

Plot
{
 Year 1994;
 Dose 2.0e-3;
 Error 5%;
 C_Date d1.0 d0.2;
 C_Date d1.1 d0.2;
 C_Date d1.3 d0.2;
};
In this case the first date will be calculated from the dose rate to be 500+-100 years before 1994 and then an additional error of 5% added in. The error is always given in terms of a percentage as above or as a proportion (as in Error 0.05;). If the error is defined within a combination (Combine) it will not be applied until after the combination has been performed.

Dating Simulation

To use the radiocarbon dating simulation procedure use R_Simulate giving the calendar age expected and the precision expected from the radiocarbon lab. Thus for a date in the British Iron Age you might try:
R_Simulate -500 60;
In this case you will find that the errors associated with the radiocarbon dates are always large. Every time you recalculate this you will get a different radiocarbon date (with a similar distribution to the measurements you would expect to get).

See also [Archaeological Considerations]


Combinations

Combinations of all kinds can be performed with Combine. If radiocarbon dates are to be combined before calibration R_Combine should be used and if you wish to combine calendar ages with a chi squared test you should use C_Combine. The command Sum can be used if you wish to average distributions (equally weighted) to arrive at a frequency distribution (this does not relate to a single event). An agreement index is produced for combinations of distributions.

See also [Archaeological Considerations]


Stratigraphic Information

This sort of information can usually simply be entered using nested sequences and phases with associated boundaries (Sequence, Phase and Boundary). In a sequence you can also ensure that there is a gap by using a Gap command.

Note that groups or related events (coming from one period) should be enclosed with boundaries. The 'Auto Boundary' feature of the program is designed to help with this. When you add a phase or a model the program asks whether the group is a well defined separate group (rather than being just a part of a larger group). If you answer yes the phase or sequence will be bracketted by boundaries.

Within sequences termini ante quem and termini post quem can be defined using TAQ and TPQ.

The special case of `wiggle-matching' is covered by the defined sequence command (D_Sequence). In such a group each item must be separated by a Gap command giving the separation between the measured samples. The same calculation can also be performed in a slightly different way using Combine (see D_Sequence). The similar case of sequences where the gap is only know approximately is covered by the variable sequence command (V_Sequence) within which each item must be separated by a gap with an error term.

It is also possible to put extra constraints on a date by referring to it in more than one place using the command XReference. Consider the example from `Archaeological Considerations':

Sequence
{
 R_Date "A" 900 30;
 R_Date "B" 830 60;
};
Sequence
{
 R_Date "C" 940 60;
 TPQ
 {
  XReference "A";
 };
 R_Date "D" 890 70;
};
Here: A must be before B and D; B must be after A; C must be before D; D must be after A and C.

NOTE: that cross references can be conveniently entered using the Windows interface by holding down the [Ctrl] key and dragging from the cross reference to the new position.

See also [Archaeological Considerations]


Requesting additional information from analysis

Another aspect of entering the data is deciding what additional information will be required from the analysis.

Three types of information can be requested for any group of dates (in a phase, sequence etc) the probability distribution for the first date (First) the last (Last) and the difference between the two (Span). It is also possible to request the interval between items in a sequence using Interval or the difference between any two dates using Difference.

So as an example where they have all been requested one might have:

Sequence
{
 R_Date "K" 2760 60;
 Interval "I";
 Phase "1"
 {
  First "B";
  R_Date "L" 2700 50;
  R_Date "M" 2800 60;
  Last "E";
  Span "S";
 };
 R_Date "N" 2670 60;
 R_Date "O" 2660 60;
 Difference "D" "N" "K";
};
In this example the distributions B and E will be plotted with the distributions for K, L, M, N and O which are produced by the analysis. Distributions I (which gives the interval between K and the first item in phase 1), S (which gives the span of phase 1) and D (the time between K and N) will all be plotted on a separate page of the analysis output since they represent age differences rather than absolute ages.

NOTE: that to enter the paramters for Difference using the Windows interface you can just hold down the [Ctrl] key and drag the parameters onto the (expanded) icon. See also Shift.

If you wish to question the presence of a item in a sequence this is done by ending the command with a `?' instead of a `;' or drag over the icon. This removes the constraints imposed by the position of this sample in the sequence and tells the analysis program to calculate the probability that a sample should be in this position in the sequence (see section on `Probability and agreement indices' and Question).

Correlations between two events can be plotted using Correlate this gives plots of like:


Probabilities of being before and after events

Two functions are also provided for calculating probability distributions for years being before (Before) or after (After) an event or group of events. Consider, for example, a radiocarbon date for an event: we wish to find a probability distribution which covers the period after the event; this will be given by A calculated by the following commands:
After "A" {R_Date 3050 60;};
The main use for such distributions is for use in combinations where you might wish to add into a probability distribution the fact that the event must be after or before another.

Ordering of events

A command Order can be used to estimate the probabilities of all possible orders of a series of events. This grouping can be used in exactly the same way as Phase. As a simple example the following sequence of commands:
Order
{
 R_Date "A" 1100 50;
 R_Date "B" 1000 50;
 R_Date "C" 900 50;
};
gives the resultant probabilities:
 74.2% A B C 
 20.4% A C B 
  5.1% B A C 
  0.1% B C A 
  0.1% C A B 
Note that probabilities below 0.1% are not shown and that a maximum of 50 different orders are reported. There is also a limit of 50 on the number of items that can be ordered in this way.

See also [Archaeological Considerations]


Adding extra plotting instructions

At the data entry stage you can also decide on some aspects of the final plots. Page breaks can be put into multi-plots with Page, horizontal dividing lines with Line and visible comments with Label. The axes can also be defined by using Axis.

Removing lines from a command file

Lines can be temporarily removed from a command line by starting the line with an `!'. This allows comments to be added to a run file and lets temporary changes be made without loosing the input data (see also Comment).