What´s new in CDendro version 7.3?
News as of February 2010

Windowslist menu command

New menu command "Windowslist" opens a separate persistent window (floats above all other CDendro windows) where all open samples and collections are listed. Switch to another sample by clicking on an item in the list!

Right click on an item to make that sample your reference!
Switch the current reference to another one but keep anyhow your current sample in view - even the offset and horizontal scroller will update as recently set towards that reference.

All this implies that you can conveniently work with a sample in maximized windows mode and still have a list in sight of your currently open samples and collections.

SECONDARY reference
The normalized curve of a SECONDARY reference can be shown. This is useful when you sometimes want to look at three matching curves at the same time. To set a sample as the secondary reference, see first that its offset is correct relative to the main reference. Then right-click on the Select as reference button below the curve diagram. (The button has a tooltip about this.)
To release the secondary reference, use the menu command Samples/Set no Secondary reference selected.
Catras files, Arstan chronology files, some .dat files, Close all samples
Catras files can now be opened by CDendro like any .wid file. Several .cat files can be "Added to this collection" by using the multi-select mechanisms in Windows (hold down ctrl-key and click on filenames).

The Arstan program writes chronology data for type raw/std/res/ars after each other to a common file "xxx.rwl_crns" with a trailing type marker like "std" at position 82-84 of each line.
When data lines of such a type were copied to a separate .crn file, CDendro was previously not able to read these lines because of the markers. This is now fixed.

CDendro can now also write a chronology file from the sum of a collection. This may be useful if you want to save a current sum together with the number of stems for each mean ring width.
For a statistically better calculation of mean values out of a collection, I recommend using the ARSTAN program! Though for crossdating purposes the differences are usually unimportant.

A type of inverted .wid files with the oldest ring at the beginning of the file can now be read. They are supposed to have extension .datw. Their first numeric value is ignored as it usually is the number of ring widths.

New menu command: Samples/Close All Samples.

TTest/T-value calculator
A small TTest calculator now available under the Help menu command. This will float above all Windows applications so you can use it also in other programs.
Besancon index E algorithm for normalization
Select usage of the Besancon index E normalization via the menu command Settings/Options for matching and normalization/Sort best matches/Check to display.
See our dendro wiki on normalization

Collection handling

  • There is now also a StartYear column.
  • You may sort a column by clicking in the column head.
  • Columns can be temporarily reordered by dragging them sideways!
  • Same stem update will now work when MemberId is as short as 3 characters (previously 4).
More than one mean-value-sample from the same collection
Create mean value sample of a collection: Right-click to get it in a NEW window!
Right-click on that button will now create a NEW mean value window and also prompt for names of this new and the previous mean value window.
There is a tooltip on the button about right-clicking for this option.
Crop of a collection
New menu command: Collections/Write collection as cropped members to a .fh file. Will cut out the same time segment for all members.
This is a useful tool when a collection is found to be correct within a certain interval but is being corrupt elsewhere.
This tool is also useful if you want to cut out a section of time with a stem density of e.g. at least 5 stems.
Get all current cross correlation values into a big matrix
Cross correlations: The button to find cross correlating members of a collection has been split into two buttons.
The first button shows offsets and correlation values for the best matching points.
The second button shows the cross correlation values for the current offsets. Example, see below!
Opening a group of collections
You can now save the names of your open collections in a special "group-file" and later when you restart CDendro open those files with one single command.

(The same mechanism for saving and restoring of sample windows is much more tricky to implement - so we have to wait for that.)

Finding most popular matching year - Test towards reference
When a sample of unknown origin - e.g. from a ship - should be dated, or when there is no reference from the area of the sample, it is  usually best to check how well a number of reference curves match towards this sample.

In this case we have a collection with all available mean value curves from various regions. The sample to be dated is then selected as the reference. By running the button-command "Test towards reference" we get a list of how each member of the collection matches towards that sample. Such a table may be difficult to read when there are many members of the collection. Therefore you may want to check the option "With condensed report" found just below that command button. That way you get an extra sorted list with frequently recurring year numbers like this:

 
Year numbers occurring more than once: 
 1792   11 
 1769    3 
 1824    2 
 1921    2 
 2010    2 
Note that you get this list only when the reference (=the sample to be dated) is undated!

Also note, that you may want to uncheck those members giving the lowest matches towards your undated reference. This can be done by hand (click) or through the button "Select best matching members". Then  you may run the button-command "Test towards reference" again and get a new report with better overall results.

Besancon .txt format
Collections stored in Besancon 1992 .txt ring width files can now be read by CDendro. To make the .txt files show up in the Open files dialogue box, you have to Enable Besancon .txt file lookup in the Settings menu.

Note that this command is not able to handle "corridor normalized Besancon data" with a mean value of zero and both positive and negative "ring width values".

Long member names now kept: In early test versions of CDendro the Besancon members were given a short automatically generated name like "002005" to allow for export into .rwl/Tucson files. The current solution is to allow long names when Besancon or Heidelberg files are read. These too long names for the .rwl/Tucson format can be shortened with the new command "Renumber Checked Members" and the new names also adjusted by hand (right-click a member to Edit!) before creating an .rwl file.

The old compact file format

From January 1 2010, CDendro can also read compact format files which are sometimes found in old data archives. Such files should then be given the extension ".datc" and are opened via the Collections menu command.

Curve plotting

Stem density
The stem density of a collection's mean value sample is now shown at the top of the curve window for a sample and at the bottom for the reference.

This feature can be deselected by unchecking Settings/Plotting window settings/Show number of stems behind your collection mean value curve.

Successive segment/block correlation values
Correlation coefficient values of successive blocks/segments are now shown at the bottom of the curve diagram.

Block length and distance can be set through the text boxes at the lower left corner below the diagrams. Blocks may overlap.

Create Sample from block - Naming the cropped sample
When you crop a sample (Create sample from block) the new sample will by default get its name lengthened with "_BLOCKOF".
You can now select another shorter text like "_C" by a setting via the More Settings menu command.

The command "Uncheck members already in target collection", will now uncheck also those members where a cropped version is within the target collection according to the name used.

Plotting a large ring width curve
Adjusting horizontal scale by zooming
Ring width curves can plotted larger (higher) than before. This is useful when creating curves for reports or other documentation.

Horizontal curve scale can be adjusted in small steps by clicking the zoomin and zoomout icons (magnifier glass) with the RIGHT-button of the mouse. This is useful when comparing with a published curve shown in another application window when each window do not fill the whole screen, but they can be seen simultaneously.

Ruler handling enhanced
When a vertical ruler is set within a sample but anchored into the reference, then rulers are automatically made visible within the reference window.
Vertical rulers checkbox now automatically checked when a sample opens and the reference sample already has vertical rulers visible.
Also when you check "anchor in reference", the Vertical rulers checkbox is automatically checked.
Crossdating quality test diagrams: Curves or piled
Crossdating quality test functions: Correlation coefficient curves (also TTest) can now be plotted as a pile (narrow columns) diagram.
Note that the Crossdating quality test functions frame/order panel has to be enabled through Settings/Enable crossdating quality test functions.

Workbench tab:

Standard deviation for blockwise correlation coefficients along a curve match
The standard deviation for blockwise calculated correlation coefficients along two matching curves can now be displayed. Though you have to enable an option to make these values shown.

A low correlation coefficient value combined with a high standard deviation value may indicate a missing or false ring. It may also be a useful measure when looking for matches in distant chronologies when the dating is unknown. A low standard deviation value combined with a reasonable but anyhow low correlation coefficient value may then indicate an overall acceptable match.

The correlation coefficient is a measure of how well two curves match at a certain overlay position. The main measure is then the coefficient calculated for the full overlapping length of the curves at the given position. When you look at a match segment by segment (block by block), the coefficient may have quite different values along the curves. The standard deviation of this sequence of correlation coefficient values may be informative when you inspect a list of possible low quality matches. The length of the blocks and the distance between them can be set. Please note that the blocks may overlap, i.e. the correlation coefficient be e.g. calculated every 10th year but then calculated for the last 30 years. A shorter block length will give you a higher standard deviation.

Blockwise correlations and Sorted SetsSampleTo
Block correlation analysis result "SetsSampleTo" sorted in a separate list at the end of the report.

There is an option "Extended block length test" of the "Make block correlation analysis" of the Workbench tab.
When a block has been tested, it is successively lengthened with the blockdistance and then again with the blockdistance. These new blocks are tested for best and next best position within the reference. Result is presented as a sorted "sets sample to year number-list". Missed or erroneous rings may be discovered with this tool.

Alternative crossdating methods
You can select which crossdating method to use for sorting out the best match.
You can also have data from several methods shown in the crossdating table.

Note: When you select the left Corr-coeff column to be based on Baillie/Pilcher you may nevertheless find occurences when this column differs from the BaPicorr column above. This is probably because either your current or your reference curve is based on a collection.
For collection-sums, a "real" Baillie/Pilcher value differs from the "BaiPicorr" value with typically 0.01-0.02 because normalization for the BaPicorr value is calculated from a mean-value of ring-widths from all members of the collection, while the Corr-coeff value is calculated as a mean value of normalized values collected from all individual members of the collection.

News as of December 2008

Developed on the .NET platform

The CDendro and CooRecorder programs have been rewritten to run on the Microsoft .NET platform.
This has been done to improve the chances that these programs will continue to run on future versions of Windows.
Another ground for this conversion to .NET is to facilitate and enable continued software maitenance and development.

Some enhancements in the new versions

Zero rings
There are times when you cannot measure the full radius of a sample because a section is missing or
because rings are invisible or ring widths are too thin to be measured.
To insert a zero ring in CDendro, right-click where you want the zero ring inserted.
To remove an existing zero ring, shift-right-click in the curve.
Zero rings inserted or removed in CDendro can be saved in your coordinate (.pos) file and directly reloaded in CooRecorder for e.g. a tighter inspection.
(In the picture above, two zero rings are still missing.)
You can also insert one or several zero rings at a crack or at a diffuse section when measuring in CooRecorder.
You can later adjust the width of such a zero ring gap in the curve diagram of CDendro.
Note 1: Zero ring gaps do not participate in the calculations when finding the best match!

Note 2: Be very careful when reading TTest-values for a sample containing zero rings!
That sample may give you a very high TTest value though it comes from yourself adjusting the curve to match at a certain point!

For more information on zero rings, see the section Handling zero rings

Collections - Changing the identity of a member sample

The identity of a member of a collection can now be changed like the comment or offset.

This means the the members can be easily reorded and the result saved in a .rwl or .fh file.

This is of great importance when samples from the same tree have been given too different identities like 6681 and 6682 instead of 6681A and 6681B.
See the section on Multi-radii collections
Collections - Writing in heidelberg format (.fh)
CDendro can now read and write in heidelberg format (.fh) which is a more suitable format for printed publications than the .rwl (Tucson) format.

You may edit the property names of the .fh file as you like.

Properties saved with an .fh file can also be saved in a .rwl-file as comments which can later be retrieved as properties.

Collections - Using Test towards reference when crossdating
The most common usage of the Test Towards Reference button is for crossdating a sample of unknown origin towards a collection filled with members which are all reference curves from various areas.
In this case the unknown sample is set "as the reference" in CDendro.

You can find a detailed description of how to do such a crossdating in the section Use Test Towards Reference for dating

What's new here: The crossdating report is written into a .html file. This can be now be opened  and inspected in a full size window with the menu command Collections/Open report in new browser window.
When more text is added to the report, you can update your browser window with the Refresh/Reload current page button.

The select best matching members button makes it easy to uncheck/unselect those members which do not have an interesting match towards the "reference".
This is also described in Use Test Towards Reference for dating
A condensed report is printed at the end when the checkbox With condensed report is checked.
That table could be used as part of your crossdating report.
Import and export of tabular data
Tabular data can now written or read for export or import to/from a spread sheet program like EXCEL.
See the section on Import tabular data.

For export, use the menu command Collections/Write collection in tabular format
You can limit the volume of the export by checking or unchecking members of your collection. Only data of selected/checked members is exported.

Limiting the search to a certain time interval
You may limit the time interval to be searched for matches. This feature is only of interest for special research applications.
It should never be used for e.g. dating of timber from a house. Dendrochronology should not be used as a tool for computer-aided guessing!
Set vertical rulers to mark years of special interest

When the "Vertical rulers" checkbox is checked a vertical ruler will follow your cursor along the curve diagram (see ruler marked 1935 above).

Use ctrl-click to set (anchor) a vertical ruler across your curves (marked 1940 and 1959 above). The rulers are by default anchored in the current sample.

When the "Anchor in reference" checkbox is checked, the ruler will be anchored in the reference.
It will then also show up in the window of the reference if the "Anchor in reference" checkbox is checked also in that window.

You will see the difference between the anchoring modes when you shift your current curve in relation to the reference.
Rulers anchored in the current curve (sample) will stay with that curve, rulers anchored in the reference will stay with the reference curve.

To remove a ruler, ctrl-click on it!
Right-click on the Vertical rulers checkbox to remove all vertical rulers anchored in the current sample window.

Clicking on the curve...

Note:
Click in the curve diagram to get ring width information about that year displayed in the big white box below the curves.
Ctrl-click to insert or remove a vertical ruler.
Right-click to insert a zero ring.
Shift-right-click to remove a zero ring.

Remove reference curve from diagram: Use "Set no reference selected"
There a cases when you want to remove the reference curves from your curve diagram. Then use the menu command above!
Skeleton plot
Skeleton plotting is now available in CDendro when any of the two Skeleton alternatives is selected as "Check to display" in the Settings/Options for normalization... window.
Plotting ring width curves with old time towards left and later time towards right
The default way of plotting in CDendro is with late time to the left and older times towards right. This is not the conventional way of presenting the time scale. If you need a curve plotted the conventional way, you may uncheck the "Plot curves with old times towards right" checkbox as shown above.
With a suitable setting of some other display options you can get a curve which matches e.g. an old published curve, as shown above with a curve of Ernst Hollstein. This way you can check your reading-in of a printed curve as above or create a suitable curve for a lecture.

You should be aware that CDendro is not basically written to handle the curves plotted this way. E.g. intervals are always specified with late time first (leftmost value) and old time next (rightmost value). So I cannot recommend you to always plot your curves with old times to the left.



Copyright © 2010, Cybis Elektronik & Data AB, www.cybis.se