RocFall

[Link]
about the ROCFALL options that are not discussed on these pages, please consult the help system
ROCFALL.

:sahcus,snoitcurtsnieht,m
ylO
aunaln

Select: Slope → Define Slope

They are used to navigate through the menu options.

Toolbarbuttonsareshownatthemargins(asshownaboveinthe
The button on the bar is always the recommended method and the fastest option to use.

Quick Start
 This'quickstart'tutorialwilldemonstratethebasicfeaturesoftheprogramandshowyoua
basic functioning.

fInotdoneu,rnROCFALLbydocnkuigcebl-hetROCFALLcoinnihetdofelr
installation.

Alternatively,intheStartmenu,selectPrograms→Rocscience→RocFall→RocFall.

IftheapplicationwindowROCFALLisnotmaximized,maximizeitnow,sothatthe
full screen is available to view the model.

Description

A typical ROCFALL analysis can be performed in a few minutes and will consist of the following steps:

1. Define the slope.

2. Define the pending subjects.

3. Assign the materials to the slope segments.

4. Define the starting places of rock (seeds).

5. Calculate the analysis.

6. Graphically represent the results.

Inaddition,barriersanddatacollectorscanbedefined,asexplainedinTutorial2.
Thisquickstarttutorialwillguideyouthroughthebasicsteps1-6describedabove,to
conduct a simple ROCFALL analysis. Note: the model created in this tutorial can also be
find in the [Link] file in the examples folder in the installation folder
ROCFALL.

D
h
otS
n
ioetp
life

Beforestarting,noticethatwhentheROCFALLprogramislaunched,anewdocumentin
White is now open. This allows you to start creating a model immediately. Lavista
The initial one shown on the screen is known as the slope view.

noiethpogntitcem
lieybsnew
atntm
uacodtnenracreT
ehsu
New from the menu File or the toolbar.
st m
i iL

Beforedefiningtheslope,let'sestablishthelimitsofthedrawingarea,sothat
we can see the slope that is being created as we enter the geometry.

Select: View → Limits

Enter the following minimum and maximum x-y coordinates in the dialog box
View of Limits

Figure 1-1: Dialog Box View Limits.

Define Slope

To create the slope, select Define Slope from the slope menu or the bar of
tools.

Select: Slope → Define Slope

Enter the following coordinates in the message line at the bottom right of the
screen.
 Enter vertex [enter=done]:0 0
3.1 –12.2
6.7 –12.2
9.8 –24.4
13.4 -25
Enter vertex [enter=done]:21.3 –23.5
Enter vertex [enter=done]:press Enter

PleasenotethatbypressingtheEnterkey,[Link]
Vertex has been introduced, by pressing the Enter key again it adds the slope of the screen, and
leave the option Define Pending.

gde t aercebos l anac sepolS

left mouse button at the desired coordinates when using Define the slope. (The
Grid options and capture grid are useful for entering exact coordinates.
graphically.

ResettheviewbyselectingZoomtofitfromthebar
tools (or you can press the F2 function key to zoom in on everything). Your screen must
verse in the following way:

Figure 1-2: Defined slope geometry.

 Don
eitfnm
iofaetarsil

To define the properties of the slope material, select Material Editor from the
toolbar or the pending menu.

Select: Slope → Material Editor

Figure 1-3: Material Editor dialog box.

rofslairem
fotaseiresatahtecitonlluw
oyi,xogblaidrotE
idslairM
ehntaI
defaults have been pre-defined for your convenience. However, for this tutorial, we are going to
define three new materials, as described below.

1. Select the Add button in the Material Editor dialog, and it notifies you that
A 'New Material' appears in the list of existing materials.

2. Change the name of this new material to type one, and enter the given properties in the
Table 1-1.

3. Repeat steps 1 and 2 to define two new materials renamed TypeTwo and TypeThree.
RefertoTable1-1forproperties.
 Name Rn Rt Phi Roughness Color
mean (mean | (sd)
sd) sd) sd)

Type One 0.8 | 0.03 0.8 | 0.03 30 | 0 0 Black

Type Two 0.7 | 0.03 0.8 | 0.03 30 | 0 0 Green

Type Three 0.5 | 0.03 0.5 30 | 0 0 Pink

Table1-1:Newpropertiesofmaterials.

4. When you have finished entering all the properties, select the Done button on the
dialogueMaterial editor.

Itisnowreadytoassignthematerialpropertiestotheslope.

NOTE:

Standard deviations are not mandatory. If a specified property is desired

exactly
for that property.

The colors of the earrings have nothing to do with the analysis. They are simply used with
Identification ends. The properties of the materials are assigned to the slope segments.
with the EditorSlope dialog box, available in the slope menu.

MaterialsAssignment

YoucanalsoinvokethePendingEditordialogbydouble-clickingonavertex.
from the slope. (Materials can also be assigned graphically with the mouse. This is
describe in the following section).

Select: Slope → Slope Editor

Wearegoingtoassigntherecentlydefinedmaterials(typeone,typetwo,andtypethree)ofthe
next way:
 1. In the dialog box for Slope Editor, double click with the mouse on the second row of the
material column and select type one from the dropdown list of available materials.
Thiswillassignthematerialtypeofasegmentbetweenvertices1and2.

2. Double-click with the mouse on the third row of the Material column and select type two.
It will assign material type two in the segment between vertices 2 and 3.

3. This process is followed until the materials are assigned to them as shown in the
Figure 1-4. Click OK when you are finished.

Figure 1-4: Pending Editor dialog box.

Graphical allocation method

AlthoughwehaveillustratedtheassignmentofpendingmaterialusingtheEditordialog
Slope, material assignment can also be done graphically with the mouse, using:

In 'Assign Material' (the 'brush' button) in the toolbar, along with the list
drop-down of material names.

gnisunahtrehtarslairem
ehtatngissayllacihpargotreisaebllw
iti,sesacm
ntsIo
The dialog box Slope Editor. To assign materials graphically, simply:
 1. Select the Assign toolbar button.

2. Select a material from the list in the toolbar.

3. Select slope segments with the left mouse button.

Multiple segments can be selected from a selected window. Click and hold.
press the left mouse button and drag to create a window.

4. When you have finished, press the Enter key or click the mouse and select Done.

Advice:

R
ckigcol-hintaoplseesgmenatndeA
cstlgnism
,alierat
This will display the EditorSlope dialog, with the current material for the click on the segment.
It has already been pointed out. Use the Pending Editor dialog box as described.
previously, to assign a different material.

spT
i aD
ta

"Data tips," which appear when the cursor is hovered over for a moment over the
Entities of the model are a useful feature of ROCFALL.

For example, if you hover the cursor over a segment of the slope, the properties will be displayed.
of the slope segment material, as illustrated below.
 Figure 1-5: data tip for slope properties.

If you place the cursor directly over a vertex of the slope, the data tip will show the
xy coordinates of the vertices (and the standard deviations used, if applicable).

Figure 1-6: data points of the vertex coordinates.

 Datatipsallowforaquickcheckofthemodelpropertiesonscreen.
while visualizing the model, without having to return to the data input dialog boxes,
etc.

ThedataadviceisavailableforallROCFALLmodelentities,including
also sources, barriers, and data collectors.

Don
eitfniSatn
ritgpon
h
tiR
fteock

.snoitidnoclaitiniehtenR
iaeO
fotedC
m
oA
cF
tslpL
teim
tlesdolaniyfroT
m
ehtadna
for the rocks (location, mass, and velocity).

Thelocationsoftherockformationscanbedefinedas:

• POINTS (Add PointSeeder option) or

LINES (Add optionLine Seeder).

For this tutorial, you only need to add a single point (that is, all the rocks will originate from a
site). Select Add starting point from the toolbar or the Rocks menu.

Select: Rocks → Add Seeder Point

1. Click the mouse and select SnapVertex from the pop-up menu.

2. Move the cursor near the first slope vertex (that is, the vertex at 0, 0). When the
the cursor is close to the top, it will "adjust" to the exact location of the vertex (since we became
SnapVertex in step 1).

3. When the cursor (blue cross) aligns with the vertex, click the left mouse button and in
Defininginitialconditionswillbringupthedialogbox.
 Figure 1-7: Definition of the initial conditions dialogue.

Enter an average horizontal speed = 1.5 and a standard deviation = 0.15. Leave all the
other parameters as shown in Figure 1-7. Select Accept when you are done.
Pleasenotethat'datasuggestions'arealsoavailablefortherockgame.

Hover the mouse over the point at (0, 0) and you should see the initial conditions we just
define.

Figure 1-8: Data point for seed properties.

 C
em
otu
p

To run the analysisROCFALL, select the Calculate option in the Rocks menu or the bar
tools.

Select: Rocks

1erugF
iotram
lisebdluohsnercsehtdna,sselrosdnocew
sfasekatylnonoitaluclacT
eh

Figure 1-9: Results of the ROCFALL analysis (50 rocks).

IftheresultsseemslightlydiferentfromthoseinFigure1-9,rememberthatbydefault,
osR
ndom
(,anum
)s-rbeiyslnahetnioniR
taOrndom
eagnum
C
rA
F
rbesL
usL
the results will be different each time the analysis is run. Reproducible results
they can be obtained by using the Pseudo-Random option, as explained further
forward in this tutorial.

For this analysis, the predetermined number of 50 rocks was used. This simulation parameter
it is located in the Project Settings dialog, and will be
discussed later in this tutorial.

However,lest'gotothegraphofsomeresultsfirst.
 Grap
reh
carsetu
iolnailtf

ht fonoi t acol l a tnoz i rohehT

Understanding of a ROCFALL analysis.

Select: Graph → Endpoints

Theusapm
lanltubtsm
eoisatrF
lguier1-0.

Figure 1-10: GraphEndpoints (split screen view).

By default, when a chart is generated for the first time in ROCAFALL, it is displayed in a
split view format, with the slope displayed at the bottom of the screen as
a visual reference.

(Note that the slope compresses vertically from this viewpoint, that is.
X and Y axes are not at the same scale.

ehgtnitcelm
eysbieytnatdaetavitcaedrdoetavitw
ceaenbm
aivcedotilpT
seh
SplitView option from the toolbar or in the Graphics menu.
 Select: Chart → Split view

w
[Link]
zixsaihpargT
eh

PropertiesoftheGraph

Click on the chart and select Chart Properties.

Figure 1-11: Chart Properties dialog.

.segnarlatnozirohdnalacitrevehtem
zoitsucotresuehw
otsllaxobgolaidseitrepoP
rtC
rT
eah
or horizontal, as well as the axis titles and the graph. This is left as an optional exercise.
Select Accept or Cancel.

scitsitaS
t

Click on the graph and select Statistics. A dialog box will appear showing the
statistics of the graph, as shown in Figure 1-12.

ScrolldowntoseetheinformationintheStatisticsdialog.
 Observe the Copy button in the Statistics dialog. Selecting this button allows you to copy the
information in the dialog of Statistics, in the Windows clipboard. From the clipboard,
it can be pasted into word processing programs or spreadsheets for later
analysis or drafting of reports.

Select Accept to close the Statistics dialog.

Figure 1-12: Distribution Statistics dialog box.

atadw
arC
ypo

R
C
.w
yaporD
tfanoitponaecitonllw
uoyim
,unetE
idehtnI

Thisallowstheusertocopytherawdatausedtogenerategraphstotheclipboard.
from Windows. Raw data can be pasted into programs from the clipboard.
text processing or spreadsheet, for later analysis or report writing.
it allows you, for example, to perform custom analyses that are not available with ROCFALL.
For example, I could copy the 'raw' data associated with the rock endpoints onto the sheet of
calculation, sorting the data and fitting an unusual probability distribution to the data.
Enveolpgeraphcis

Kinetic energy (Total, translational and rotational), velocity and rebound height as well
they can be generated by the analyses in ROCAFALL.

Select: Graph → Graph Envelope

[Link]
represent

Figure 1-13: DialogueAboutGraph.

Select total kinetic energy from the list and click the Create Graph button to see the
results.
 Note:

[Link]
activate or deactivate at any time, as described above for the
endpoints chart.

• Whenenergy,speed,orbounceinthekineticheightgraphsaregenerated
Initially, a new viewpoint is created for each chart. Only one can exist.
point of view of each type of chart. These types of charts are reselected.
after a chart has been created, the active view simply returns to the chart
selected. A new point of view will not be generated in this case.

shparg noi tubi rt s iD

Kinetic energy (Total, translational and rotational), velocity and height distribution graphs
they can be generated by rebound.

ThedistributiongraphsshowthedistributionofresultsinlocationsX
(horizontal locations) along the slope.

Select: Graph → Graph Distribution

.raepallw
iw
o,lebstrahcnoitubirtsidehtfotsiw
odplnrdahtw
i,eugolaidT
eh

Figure 1-15: Dialogue Distribution Plot.

Select total kinetic energy from the dropdown list and select Create graphs.

Theusaphslanoltdulbm
eoisatrF
lguier1-6.

Figure 1-16: Distribution of kinetic energy at x = 10.6.

Pleasenotethefollowingpropertiesofthedistributiongraph:

AthickverticallineontheslopemarksthelocationXofthedatasamplingpoint.
To display the data in other locations, simply click the left button.
mouse anywhere on the slope. The vertical line indicates the selected position and the
The graph will be updated immediately.

If you press and hold the left mouse button over the slope, you can drag the
vertical line marker along the slope, and the graph will update when the line is
move.

The sampling location can also be moved with the left/right arrow keys or the
mouse wheel (if the mouse has a mouse wheel).
S
seah
m
tA
eS
n
im
gu
d
itop
sfjln
et

TheXlocationsofthedatasamplingaredeterminedbythehorizontalextentofthe
slope, divided by the number of sampling intervals in the dialog box
[Link],theseplacesXwillnotberoundnumbers.

To obtain rounded numbers for the X locations of the data sampling in the graphs of
distribution, it is possible to:

Adjust the number of sampling intervals in the project settings dialog, and/or

modify the total length X of the slope (for example, extend or shorten the first or the
last segment so that the total horizontal measurement of the slope is a round number.

Example:ifthetotallengthXoftheslopeis50meters,andthenumberofintervalsof
the sample is 100, this sampling will provide intervals of 0.5 meters along the
pending).

Distributions at exact locations X can also be obtained through the definition of

data collectors in the desired locations, and the graphical representation of the results for
the collector(s).

Mosaic of views

Ifyouwish,youcannowtiletheviews.

Select: Window → Vertical Tiling

According to the number of graphs you have generated, and whether or not you have the Split view option.
activated or deactivated from each perspective, the screen may resemble Figure 1-17.
 Figure 1-17: Tile view.

sisyln
ah
etu
nrR
-e

You can run the analysis again to go back to selecting the Compute option as many times.
as desired.

Select: Rocks → Compute

Allopinionsandchartswillbeupdatedwiththeaccumulatedresultsofalltherocks.
launched. Note that the total number of rocks launched is displayed in the status bar. (For
Example, if you have selected to Calculate five times more, the status bar should indicate 300 rocks.
lanzadas).
 Cealn
rih
gtR
eockPah
t

To start a new ROCFALL analysis with a clean slate, select the Delete option.
RockroutesinthetoolbarorintheRocksmenu.

Select: Rocks→CleraRock Paths

Thiswilleraseallexistingrockpathsontheslopeandwilleraseallcollecteddata.
previously. The chart views that may have been opened will indicate 'No data.'
available.

PleasenotethatROCFALLautomaticallydeletestherockpathseverytimetheyaremade.
changes in the model, which would invalidate the results currently shown. For
for example, if a new material is assigned to a slope segment, ROCFALL will be reset
automatically the rock routes.

noitarugifnoc tcejoP
r

For this quick start guide, we have used the simulation parameters so far
omission. Now we are going to change some of the parameters of the simulation in the box of
project configuration dialog, and run the analysis again.

Select

Figure 1-18: Project configuration dialog.

Changethenumberofrockstothrowto500,andchangethenumberofsamplingintervalsto
[Link] Accept.

Runtheanalysisagain(selectCompute)andplotgraphsasbefore.

Pleasenotethespeedoftheanalysis(500rocksshouldstilltakeonlyafewsecondsto
calculate). It is important to take into account that the number of sampling intervals is used
during the ROCFALL calculations, and determines the frequency of data collection over the
rocky paths, and it also affects the speed of the analysis. Every time the number of
sampling intervals, a new ROCFALL analysis must be performed (the previous results were
will be automatically deleted.

Pseudo-Random Simulation

Bydefau,tl ROCFALLusestruerandomnumbergeneraoitnto
test the distribution of input data that you have defined for the properties of the material, etc.
Thismeansthat'Calculateeachtime'hasbeenselected,theresultsoftheanalysiswillbedifferent.
different rocky paths will be generated. This is due to a number of "seed"
different is used each time the random number generator is called.

However,theremaybeoccasionswhenyouwanttogeneratereproducibleresultsfora
ROC FALL analysis. The Pseudo-Random option in the Configuration dialog.
The project allows it. Pseudo-Random Simulation means that the seed number is SAME.
It is always used to generate random numbers for sampling from distributions.
input data. This results in identical sampling from the data distributions
Initially, every time the analysis is executed (with the same input parameters).
it can be useful for demonstration purposes, the discussion of example problems, etc.

To demonstrate Pseudo-Random sampling:

Select

Select the Pseudo-Random option and clickAccept.

Now select Calculate several times. Note that the paths of the rock do not change.
when Compute is selected, because the input data sampling is now Pseudo-
[Link],herealizedthatinthedialogbox
Projectconfiguration,aseriesofseedsspecifiedbytheusercanbeentered.
in the Pseudo-Random option. Changing the seed number will give different results of
 analysis. However, for a given number of seeds, the results will always be the same.
say, pseudo-random). This is left as an optional exercise for the user to experiment.
with that.

.selifm
egaidetropxerofelbaliavasnoitpolareveseraeR
rneO
hIC
A
tFL,

Expom
irtagelief

The image file export option in the File menu or in the right-click menu, you
allows the user to save the current view directly to one of the four file formats of
image:

JPEG (*. Jpg)

Windows bitmap file (*.Bmp)

Enhanced Windows metafile (*.Fem)

Windows Metafile (*.Wmf)

draob
pilcotC
ypo

ehgntidsuraobpiW
ew
holdncsotidteipocoebsw
lenacivtnerruT
ceh
Copy option in the toolbar or in the Edit menu. This will place a map image.
from bits in the clipboard, which can be pasted directly into Word or applications of
image processing.

Black and white images (grayscale)

A useful option in ROFCALL is the Grayscale option, available in the toolbar.

the context menu or in the View menu. This will automatically convert the current view to scale of
grays, suitable for black and white image requirements. This is useful when sending
images to a black and white printer, or to capture black and white image files
black.

asaskrownoi tpoe l acsyargehT

The actual will be restored when the grayscale is disabled.
InfoVsior

The option Information Viewer in the File menu and the toolbar shows a
summary of all the parameters of the model ROCFALL from its own perspective. This includes:

Track Geometry

Slope materials

Seeder Properties

The simulation parameters

The barrier properties and collectors

Select: File → Info Viewer

Figure 1-19: ROCFALL information viewer list.

amrofnIehm
tor fnoi t amrofniehT
CopyinthetoolbarorintheEditmenuorbyright-clickingontheviewand
selectingCopy to [Link] the clipboard, the information can be pasted into the
word processing programs for report writing.

mrofnIehm
tor fnoi t amrofni ehT
through the Print option in the File menu.

[Link],aswe
explained earlier in this tutorial:

The results of the graph can be copied to the clipboard with the option RawDataCopy.
themenuEdit.

Graphical statistics are available with the Statistics option in the Graph menu.

SavR
eOCFALL
Modesl

BeforeconcludingthisQuickStartTutorial,let'ssaveourROCFALLmodel.

Select: File → Save

[Link]
quick start guide. To exit the program:

Select: File → Exit

 T
alu
oriatsn
C
ecB
derslaoril

ThistutorialwilldemonstratehowtoaddbarriersandcollectorstoaROCFALLmodel,interpret
the results.

fyIouhavdteonun'r,etiROCFALLbydoucebnkilgconhetROCFALLcoinnhietdofelr
installation. Or from the Start menu, select Programs→Rocscience→RocFall → RocFall. If the
the application window ROCFALL is not maximized, maximize now, so that the screen
complete is available to see the model.

Wearegoingtostartwiththesamemodelthatwecreatedintheprevioustutorialof'start'
fast". This file is available in the [Link] archive in the examples folder in the
installation folder ROCFALL.

Select: File → Open

 Navigate to the Examples folder in the ROCFALL installation folder and open the [Link] file.

DescriptionBarrier

A barrier in ROCAFALL is a line segment with one end on the slope surface,
that can be placed anywhere along the slope in order to alter the
trajectories of the rocks as they travel down the slope.

Barrier properties can be defined as:

Perfectly inelastic (Rn = Rt = 0)

Perfectly Elastic (Rn = Rt = 1)

Custom (no intermediate restitution coefficients between 0 and 1).

Additionally, barriers can be assigned a cutting capacity based on the maximum energy.
before breaking through the rocks.

[Link],however,donot.
Some can cross barriers and others cannot cross sloped segments.

rebairoA
fnid
tdi

To add a barrier to the slope, select the AddBarrier option in the menu.
barriers or the toolbar.

Select: Barrier → Add Barrier

Fromthefirstpointofastraightbarriersegment,itmustalwaysbewithinasegmentofthe
existing slope, you will notice a transverse marker movement along the
pending as the cursor moves. This marker indicates the point on the slope most
close to the position of the cursor, and it is a help to graphically add the first vertex of
barrier to the slope with the left mouse button.
 However,forthis example,weare goingto entertheexactcoordinatesofthelineof
system, since it is difficult to enter exact coordinates graphically.

Select location for the first endpoint

17.35 – 24.25
Select location for the second endpoint
[esc=cancel]:17.35 –17

NowthatyourmodelshouldbesimilartoFigure2-1:

Figure 2-1: Barrier added to the slope.

Asyoucansee,wehaveaddedaverticalbarrierinthemiddleofthelastsegmentofthe
pending.

Youwillalsonoticethattheexistingrockpaths,whichwerepresentwhen
we upload the file, they are restored when the barrier is added. This is done automatically by
.dedasi)rotcellocaro(reirrm
abaeityrevederiuqersisisylw
aenaecR
nO
iC
A
sFL,
of data) for the model.
 Barrier properties

WhenanobstacleisaddedforthefirsttimeinROCAFALL,thedefaultpropertiesofthe
the barrier is perfectly inelastic (Rn = Rt = 0.0).

Barrier properties can be changed in the BarrierEditor dialog.

will discuss shortly. However, first we will execute the analysis using the properties
predetermined.

etalucC
la

RuntheanalysisbyselectingtheoptionCalculationfromthetoolbarorthe
menuRocks.

Select: Rocks → Compute

ugF
iot ralm
isebdluohsneercsehtdnasdnocew
sefasekatylnonoitaluclacT
eh

Figure 2-2: ROCFALL analysis with barrier.

Sincethebarrieris"perfectlyinelastic,"allrockpathsthatcrossit
barriers stop completely. The rocks do not bounce, but simply fall down toward
the bottom part of the barrier, and they come to rest.

Asanoptionalexercise,youcancheckthis:

Bring closer to the barrier (use the Zoom Window option) and observe the trajectory.
from the rocks next to the intersections with the barrier.

• Plot a scatter graph (select Graph → Endpoints) and observe that almost
All paths of the rock end at the barrier (some small bounces and they fall again)
by the slope). See Figure 2-3.

Figure 2-3: Graph Endpoints (perfectly inelastic barrier).

 yfIouhavecomedphtledotsenipabtsloovchesl,tGaprhEndapn,sodti
resetting the view costs when selecting Zoom to fit from the toolbar (or can
press the function key F2 to zoom in on everything.

seitreporpreirrabfoeC
gnah

Barrier properties can be modified with the BarrierEditor dialog. This service
it is available through the barriers menu; however, a convenient shortcut is to click
Right-click on a barrier, and select Edit Barrier from the popup menu. Do this now.

Changetheperfectlyinelasticbarrier(Rn=Rt=0)toperfectlyelastic(Rn=Rt=1).
Select the PerfectlyElastic checkbox and select Done.

Figure 2-4: Barrier Editor Dialog Box.

Nowreruntheanalysis.

Select: Rocks → Compute

Asdescribedintheprevioussection,usethezoomwindowtozoominonthebarrierand
observe the trajectories of the rocks. Since the barrier is perfectly elastic, all the
rocks now bounce off the barrier, and no longer stick to the barrier, as they did when the
properties were perfectly inelastic.

Thiswillbeevidentifyouviewtheendpointgraph.

Select:Graph→ Endpoints
[Link],therocksarenowbouncingoffthebarrierandcomingto
rest in various places to the left of the barrier.

Illustration 2-5: GraphEndpoints (perfectly elastic barrier).

Close the Graph Endpoints, and if you have to the barrier as suggested earlier, press F2 to
bring everyone closer.

Of course, actual barriers are neither perfectly elastic nor perfectly inelastic.

Asanoptionalexercise,selecttheCustomizeoptionintheEditordialogbox.
Barrier,andintroducevaluesbetween0and1forthenormalandtangentialcoefficientsof
Restitution,andre-executetheanalysis.

BarrierCapacity

ROCFALLbarrierscanassignacapacityintermsoftheenergyneededto
break the barrier. Any rock that comes into contact with the barrier with kinetic energy
Those exceeding the barrier capacity will pass through the barrier, at a reduced speed.
Let'sprovethis.
Right-click on the barrier and select Edit Barrier.

2. In the Barrier Editor dialog box, from the selection of the checkbox
InfiniteCapacity,enteracapacity=100joulesandselectDone.

3. Re-run the analysis (select Compute), and observe that some rock paths
they now pass through the barrier.

Use the zoom window to zoom in on the barrier, as shown in Figure 2-6.

Figure 2-6: The rocks that pass through a barrier with finite capacity.

Graphicalrepresentationofbarrierresults

For each barrier, the following graphs can be represented for the rocks that collide with the
barrier

Total kinetic energy

The kinetic energy of translation

Rotational kinetic energy

translation speed

Rotation speed

• X or Y (horizontal or vertical) impact locations on the barrier

 Select the barrier and the collector graphics option from the toolbar or the
menuGraph.

Select: Graph → Sweeper and Collector Graphs

In the graphical window, select VerticalImpact Location from the drop-down list and select
Fact.

Figure 2-7: Dialog box Graph of Barriers and Collectors.

Note: The impact location on the horizontal graph is not available, as the barrier in this
case is vertical.

Similarly,usingthedialogueGraph,plotgraphsofthetotalkineticenergyandthe
translation speed.

You have already generated three graphs of the barrier. Arrange the views so that you can see all of them.
graphics at the same time.

Select: Window → Vertical Tile

Theusepcnsrhsodum
blF
gtaerius28lr-.i
 Figure 2-8: Barrier chart results.

Note - the X or in places of impact Y are represented in terms of the coordinates.

absolute of its model.

Ashortcutforgeneratingbariergraphsistoright-clickona
barrier, and select the desired graph.

Asanoptionalexercise,selectCalculateseveraltimes,andobservethatallthegraphs...
they update immediately to reflect the accumulated results of all the generated rocks
for the analysis.

Whenyouhavefinishedthegraphexam,closethethreegraphviews,andmaximizethe
pending view.

[Link].
of data collectors.
srotcelC
loaD
talarG
ene

A 'data collector' in ROFCALL is simply a line segment that gathers

information about the rocks, going through the segment when falling down the slope. It is not an entity
Physics. 'The data collectors' record the velocity, kinetic energy, vertical location,
horizontal and the location of all the rocks that pass by on their journey down the slope.

Unlike barriers, data collectors do not affect the movement of rocks.

no way.

Data collectors do not have the properties associated with them (with the exception of the
final points that define their location), and they have no directionality (that is, it doesn't matter
what extreme is the starting point and whose end is the endpoint).

Therearenorestrictionsonthenumberofdatacolectorsoronthosethatcanbe
It is possible to cross or traverse the slope, barriers, or other data collectors in
any place.

ortcelocld
ataoA
fnid
tdi

To add a data collector to the model, select the option DataCollector Add the
toolbar or in the Menubarreras.

Select: Barriers → Add data collector

1. Click with the mouse and select SnapVertex from the pop-up menu.

2. Move the cursor near the lowest slope vertex at (13,4, -25). The cursor should fit to the
exact location of the vertex.

3. Click the left mouse button to enter this as the first point of the collector
of data.

4. Now we will move on to the second point through the message line.
 Select location for the
second endpoint
[esc=cancel]:13.4 –17

ThemodehsloduolokeilF
guier2T
9(-.hextandorawsearaddedohtextboxandhet
Arrow options in the Tools menu. This is left as an optional exercise.

Figure 2-9: Data collector adds to model.

Asyoucansee,wehaveaddedaverticaldatacollectortotheleftofthebarrier.
existing.

Pleasenotethatexistingrockroutesarerestoredwhenthecollectorwasadded.
[Link] is done automatically by ROCFALL, as a new analysis is required each time
that a barrier or a data collector is added for the model.
 etalucC
la

ExecutetheanalysisbyselectingtheComputeoptionfromthetoolbarorthe
Rocks.

Rocks→ Compute

ugF
iot ralm
isebdluohsneercsehtdnasdnocew
sefasekatylnonoitaluclacT
eh

Figure 2-10: ROCFALL analysis with barrier and collector.

Asyoucansee,thedatacollectorhasnoeffectonthepathsoftherocks.

We can now analyze the results of the graph for the data collector in the same way as the
results were graphed on the barrier.

Dah
atgartaphcyraielpresen
h
tstrencsiu
eocltr

Graphs for barriers and collectors can be generated using the barrier and the graph option.
Collector,[Link].
previously for barrier graphs.
An alternative to using this dialogue is simply right-clicking on a barrier or
collector, and select the desired chart.

Wewilldemonstratebelow.

Right-click on the collector and select Graph Y-Impact Place from the pop-up menu.
the screen must be similar to Figure 2-11.

Figure 2-11: Vertical Impact for the Collector Location.

Pleasenotethattheimpactlocationsareintermsofabsolutecoordinates.
from its model, instead of relative coordinates (that is, measured from one end of the collector).
 scitsitaS
t

To view the statistics for this chart, right-click on the chart and select Statistics.
[Link].

Figure 2-12: Collector statistics (locationY-impact).

Pleasenotethatthenumberofdatapointsis61,butonly50simulatedfalls.

Thisisbecausethecollectorregistrationdataiscollectedeverytimeitcrossesastonepath.
collector. In this case, many of the rocks crossed the collector for a second time, after
bounce off the barrier.

ebtonlhlpw
airgrotcellocroreirrnabdiedrocerstnioaptadm
ufenohrebt,larenegI
necessarily equal to the number of stones thrown, and will depend on the number of times each
rock route actually crosses the barrier or collector.

Whenyouhavefinishedviewingthestatisticsdialogue,clicktheAcceptbutton,andclosethe
chart window.
 RockPathFilter

ofscitsiretcarhacdeificpeshw
tseioutrkocrretlifoteR
urO
taC
eA
F
faL
sL
ha
other existing paths. Using the filtering options, you can view the statistical information and
the distribution graphs only for the selected plots.

There are three ways to filter rock paths:

•Filter by Picking - this option allows you to graphically select the rock paths in the
side view of the slope.

•Filter by Value - this option for rock path filters goes by endpoint locations or
route coordinates.

Filter by Impact - this option filters rock paths based on their characteristics,
like total kinetic energy, translational velocity, etc., as they pass through the collectors
or how its impact on the barriers.

As an example, from the 50 rock routes in this tutorial, we are going to use the option
Filter by impact by highlighting the three rocky paths that have the highest total kinetic energy.
upon impacting against Barrier001.

Select

TheFilterbyImpactdialogboxwillappear.

Figure 2-13: The dialog box Filter by impact.

In the dialog box, select Barrier001 from the list of obstacles and collectors in the model.
Choose "Select paths with:" radio button. Then, select Higher energy
total kinetics of the dropdown list of the characteristics that form the basis of filtration.
Enter a value of 3 for the 'maximum number of paths' to be filtered.

Whenyouhavefinished,pressthe'Applyfilters'[Link]
dialogue.

Thefilteredpathsareshowninadifferentcolorintheslopeview.

Nowwearegoingtoseethetotalkineticenergygraphandthestatisticsfortheroutesthathavebeen
filtering.

Inpendingjudgment,[Link].
resulting. A graph of the total kinetic energy of all the routes in the analysis is shown in the
screen.

Show the view so that both the graph and the slope to the profile are visible in the
screen. Next, click on the chart and select Statistics from the pop-up menu.
Statistics dialog appears on the screen.

Nowwearereadytohideallotherresultsandseeonlytherouteinformation.
filtered access.

Select: Rocks → Filtered Paths only

Immediately, the two viewpoints and the statistics dialogue update to show the
information only on the filtered routes. Clicking on the filtered routes Only the option makes that
once again all the paths that are shown again.
r shparg noi tubi rt s id ehT

To conclude this tutorial, we will make an important point about distribution graphs and
ROCFALL collector graphs.

nisenillacitrevhgntoldaeriuqersnoiitcellocatad,sesacnm
tIso
places X emitted along the slope. For this, the option GraphicDistribution in the menu
allows you to draw charts:

Bounce height

Total kinetic energy

The kinetic energy of translation

Rotational kinetic energy

Speed of translation, and

Rotation speed

Thesegraphsallowtheusertoquicklyseedistributionsacrosstheentirerange.
from the slope (see the quick start tutorial for more information).

Distributiongraphsareactuallyderivedfromaseriesofdatacollectors.
Automatically generated vertical 'invisible' equidistants by ROCFALL when executed
the analysis. The separation of these collectors is determined by the number of intervals of
sampling in the dialog box Project Settings, and the total extension X of the
pending.

.aehtadtrw
ehedsuitivorplslw
tinorahcitubirtsid,snesIm
actso
desired. The option for data collectors is described in this tutorial that should be
necessary only in the following cases:

• ofdaIniectolanlganesioqchreaildnutvm
,-iteriubtse
use data collectors.

tsn
Iieceyasroc
tectloldaa
atthee
t xacotniclah,stentcianbe
It is necessary to define data collectors, as the distribution of graphics only provides
results in the intervals determined by the number of sampling intervals and the measure X
of the slope.