Running

in

Peter Gould, Pacific Northwest Research StationGrowth-Model User Group Meeting, June 2, 2010

Acknowledgements• I “borrowed” previous work on the implementation of the ORGANON dlls in Excel from Mark Hanus and Sean Garber.

• Mark Hanus helped troubleshoot problems with ORGANON8.4.

• David Hann and other ORGANON developers for providing DLLs.

Why run ORGANON in R?

• R users don’t need to switch environments or interfaces to run different programs (on cutting and pasting).

• Can combine projections and summaries.

• Can automate processing (1 or 100,000 stands).

How to connect to ORGANON

DLL (Dynamic-Link Library): a program that can be called by another program. Often used to create, manipulate, and update variables.

ORGANON has three dlls:ORGVOL.dllORGEDIT.dllORGRUN.dll

Can we call the dlls directly from R?(Yes, in theory)

Should I be worried?

R sees the dll!

R sees the functions in the dll!!

R CRASHES!!!

Alternative Approach• ORGANON can be run in MS EXCEL using the dlls.

•Mark Hanus did the original coding in VB.• Sean Garber added more features• I updated it for Version 8.4 (with help from Mark Hanus) and added features for input/output.

• R can control EXCEL using the rcom package (Thomas Baier (2008). rcom: R COM Client Interface and internal COM Server. R package version 2.0-4.)

• runOrg8.4 runs ORGANON via EXCEL.

What do you need?• ORGANON DLLs and RUN_ORGANON8.4.xls need to be installed in: C:\Program Files\ORGANON\DLL

•R needs to be installed (I’m using version 2.9.1) AND the rcom package.

• Excel need to be installed and macros enabled (I’m using Excel2007).

• The runOrg8.4 function needs to be loaded.

Input Formats

•Optional: HT, CR

•Tree list (use the exact variable names)

Input Formats

•Header info (use the exact variable names)

Optional: USEGEN, DBHGAIN, HTGAIN, USESNC, RETAINYRS.

Process for runOrg8.41.Opens the Excel workbook (set to be

invisible). 2.Loops through the stands

1.Updates header information2.Pastes the input treelist into the worksheet3.Runs ORGEDIT (adds heights, crown ratios, etc.)4.Runs ORGRUN (the actual projections)5.Copies output back to R

3.Closes Excel and returns to R

Run the function and output

Example: Two stands, 30 plots / stand , 10 trees / plot, projected for 10 cycles (50 yrs). Elapse time: 5.5 seconds

The Excel Workbook

Microsoft Office Excel 97-2003 Worksheet

Double-click above to open and then save with this name and path:

C:\Program Files\ORGANON\DLL\RUN_ORGANON8.4.xls

Use Excel1997-2003 format.

The R Code (double-click below to open)

RunOrg8.4 with example.txt