USDA Logo and Forest Service Shield

Timber Cruising Software

CruiseProcessing iconCruiseProcessing Frequently Asked Questions (FAQs)

The Forest Products Measurement support staff has summarized some of the questions most commonly asked regarding CruiseProcessing, its installation, use, and interpretation. Browse this list of questions and answers to see if your question has already been answered.


General Questions

What files do I need to run CruiseProcessing?
Only one file is necessary for running CruiseProcessing, the cruise object, denoted with the extension CRZ (or crz). There are additional files required to run CruiseProcessing distributed with the program. However, only one data file is required to process.

What do these files contain?
The cruise object contains numerous tables for holding data collected or calculated. The default setup file contains information needed to build these tables for the first time.

How are these files named?
The user supplies a name for each file. A fully qualified filename (includes pathname) is recommended. Use of the Browse… button simplifies entering the filename.

How can these files be generated?
There are three ways new cruise objects can be created. First, job and key files from the DOS version or server versions of NatCRS/NatCDE can be converted to cruise objects using CreateFiles. The CruiseDesign program will also generate a new cruise object. Finally, FScruiser will create a new cruise object.

So data can be collected on paper and entered using Microsoft Word?
No. Since the cruise object is not a text file, it cannot be edited or created in Microsoft Word. Only FScruiser, CruiseDesign or CreateFiles can create a new cruise object.

Will legacy data (Version 6.xx or Version 7.xx) be accepted in CruiseProcessing?
Yes. See the Create Files User’s Guide for information on converting legacy data. Legacy data must be converted to a cruise object before it can be processed.

Why isn’t NatCRS a Windows program?
The National Cruise Program (NatCRS) originally ran on a Data General mainframe. When the Forest Service phased out the DG machines and migrated to the IBM and PC platforms, NatCRS was rewritten as a DOS program.

CruiseProcessing is the Windows successor to NatCRS.


Report Questions

Why don’t all of the reports match volume and estimated number of trees?
Since a cruise can contain cut and leave trees, some reports contain both type of trees. For example, a B1 report includes leave trees while a CS1 report contains cut trees only. Be sure to read the header at the top of the report to see what has been included in the report. Another good example is primary product and secondary product. Some reports are strictly primary product and others combined primary and secondary products. So, not all reports will match exactly.

But some of the reports showing all cut trees only still don’t have matching volumes and estimated number of trees. Why?
As noted below, this was a concern in the DOS version. Preliminary tests indicate this may no longer be a problem under the Windows version. The number of significant digits will remain static throughout the program in the Windows version. Future testing may modify this indication.

DOS version
There are a few reports that fall into this category. The main reason is the way the data is stored. There are three intermediate files created in NatCRS providing information for report generation. In addition, the RAW data file contains every tree record in the job file with the calculated volume included on each record. The values stored in this file contain a different number of significant digits than the three intermediate files. Some reports use the RAW data file and some use the other intermediate files. The number of significant digits may result in a slightly different volume shown in the report. When NatCRS is converted to a Windows platform, the data will be stored in a database without this differing number of decimal places and discrepancies between reports will disappear.

Several log reports were requested but did not appear in the output. Why?

Windows Version
The log reports are dependent on a table called the Log Stock Table. If it is empty, the reports will not be generated.

DOS Version
The log reports are dependent on an intermediate file called the logstock file. In order for this file to be produced, log data must have been collected. In a job file, the 7C or 7D records contain log information and must be present for these reports to be generated.

Not all of the reports requested were generated and no log reports were requested. Why?

Windows Version
This is still true in the Windows version. Old numbers and new numbers cannot be mixed in the reports list. However, with the new method for entering report numbers, it is not possible to mix old numbers into the list.

DOS Version
When the new Version 7 format was created, the report numbering system also changed. A crosswalk of old to new report numbers is available in the release notes under Document Archives. New report numbers cannot be mixed with old report numbers in the key file. For example, asking for report H1 (old number) and CP1 (new number) is not allowed. Some reports will be dropped if the report numbers are mixed. However, the program will accept a report list of either old or new numbers. Just make sure the report list contains all old report numbers or all new report numbers.

Why does the printed output get messed up?
While external text editors can still be used to print the output file, output files can be printed directly from CruiseProcessing. It is still recommended that the document be formatted to print landscape with Courier 8 point font.

The reports are specifically formatted to print on a regular 8 ½ x 11 piece of paper with landscape orientation. However, using different editors may cause some of the lines to wrap around which throws off the printing. Extra pages may get inserted where part of the report spills over. Some good editors to use include Programmer’s File Editor (PFE), WordPad, or UltraEdit. MS Word can also be used but might give mixed results. In whatever editor is used, change the font to something like Courier 8 point. If the reports are still not readable, try decreasing the margins to fit more on a page.

Some reports have a column marked “Product Source” with codes of P, S, or R in the column. What does this mean?
The Product Source column refers to the type of product with “P” for primary, “S” for secondary, and “R” for recovered.


Volume, Value, Weight, and Quality Adjustment Calculation Questions

Are cubic foot volumes calculated by 16-foot log lengths or 32-foot log lengths?
Cubic foot volumes are always calculated using 16-foot log lengths.

Pulpwood (or topwood) volume is not calculated?

Windows Version
Make sure the secondary flag on the Volume Equation Window is checked. This flag works in conjunction with the primary product flags. For example, if the primary product CUFT flag is checked, the program automatically calculates secondary product when the secondary flag is checked.

DOS Version
In either key file version (6 or 7), the flag for pulpwood volume must be set in order for the program to calculate the volume. See the documentation National Timber Cruising Program—Documentation and Input Requirements for the exact format.

What volume equation needs to be used?

Windows Version
Volume equation numbers are region specific. A complete list of equation numbers by region is included in Appendix A of the Cruise Processing User’s Guide.

DOS Version
Volume equation numbers are region specific. A complete list of equation numbers by region is included in Appendix A of the National Timber Cruising Program—Documentation and Input Requirements. The key file will also accept old equation numbers and convert them to the current numbers. Some regions have a specific set of numbers to be used depending on location. When in doubt, contact your Regional Measurements Specialist for guidance.

What coefficients are used for Value Equations?
Coefficients for Value, Weight, and Quality Adjustment calculations are supplied regionally. Contact your Regional Measurements Specialist for the coefficients to use in your area.

The cruise has 3PPNT strata and the error message “ Strata 1 must have at least one measured tree” is returned. How can this be fixed?
For the 3PPNT (biomass) cruise method, each measured tree must have a tree count of 1 in order for the data to process properly.

USDA Forest Service
Forest Management Service Center
2150 Centre Avenue, Bldg. A
Fort Collins, CO 80526-1891

Please contact us with questions or comments regarding this website.

USA.gov logo

Last modified: Friday, 21-Jun-2013 12:47:56 CDT