Copyright: Copyright ® 1993 - Thompson + Thompson


Contents
Rose

Contents

What is Rose?

Menu Commands

How do I?

Copyright Information

Registration

Warranty and Disclaimer

Thompson + Thompson

Index


What is Rose?

Rose is an interactive application for constructing rose diagrams and calculating vector statistics for a sample population of directional data.  The program was designed for the professional geologist that needs to process, display, and print directional data.  The Microsoft WindowsTM 3.1 interface is used throughout to give a common look and feel to the program and to provide a link between data storage programs (spreadsheets, databases), and presentation programs (word processors, graphics packages).  The multidocument design of Rose is useful in comparing data from several sites or different types of data from a single site.  Moreover, the data can be combined by simply dragging data from one rose to another.  The appearance of the rose diagram can be changed to suite your need, and access to the properties of the rose diagram are only a right mouse button click away.  Rose is simply the best way to make publication quality rose diagrams.


Menu Commands

Rose is accessed through a series of pull-down menus that are opened by pressing the Alt key and the underlined letter of the menu or by clicking the menu with the left mouse button.  The menus are:

File Menu

Edit Menu

Window Menu

Help Menu

Note:  The actual number of menus displayed depends on whether any rose diagrams are present.  That is if all of the rose diagrams are closed, only the File and Help menus will be available.


How Do I?
How do I...?

The following is a list of additional topics not covered by the menu option descriptions.

Copy Data between Roses?

Create a Data File?

Change Screen and Printer Fonts?


Copyright Information

This program and its code are copyrighted by Thompson + Thompson and distributed as Shareware.  This program and its code are therefore proprietary and the terms of copying and using the software is as follows:

1) Thompson + Thompson permit this software to be distributed through BBS's, Shareware distributors, and individual users.  The .EXE file and supporting documents must be included unchanged.  The .DLL and .VBX files can be omitted if they are available elsewhere on a BBS or in a catalogue.  Note that, the program will not operate without these supporting files.

2) After using this program for 30 days you must register the program with Thompson + Thompson.  The registration fee is $10 plus $5 for shipping and handling.  See the REGISTER.WRI file for a registration form.  If you have the program for longer than 30 days and you have not registered it, you must remove the program from your system.  We have not placed code in the program to encourage registration or brain damaged the code in any way.  You are on your honor!

3) Copying of this software for backup purposes by the purchaser is allowed without permission of Thompson + Thompson.  The program may reside on more than one computer if there is no possibility that the purchaser or the purchaser's agents are running more than one copy at a time.

4) Occasionally (education, instruction, etc.), Thompson + Thompson will distribute this program at only the cost of shipping and handling ($5).  Contact Thompson + Thompson for registered copies of the program.

Through the use of this program, the purchaser, the purchaser's employees, successors, and assigns, agree to the terms of the code and program Copyright and Warranty and Disclaimer.


Registration

After using this program for 30 days you must register the program with Thompson + Thompson.  The registration fee is $10 plus $5 for shipping and handling.  See the REGISTRA.WRI file for a registration form.  If you have the program for longer than 30 days and you have not registered it, you must remove the program from your system.  We have not placed code in the program to encourage registration or brain damaged the code in any way.  You are on your honor to register it!


Warranty and Disclaimer

If the program was received directly from Thompson + Thompson, all disks are warranted to be readable.  Thompson + Thompson disclaims all other expressed and implied warranties for the software, including the warranties of merchantability and fitness for a particular purpose.

The user of the software agrees to accept and use the program material as it is, at their own risk, relying solely upon their own inspection of the program material and without reliance upon any representation or description concerning the program material.  In no event will the authors of the code, nor any organizations they represent, be liable for any damages, including any lost profits, lost savings or other incidental or consequential damages arising out of furnishing, use of or inability to use, or performance of such software.


Thompson and Thompson
Thompson + Thompson

Thompson + Thompson consists of Linda D.P. Thompson and Todd A. Thompson.  Both are professional geologists that construct computer programs for research and education.  They can be contacted at:

4295 North Kinser Pike

Bloomington, Indiana  47404-9496

or Compuserve #: 72451,350.

See their other programs:

DIGILOG 1.0	- digitize scanned logs on the computer screen.

SIEVE 1.0	- the simplest way to store, process, and graph 1/2 PHI grain size data.

TRIPLOT 2.0	- construct trilinear diagrams of chemical, compositional, or grain size data.


Index

Change Screen and Printer Fonts?

Close

Copy

Copy Data between Roses?

Create a Data File?

Cut

Edit Menu

Exit

File Menu

Help Menu

Input from Keyboard...

New

Open Data File...

Page Setup...

Print

Print Setup...

Preferences...

Save

Save As...

Statistics...

Window Menu


File Menu

The file menu is used to enter, save, and print the directional data.  In addition, the file menu is used to open and close individual windows.  The menu items are:

New

Open Data File...

Input from Keyboard...

Close

Save

Save As...

Print

Print Setup...

Page Setup...

Exit

Note:  Some menu items will be inactive (grayed) when there are no data in the rose.


Edit Menu

The edit menu is used to modify the appearance of the rose diagrams and to interact with the WindowsTM 3.1 Clipboard.  The menu options are:

Preferences...

Statistics...

Cut

Copy


Window Menu

The Window Menu is used to change the arrangement of the Rose windows.  The rose-diagram windows can be cascaded, horizontally tiled, and vertically tiled.  In addition, the Arrange Icons option places the minimized rose diagrams in a straight line at the bottom of the main Rose form.

The Window Menu also contains a list of all of the rose diagrams that are active.  Focus can be changed between roses by selecting them in the Window Menu.  The caption bar of the rose with focus is colored differently than the other roses.  The color of the caption bar is controlled by your Windows system-colors.

Note:  Focus can also be changed between roses by simply clicking inside the form of the rose diagram of interest.


Help Menu

The Help Menu is used to display this help file at the Contents page or at the Index page, reach the WindowsTM 3.1 help file on Using Help, and open a window showing the program version number and copyright information (About...).

Note:  Topics in the rose help file are linked to menu items.  That is, the File menu New command is hot linked to the help file.  Information about the File New command can be obtained by hitting the F1 key when New is highlighted in the File menu.  Even menu items that are not active can be used to jump to the help file.  You do not even need to close the rose help file while Rose is running.  With the help file open, you can move back and forth between Rose and the help file without delay.


New

This menu item creates a new untitled window with a blank rose diagram.  Enter data into the rose by opening a file, entering data from the keyboard, or by dragging data from another rose.  Because the window is untitled, you will be prompted for a file name when you save the data.


Open Data File...

Use this option to import a data file into the currently active rose diagram.  The directional data will be read from the file and added to the data that already exists for the rose.  By repeatedly selecting this menu item, multiple data sets can be merged.  This menu item uses the WindowsTM 3.1 file-open common dialog form.  See your Windows manuals for information on the operation of this form.

See also:  Create a Data File?

Note:  You can associate a file extention with Rose in File Manager.  For example, associating the extension .ROS with RS.EXE will permit you to double click on a .ROS file or drag a .ROS file onto RS.EXE, and run Rose with the data file.  Rose will open with the data file in the first Window.


Input from Keyboard...

This option displays a form that is used to enter directional data.  Enter individual directions in the drop-down text box.  All previously entered data can be viewed by clicking on the down arrow to right of the text box or by hitting the Ctrl-down arrow key when the text box is highlighted.  A list box will be shown below the text box.  To change any value, select the errant value, and type in the new value.  To delete a value, highlight the value and hit the Delete (Del) key.

Note: All directional data must be between 0-360 degrees.  Entering values outside this range will cause a beep, and the value will be erased.


Close

Use this menu item to close the active rose diagram.  If the rose contains data and if all of the data was not previously saved, you will be prompted to save the data to a file.


Save

Saves the data in the active rose diagram to the file name of the window.  If the window is untitled, you will be prompted for a file name.

Note:  This menu option does not provide you the option to save the data under a different file name.  Use File Save As... to save the data under a different file name.


Save As...

Use this menu option to save the data into a Rose-compatible data file.  You will be prompted for a file name that is entered in a WindowsTM 3.1 common file-save dialog box.  See your Windows manual for information on how to use the common dialog form.

Note:  If no file extension is added to the file name, the extension .ROS is automatically added.  It is recommended that you use the .ROS extension to keep your data file separate from other files you have created.


Print

This menu item prints the active rose diagram to the currently active printer.  Use Print Setup... to change the active printer and its setup, and use Page Setup... to modify the position and size of the rose diagram that is printed.

Note: The quality of the printed rose diagram is dependent on the printer attached to the computer and its settings.  Be sure to select the highest resolution of your printer when producing a publication quality diagram.


Print Setup...

Use this menu item to change the active printer and its settings.  The changes are made through the WindowsTM 3.1 common printer-dialog form.  See your Windows manuals for information concerning the use of this form.


Page Setup...

This menu item displays a form that is used to change the position and size of the rose diagram that is printed.  All rose diagrams will be printed with these settings.

Note:  The printer settings are not saved when you exit Rose.  Be sure to reset any changes you would like made.  The startup settings for Rose print the rose diagram are 1" margins and a 3" square rose diagram.  These margins are for the printable part of the page.  That is, some laser printers can only print within 0.25" of the margin.  Under these conditions, a margin of 1" will be located at 1.25".


Exit

Use this menu item to close all of the rose diagrams and to exit the program.

Note:  You will be prompted to save all rose diagrams that have had data input into them and that were not saved since the last data input.


Preferences
Preferences...

This menu item displays a form, showing all of the properties for the active rose diagram.  Preferences... can also be selected by right mouse-button clicking on a rose diagram. The Preferences... form is used to change many rose diagram properties.  The following properties can be modified:

Class Size - the width of the wedges in degrees.

Display Mode - the type of data (unidirectional or bidirectional).

Graph Type - the method of displaying the data (Equal Area or Arithmetic).  Equal area graphs increase each wedge by an increment of area, whereas, arithmetic graphs increase each wedge by an increment of length.  Use Equal Area for most plotting.

Other Settings - these options modify the appearance of the rose diagram.  Very important is the rose diagram's maximum scale.  Normally, Rose scales the diagram to have the largest wedge at the outer margin of the rose.  You can set the outer scale limit by checking User Defined and entering the desired limit.  The value entered is used if it exceeds the calculated scale limit.

After changing the properties of the rose diagram, select Set for Current to change only the active rose diagram or Set for All to change all of the roses.

Note:  You can set the default appearance of all newly created rose diagrams by selecting Save as Defaults before selecting Set for Current or Set for All.


Statistics...

This menu option shows the vector statistics for the currently active rose diagram.  This item can also be reached by double-clicking the left mouse-button on the rose diagram of interest.  The calculations for unidirectional and bidirectional data are slightly different.  The bidirectional calculation yields a mean that bisects the main trend of the data; whereas, the unidirectional mean follows the main trend.

Note: The statistics are not printed with the rose diagram unless the Print Statistics with Rose box is checked in the Preferences...


Cut

Use this option to copy a bitmap image of the rose diagram to the WindowsTM 3.1 Clipboard and then to delete the rose diagram.  This menu item is the same as selecting Edit Copy followed by File Close.

Note:  There can be a loss of data if you have not saved the data to a file prior to selecting this option.


Copy

Use this option to copy a bitmap image of the rose diagram to the WindowsTM 3.1 Clipboard.  From the clipboard, the image can be pasted into other applications that can receive bitmap images (word processors, graphics packages, etc.).

Note:  The bitmap image cannot be rescaled in the receiving application without some loss of resolution.  Be sure to copy and image to the Clipboard that is the size that you wish to be received.


Copy Data between Roses?

Data can be copied between rose diagrams using two methods:

1.  The safest method is to save the data from one rose to a file, move focus to the destination rose, and open the file into the active rose.  That is, select File Save As... and enter a file name, move focus to the rose that is to receive the data, and select File Open Data File... and enter the file name you typed previously.

2.  The second method uses the mouse to drag data from the source rose to the destination rose.  Click, continuously, the left mouse-button on the rose that contains the source data, and begin dragging the data to the destination rose.  The mouse cursor will change to a small transparent rose diagram when you are dragging the data.  Move the cursor to the destination rose diagram and release the left mouse-button.  The rose will clear, and the data will be added to new rose.  If the destination rose is minimized, data will be added to the rose, but no redraw will occur.


Create a Data File?

Rose imports and exports an ASCII data file.  The easiest way to create a file is to type the data directly into Rose.  If your data are already in a file or a spreadsheet, create a new file that contains a direction on each line of the file or multiple lines with the directions separated by commas.  That is,

300

256

45

359

270

 :

 :

or

300, 256, 45, 359, 270, ....

Be sure that the data range from 0 to 360, inclusive!

Note:  Any data points not between 0-360 will be ignored when a file is opened.


Change Screen and Printer Fonts?

The default font for the title and direction labels is Arial.  You can change the font that is shown on the screen and printed with the rose diagram.  To change the font, right-click with the mouse on the text to change.  The WindowsTM 3.1 common font-dialog form will be displayed.  From this form, the font type and its properties (underline, size, bold, color, etc.) can be changed.  See your Windows manual for information on the common font-dialog form.

Note:  The size of font that you select is the size that will be printed with rose diagram, regardless of the size of the printed rose.  That is, Rose will not adjust the font size between a 2" x 2" rose and a 6" x 6" rose.