Professional Documents
Culture Documents
Using SeisSpace
Known Problems
Contents2
Using SeisSpace
Other Docs
Known Problems
Contents3
Using SeisSpace
Replicating Flows 56
Supported functionality 57
Flow Replication Components
Building Templates 60
Converting a flow to a template
Flow mode vs. Template mode in the flow editor
Selecting parameters to change from job to job
Opening and Editing The Replica Table 63
Adding Rows and Columns
Adding rows 64
Adding Columns 64
Populating Columns
Populating Strings 66
Populating the Constants Table
Choosing Replica Parameters in the Template Editor 69
Naming Conventions
Reading data from other Area / Lines in DDI
Template Editor and String Validation Table
Build and Submit jobs using the Job Table 73
Job Table Overview
Using the Job table
Building jobs
Building New Subprojects
Submitting jobs
Deleting Replicas
Glossary 79
Other Docs
Known Problems
Using SeisSpace
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
Navigator opens the Navigator and Flow Builder. From here, you can
browse manage your Projects and datasets, flows and tables for those
projects. This is the tool for all flow building, job submission and
flow replication work.
Job Viewer shows the status of all jobs that have been sumbitted
from the flow builder and navigator except for flows submitted using
the flow replication part. From here you can easilly see job status, kill
jobs, remove jobs from the Q, pause jobs and get to printouts of the
jobs.
NetworkView displays the status of the background work and flat file
managers that are currently registered with the sitemanger. From here
you can also see running job exec processes. A common use of this
tool is to get access to the workmanager logs for trouble shooting purposes and sometimes to kill stranded or left over FFDB manager processes or exec processes.
Administrator uses a series of wizards to configure SeisSpace. It is
also used to reconfigure SeisSpace. NOTE: only administrative users
will see the Administrator icon.
A normal SeisSpace user, (a non-administrative user) will only see three
icons:
Other Docs
Known Problems
Using SeisSpace
Navigator icon
This icon starts the Navigator and Flow Builder. When first opened, before
setting up any projects, one folder named Hosts displays in the tree view.
This is an empty folder until SeisSpace is configured. See Configuring
SeisSpace for more information.
Other Docs
Known Problems
Using SeisSpace
For more information refer to the Working with the Job Viewer
documentation.
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
You can also learn the icons by using the pull-down menus or the MB3
options menus to see a text description of the action associated with its
icon. You will also see some hot-key combination shortcuts are associated
with these actions.
Other Docs
Known Problems
Using SeisSpace
combination. You will find that only the appropriate hot key combinations
are available depending on which tab view is currently being displayed.
Mouse Buttons
MB1
MB1 selects items. Items selected with MB1 will usually become dark blue
highlight for reference.
You may see a folder that is high lit in a dark blue color and another that is
in a lighter gray color. The gray highlight is the folder that is currently
being displayed in the table view. You will usually achieve the double
highlight when you switch views using the tabs.
MB2
MB2 has no functionality in the navigator. MB2 does have functionality in
the Flow editor and, based on preference settings, MB2 can be used to open
process parameterization dialogs.
MB3
MB3 displays options or actions that can be performed on a selected item.
These options or actions are different depending on what type of item you
select. Different option lists also appear depending on which cell you select
in the table pane.
Other Docs
Known Problems
Using SeisSpace
Same options
Other Docs
Known Problems
Using SeisSpace
In the Table pane you must drop the item into the empty space below the
table, onto the Name column header, or into the white "informational"
column space.
You can also drop an item from the table pane into the tree view. For
example, copying a ProMAX flow, dataset or table from one line to
another. The drop location is sensitive to the location you are trying to drop
an object. You should also only be able to drop a Line onto an Area for
example.
You CANNOT copy any object from one project (Data-Home) to another.
Other Docs
Known Problems
Using SeisSpace
Sorting Tables
The table pane can be sorted by clicking MB1 on any of the column
headers.
Click a selected column once to sort alphabetically (or numerically)
in ascending order. Additional clicks will reverse the sort order.
CTRL-MB1 is used to set multiple column sort criteria and a additional CTRL-MB1 clicks will reverse the direction of the sort.
Shift-MB1 removes the sort specifications.
The quick search feature will allow you to find the first instance in the
column starting with the characters typed into the column header. For
example if you select Search Column and then enter a character, such as
the number 2, the first flow that starts with 2 highlights.
Other Docs
Known Problems
Using SeisSpace
You can press the ESC (escape) key to get out of the Search mode.
Column widths
Column widths can be adjusted by dragging the separators between the
column headers.
Column Re-ordering
You can re-order the columns by dragging the column headers to their new
locations.
Other Docs
Known Problems
Using SeisSpace
Note: Each tab pane is treated as a separate entity. You can set different
column visibility, widths, order and sort criteria for each of the different tab
panes.
Filtering tables
You can select which entries to display in a table using the Row Filter
option. For example, you can select only the datasets or flow of interest to
you. Use the Row Filter icon
to choose criteria for selecting what
to show.
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
You may also select a continuous set of objects in the table by holding
down MB1 while "painting" down the data type column. (the second
column by default). The selected objects will inherit the light blue color.
Other Docs
Known Problems
Using SeisSpace
Tab Panes
Tree View
Table View
Expand and contract the entries in the tree view by clicking on the symbol
to the left of the folder name.
Other Docs
Known Problems
Using SeisSpace
You will see the highest level is a list of hosts that are marked by a small
computer terminal icon.
Expand the view to the list of projects that you added using the projects
wizard.
SeisSpace projects are marked with a green S folder (NOTE: SeisSpace projects are generally not required)
ProMAX projects are marked with a blue P folder.
Note: You will see this green-S and blue-P convention in many places in
the Navigator and Flow Builder to help you identify where you are
referencing ProMAX or SeisSpace data objects.
All other folders are shown with the standard folder icon.
Administrative Hosts
Hosts are placed in the tree when they are selected as administrative hosts.
A host at this level is where you define ProMAX and SeisSpace project
directories and environments associated with those projects. You will be
able to submit jobs to these hosts or to Queues managed by these, or other
hosts. Most installations will have a single host listed in the navigator. This
may be the manager node of the cluster, or more typically a node of the
cluster that has been designated as a user login node for running the UIs
and interactive jobs.
Known Problems
Using SeisSpace
Lines are referred to as Projects and Subprojects. You cannot add more
than one subproject level to a ProMAX project.
The first time you expand a project after starting the workmanagers you get
a Retrieving Data message before you see the contents of these folders.
Another manager called the Flat File DB Manager or DB Instance
Manager is being started. There is one FFDB manager for each user for
each opened project. These can be tracked using Network View. If you
restart the workmanager you will also need to kill all of the FFDB
managers. The FFDB managers will then restart as you re-open projects.
The FFDB managers should die automatically when a workmanager is
killed. If there are orphaned FFDB managers, they will appear to
reconnect to the Navigator, but you will soon find that they are really
useless. The first major clue is that you cannot submit any jobs for
execution. Kill these FFDB managers using the network view and then
restart them by restarting the navigation from the host level.
As you expand the projects, the FFDB managers will restart and show the
"retrieving data" text.
Other Docs
Known Problems
Using SeisSpace
Setting Permissions
In the Tree and Table Views you may notice that some project and
subproject entries are Bold and others are normal type. All SeisSpace
datasets are presented in Bold text. You will also notice that some items
may have the Lock icon next to them in the table view.
If an object in the table is in Bold type and does not have a lock icon in the
lock column, the object should be writable, renamable and deletable. This
generally means that the object directory has write permissions, and
important selected components of the object also have write permission.
For Projects (Data_Homes), the Lock appears when the main project
directory does not have sufficient write permissions for your user. If the
object name is not bolded, at least one of the DescName file, or the
.projectInfo.xml file does not have write permissions.
An unbolded dataset is not renamable or deletable if either the
xxxxxxxxCIND or (dot) .xxxxxxxxCIND files do not have write
permission. NOTE: The permissions of the MAP and all TRC and HDR
files are not checked for datasets.
For Flows, the Lock appears when the main flow directory does not have
sufficient write permissions for your user. If the flow name is not bolded at
leaset one of the DescName file or .flowFolderInfo.xml file does not have
write permission.
Other Docs
Known Problems
Using SeisSpace
Tables follow the same convention. All files associated with the table must
have sufficient permissions or the entry in the list is locked and unbolded.
The files that are checked are the main ########XXXX file and the
additional .########xxxx file.
Changing permissions
Use the lock icon
Files associated with datasets and flows can be owned by many different
users and the permission change is only applied to the files owned by you.
Note: Landmark (HDCS) does not offer the ability to do batch commands
as the root user within SeisSpace to change global ownerships.
The Permissions window shows the standard Owner, Group, and Other
read and write permissions and allows you to change the permission.
To change the permission click the boxes that describe the desired
permissions and then click on the Modify button.
Other Docs
Known Problems
Using SeisSpace
Permissions Summary
Bolded = the object is editable/deletable/renamable
Not bolded = the object is NOT deletable/renamable
Lock Symbol = the object is not writable
You may encounter the situation where files have been written to a
ProMAX line or a SeisSpace project where you do not have read
permission on these files. If this is the case, you will see an "error" dialog
box presented when you attempt to open that project in the navigator.
This dialog will show the names of the files that you cannot read. These
files, or database objects will not be presented in the navigator lists.
Other Docs
Known Problems
Using SeisSpace
Setting Preferences
Select Edit --> Preferences to display the preferences window.
The tabs at the top are used to change the preferences for specific windows
associated with SeisSpace. They are discussed from left to right.
General Tab
Known Problems
Using SeisSpace
is, processes are shown in the exact order that they are listed in the
Processes list. Sorting alphabetically sorts the categories alphabetically as well as the processes in the category.
Alphabetic
Listing
You can adjust the mouse double click sensitivity. A larger number
means more time between clicks is honored as a double click.
Other Docs
Known Problems
Using SeisSpace
Navigator Tab
The Navigator tab allows you to set preferences for the Navigator.
Change the number of flow instances to keep after a Purge. The
default is to keep the 5 most recent versions.
Use a single common tab for all data types: Select to reduce the
number of tabs at the top of the Navigator by using the Navigator tab
only instead of having separate tabs for Datasets, Flows, Tables, and
Navigator.
Single mouse click opens latest instance of flow: This is a compatibility switch to make the Navigator act like ProMAX. That is, a single click on a flow name displays it in the flow editor. This option
takes fewer mouse clicks to get a flow into the editor. However, it is
harder to get to the flow instance list. This option is toggled On when
you choose ProMAX feel from the Defaults tab.
Automatically open last selected flow on startup: This is a compatibility switch to make the Navigator act like ProMAX. That is, the
last flow you were editing when you stopped a session is opened on
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
The first height and width values control the size of the flow editor window.
The Divider location is active only if the "Use dialogs instead of scrolled
list for parameters for all processes" is toggled off and controls the position
of the divider between the process list and the scrollable parameter window
components of the flow editor. You can use the "Set height and width from
Other Docs
Known Problems
Using SeisSpace
the active flow editor to populate these values from an active flow edit
session. The subflow height value is shown in the graphic below.
Subflow
height
height
divider location
width
The Parameter dialog width value is used when the "Use dialogs instead of
scrolled list for parameters of all processes" is toggled on and sets the
width of the individual parameter dialog box of parameters for each
process that is shown when MB2 is clicked on a process.
height
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
The Log Viewer tab configures the job printout viewer. The Buffer size
entry controls the maximum size of a printout. This is handy if you are
running the client remotely and you want to view a large printout. Only
1024 KB of the file is initially transferred. The remaining entries control
the font sizes of the viewer.
Defaults tab
There are three basic sets of defaults: Use ProMAX feel, Use SeisSpace
feel and you can also Restore all standard defaults.
The following graphic shows the settings for the SeisSpace Feel:
Other Docs
Known Problems
Using SeisSpace
This next graphic shows the settings for the ProMAX Feel:
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Other Docs
Using SeisSpace
Known Problems
Using SeisSpace
Exec Tab
The Exec tab allows you to set preferences for the SeisSpace Exec.
Hybrid Flow Type: There are two options: In process and Separate
Process. In-process is recommended. The difference is that in-process
hybrids will allow you to intermingle ProMAX and SeisSpace processes and also expands the list of legal hybrid processes.
Use MPI for launching Exec: The current default is NO for this so
that the RMI exec will be used. The MPI exec can be parallelized
over more nodes, but requires MPI to be set up on the cluster.
override virtual machine arguments: This is a a capability added
specifically for the development environment. The user has the capability to alter exec parameters to work in a debug environment. The
details of this procedure is outlined in the development class notes.
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
% Processed column
Shows the percent of the input data passing through Disk Data Input.
Input MB/s column
Shows the rate at which data is passing through Disk Data Input.
Created column
Shows the date and time when a job was submitted.
The icon can be used to view the printout of the selected job while it is
running or after it has completed.
Query Status of Joblets icon
This icon is only used for pure SeisSpace or Hybrid jobs, it has no use for
pure ProMAX jobs. The joblet status window that is started using the
"Query status of joblets" icon displays the detail of a job. The window is a
matrix display with one column per thread and several rows per process.
Other Docs
Known Problems
Using SeisSpace
Process 1
Process 2
Process 3
Process 4
Process 5
Process 6
Process 7
Job Summary
Other Docs
Known Problems
Using SeisSpace
Thread 0
Thread 1
Combined
Each thread has a set of statistics for each process in the thread. You can
see bottlenecks in this window, that is those jobs consuming the most CPU
time.
For PSTM jobs it is very common to see that the PSTM is using a high
percentage of the CPU and causing a high percentage delay in the previous
processes.
Other Docs
Known Problems
Using SeisSpace
These icons are only appropriate for ProMAX jobs. They can be used to
temporarily halt a job that can be started again later. NOTE: pausing a job
that was released from the Queue does NOT mean that another job will be
released while this one is paused.
Stop input and finish flow normally icon
The "Stop" icon is only available for Hybrid or SeisSpace jobs. This icon
will stop he input step of the flow but the remainder of the flow will
complete as if the input had read all of the available data. There will
Other Docs
Known Problems
Using SeisSpace
generally be a delay between the time the icon is clicked and the job stops,
especially for 3D PSTM SeisSpace jobs.
Kill the job ASAP icon
This icon can be used to permanently remove jobs from the viewer. This
icon can also be used to remove jobs from the Queue that are in Queued
status.
Remove job from job viewer icon
This icon can be used to "hide" jobs from the table that you dont want to
see any more but may want to refer back to later. You can restore jobs to the
viewer that were hidden with this icon using the Find pull down menu.
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
Individual Dialog box mode (the default) and Scrollable window mode.
Toggle option
Scrollable window
You can switch back and forth using the Toggle Parameter List Icon.
You can also choose which mode to use as your default from the Edit -->
Preferences dialog box by checking or unchecking the "Use Dialogs
instead of scrolled list of parameters for all processes" option.
Note: When you select a flow for editing from the tree or the table listing,
you will always the get the most recent menu (or highest numbered
instance). You do not have to select the highest numbered instance from the
instance list.
If you want a specific instance, an older version for example, just MB3Open the selected instance from the table listing of the instances of a flow.
If you have edited the flow in the ProMAX user interface, you will need to
go to the instance list and choose the -1th instance to get the most recent
version of the packet file.
Other Docs
Known Problems
Using SeisSpace
Saving flows
Every time a flow is edited and saved or submitted, the flow is saved twice:
once as an XML file (exec.#.pwflow) and again as the binary file;
packet.job.
New instances are generated when a flow is submitted for execution or
edited and saved.
An instance saves all components of the flow including the job file and the
printout.
when you
type with
the focus
on a flow,
the
characters
will show
here and
activate the
search
Other Docs
Use arrows
and Enter
or the
mouse to
select the
process
Known Problems
Using SeisSpace
This options menu can be enabled using either MB3 on the process or
CTRL-MB3 on the process depending on your preference setting. In the
flow editor tab of the preferences dialog there is an option:
Other Docs
Known Problems
Using SeisSpace
If this option is checked "ON" then you can enable the options menu using
CTRL-MB3. While editing flows, the most probable reason for needing
this options list is to have access the online help documentation or to edit
comments.
Other Docs
Known Problems
Using SeisSpace
You can do the same thing from the Quick search list in the flow edit
window:
For access to the complete help document for a process in the processes list
you can use the MB3--> Help on Process option:
If a process is in a flow you can get help using the MB3 (or CTRL-MB3) -> Help on Process option. You can select the process with MB1 and then
press the F1 key. The Edit --> Help on Process pull down menu is another
option that can be used to get help on a selected process.
Other Docs
Known Problems
Using SeisSpace
multi-joblet distributed hybrid job have been annotated with a "parallel P"
icon in the processes list and in the flow editor..
illegal
single joblet
only
If you try to execute a hybrid flow that has illegal processes in it you will
receive the following dialog box:
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
In all cases, the following three job submit icons provide a variety of job
submit options:
Direct Submit
Queued and
custom node
list submit
Resubmit
Other Docs
Known Problems
Using SeisSpace
where the FFDB manager(s) are running. There are some sites where you
may want to run the Navigator/Flow Builder on a login node and remote
display back to another terminal. In this case, using the default "Project"
setting is appropriate. There are other sites where you may want to run the
Navigator/Flow Builder on a local desktop and run interctive and direct
submit jobs directly on this local desktop. In this case, use the "Client"
setting. This preference is set in the Navigator tab of the Preferences dialog
box.
Queue and custom node list submit
This option allows you to customize the submit parameters of a job or set
of jobs and also allows you to set up a job submission default. A common
use would be to set up a default queue for most jobs. You can set this as the
default that can then be enabled using the CTRL-MB1 combination when
submitting the jobs.This reduces the number of mouse button clicks from
five per flow in the conventional ProMAX user interface to one button click
for any number of flows in the SeisSpace user interface.
General usage here would be to parameterize the default Queued submit
and then save this default.
A CTRL-MB1 combination on this icon will submit the selected job(s) to
the default queue. If you want to do something else, then you can click
MB1 on this icon and the submit user interface will present itself and you
can choose the submit parameters as you desire. There are some cases
where your default values may be automatically "reduced" if the default
values are higher than the lowest level job to be submitted will accept. You
will be warned of this condition in the job submit informational lines at that
top of the dialog. For example: If you set your default submit values to be 1
node and 2 execs per node because you were running a series of Hybrid
jobs, and then tried to submit a conventional ProMAX (single exec) job
Other Docs
Known Problems
Using SeisSpace
with these default settings, the job submit GUI would show that the default
parameters were reduced to 1 exec per node.
The main job submission GUI has three major options, Hosts, Cluster and
Queue
All of these options allow you to reorder selected jobs for submission if
you have selected multiple jobs from the table list in the Navigator. That is,
you can put them in the Queue in a different order than they were selected.
Select the "reorder" icon to enable this feature..
First Select the flow
(or flows) that you want to move with MB1 and CTRL or SHFT MB1
combinations and then drag the selection to the location where you want to
drop them. They will be dropped below the dark bold line. To move a
sinlge flow to first select the flow with a click and release with MB1 and
then hold and drag with MB1.
The joblet count (or parallelization) part of the GUI is the same for all of
the options. See each individual section for details.
Other Docs
Known Problems
Using SeisSpace
Submit (button)
This button will submit the job(s) with the selected submit configuration.
Cancel (button)
This will cancel the job submit operation.
Save as Default (button)
This option will save the current job submit configuration as a default
which can then be accessed using the CTRL-MB1 option on the job submit
icon from the flow editor or the table view of the navigator.
Reset (button)
This option populates the dialog box with the default job submit
parameters, or the last submitted parameters if in resubmit mode.
Hosts option
The host option will present a list of the machines on which workmanagers
are currently running.
Other Docs
Known Problems
Using SeisSpace
For ProMAX jobs you can select a single host from the list.
For SeisSpace, Hybrid or ProMAX Parallel Begin/ Parallel End jobs you
can select multiple hosts on which to run the job in parallel. Select multiple
nodes with CTRL MB1 to select individual nodes from the list or SHFT
MB1 to select a range of nodes.
number of nodes
For single ProMAX jobs, multiple ProMAX jobs, or a combination of
ProMAX and SeisSpace/Hybrid or ProMAX Parallel Begin/ Parallel End
jobs the number of nodes will always be 1.
For SeisSpace, Hybrid or ProMAX Parallel Begin/Parallel End jobs, or a
combination of the two types, the number of nodes will be set to the
number of hosts you selected.
For multi-node ProMAX Parallel Begin/ Paralle End jobs, leave the host
list blank in Parallel Begin. The host list will be filled with the list of nodes
that you selected with additional instances for the number of execs per
node that was selected
Other Docs
Known Problems
Using SeisSpace
Cluster option
You can select from a list of predefined cluster definitions. These cluster
aliases are defined in the Administrator Tool.
number of nodes
The "number of nodes" option is not user configurable in this mode. The
number of nodes will be set to the the number of hosts that make up the
cluster definition for combinations of SeisSpace, Hybrid or ProMAX
Parallel Begin/ Parallel End jobs.
For multi-node ProMAX Parallel Begin/ Parallel End jobs, leave the host
list blank in Parallel Begin. The host list will be filled with the list of nodes
that you selected with additional instances for the number of execs per
node that was selected
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
Queue option
For all types of jobs, select the Queue to submit them to. There are two tabs
in the GUI, the main "Select Queue" tab and an "Advanced" tab, Although
the Advanced entries may not be visible, they are still used.
Other Docs
Known Problems
Using SeisSpace
Queue Directives:
You can select the queue directives set up using the Administrator tool. You
can also build a custom Q directive based on existing ones if you need to.
Other Docs
Known Problems
Using SeisSpace
properties, then use the <NONE> option here. If your properties match
your queue names, then you can use the "Property is the Queue name"
option. This option reads the quene name such as nodes1-10@queserver.
and strips off the queue name and then write the directive as #PBS
nodes=#:nodes1-10:ppn=#.
Main Dialog
number of nodes
The "number of nodes" option is user configurable in this mode. The
number of nodes is set automatically to 1 for ProMAX jobs, or any
combination of jobs that include single exec ProMAX jobs, The number of
nodes will be set by the user for combinations of SeisSpace, Hybrid or
ProMAX Parallel Begin/ Parallel End jobs.
For multi-node ProMAX Parallel Begin/ Parallel End jobs, leave the host
list blank in Parallel Begin. The host list will be filled with the list of nodes
that you selected with additional instances for the number of execs per
node that was selected
Other Docs
Known Problems
Using SeisSpace
Resubmit
Use this option if you want to resubmit a job exactly the same what it was
submitted previously. This icon also has a CTRL-MB1 and a MB1 option.
This is handy if you have selected a specific list of nodes for a SeisSpace
job and the first attempt fails for some reason. You can fix the problem in
the flow editor and CTRL-MB1 click this icon to resubmit with the
previously chosen submit parameters.
MB1 displays the job submit dialog box populated with the last submit
parameters.
CTRL-MB1 resubmits using the same parameters as the last submit,
bypassing the job submit dialog box.
Reset
Use this option to restore the original parameters.
Purging Flows
The conventional ProMAX Flow Builder keeps one copy of the packet.job
file and up to five versions of older printouts. The SeisSpace Flow Builder
will keep an unlimited number of copies of flow files and printouts from
previous executions.
You can purge (delete) the oldest instances of the flow by using the
Edit -->Purge pull down menu or the Purge Icon.
For example, a flow with 25 instances can be purged down to only
instances 21 through 25 using the default of five. The -1th instance is
retained as the packet.job. the number of instances remaining after a purge
can be configured in the preferences dialog.
You can also select multiple flows or even complete subprojects to apply
the purge option.
NOTE: Purging cannot be undone.
Overlaying menus
With each new release, the parameters in some processes change. A
feedback dialog box will tell you which parameters are new or have been
removed from a process. As with ProMAX, you can update processes in an
existing flow using the overly option. With SeisSpace, you can also select
multiple processes and overlay an entire flow in a single operation.
Other Docs
Known Problems
Using SeisSpace
You can select Edit --> Overlay ProMAX menu(s) or use the Overlay
ProMAX Menu(s) Icon.
Enter the new AREA (or project) or LINE (or subproject) and select the
coordinate system for this project. Landmark recommends selecting
UNKOWN for the coordinate system at this time.
Other Docs
Known Problems
Using SeisSpace
for the SeisSpace project. Click Browse and select the ProMAX line and
then click OK
A reciprocal association is also made so that the ProMAX project now
knows which SeisSpace project it is associated with. This is a 1:1
relationship. The primary purpose the association of the ProMAX project
back to a SeisSpace project is to make it so that when you select an output
dataset in a SeisSpace Disk Data Output in a hybrid flow you will be autonavigated to the list of datasets in the SeisSpace project.
Other Docs
Known Problems
Using SeisSpace
This tab displays information about the DATA_HOME path, the Host.that
the project is associated with, the Type of storage structure of the project
(ProMAX or SeisSpace) and the VFS directories that have been associated
with this project for storage of SeisSpace SMART format data.
Other Docs
Known Problems
Using SeisSpace
This tab displays the system level environment values for your project.
These values cannot be edited and are used by all users.
User ProMAX Env
This tab allows you to add additional environment variables or override the
defaults. You can add, edit, or delete entries. A common use of this would
be to add a PROMAX_SYS_EXE_HOME to add in your home directory
promax/sys/exe to the path to use your own modules in addition to the
system modules. You may also use PROMAX_MAP_COMPRESSION or
other environment settings where other users do not.
Other Docs
Known Problems
Using SeisSpace
SQL Tab
This tab is a security setting. You must enter an SQL user and password to
access the database for flow replication. This information is stored in the
netdir file separately for each user.
Properties for Existing AREAS and LINES
The Properties dialog for ProMAX AREAs and LINEs does not provide
any additional information nor has any function at this time. The dialog
box will display with no editable information.
Other Docs
Known Problems
Using SeisSpace
General Tab
This tab is a security setting. You must enter an SQL user and password to
access the database for flow replication. NOTE that flow replication is not
yet supported for flows in a SeisSpace project.
Other Docs
Known Problems
Using SeisSpace
production Processes list delivered with the release and the developers
Processes list. In SeisSpace, the developer only needs to maintain one list
of processes, the developers processes. SeisSpace appends the processes
found in the developers processes list to the production list under a new
folder called the exact name of the processes file that it found and is
displaying the contents of. In your SSclient start script set the environment
variable MY_PROMAX_HOME to the development path in your home
directory. If a ProcessesPM or a Processes file is found in the
$MY_PROMAX_HOME/port/menu/promax(product) directory, the
contents will be shown. If MY_PROMAX_HOME is set and there is no
ProcessesPM or Processes file in the individual menu/product directories,
then the menu/promax directory will be searched. Similarly if menus are
found in these directories they will be accessible.
The ProcessesPM lists get cached to memory in the Flow Builder as they
are read and used. You can refresh the cache by forcing a reread of the
Processes list by using MB3 --> Refresh on the top level folder in the tree
view of the processes list.
Executables
Add the environment variable PROMAX_SYS_EXE_HOME to your list
of user environment variables by opening the Properties --> User
ProMAX Env Variables on the project in the tree view of the navigator.
The path should be set as a double path separated by a " : " for example:
PROMAX_SYS_EXE_HOME=/home/user/apps/vendors/landmark/ProMAX/sys/exe:/apps/vendors/landmark/ProMAX/sys/exe
This setting searches your home directory for the executable first and then
the main production installation tree.
Other Docs
Known Problems
Using SeisSpace
SS-Disk Data Input --> SS-Specify CDP Bin Grid --> SS-3D Prestack
KirchhoffTime Migration --> SS-Disk Data Output (PSTM gathers)
Other Docs
Known Problems
71
Using SeisSpace
Replicating Flows
Other Docs
Known Problems
Supported functionality72
Using SeisSpace
Supported functionality
SeisSpace supports replicating flows in ProMAX projects similar to the
functionality provided by ProMANAGER. The following functionality is
available for flow replication in ProMAX projects: (Flow Replication is not
supported in SeisSpace Projects nor is it supported for SeisSpace or Hybrid
flows in a ProMAX project)
building template flows
selecting parameters that change from one replica to another (limited
to numeric values, strings and sort lists. Booleans like Yes/No
switches and multiple choice variables are not supported in this
release)
building a table of replacement parameter values
creating replica flows with automatic dataset name generation
managing the replication and job submit in a job status matrix
optional user control of the descriptive names of the replicated flows
Functionality not in this release includes:
flow replication for flows in SeisSpace projects
monitoring job status after "Submitted" in the job matrix
chaining flows with dependencies such as datasets or tables
Flow replication values are stored in an SQL relational database. If you
have not previously setup the SQL database you will need to install and
configure MySQL. See Setting Up the MYSQL Database.
You cannot use the same SQL user database that ProMANAGER uses,
There is a completely different data model used by SeisSpace. You need to
create a new user database with the SeisSpace Flow Replication data
model. This will not affect existing ProMANAGER work in any way. You
can still access your "pmgrdb" from ProMANAGER and you will access a
different "flowrepdb" for the SeisSpace user interface Flow Replication.
Unlike ProMANAGER, which requires you to manage a separate copy of
the information on disk relative to what is stored in the SQL database, the
SeisSpace flow replication attempts to keep the information on disk and the
information in the database synchronized. As you create and delete flows
and datasets on disk, the corresponding information is also created and
deleted in the database (as long as you do all creating and deleting in the
SeisSpace User Interface.)
Other Docs
Known Problems
Supported functionality73
Using SeisSpace
Replica Tree
Validation Table
The tree view of the contents of the replica table can be opened with the
Replica Tree icon.
Other Docs
Known Problems
Supported functionality74
Using SeisSpace
Other Docs
Known Problems
Building Templates75
Using SeisSpace
Building Templates
A template is simply a flow that is used as a master to make copies from.
The template is copied with the selected parameter changes in each copy
(or Replica). It is always a good idea to run the template flow as a test and
make sure that the flow runs and generates the desired results given one set
of replica parameters.
Flow View
Template View
Other Docs
Known Problems
Building Templates76
Using SeisSpace
You will populate this yellow box with the values that will change by using
a combination of text and column selections from the replica table
spreadsheet. The replica table will be described in the next section.
Other Docs
Known Problems
Building Templates77
Using SeisSpace
The first time you convert a flow to a template and set some replication
parameters, you will need to save the flow. When the flow is saved with
replication parameters it will be added as a template to the SQL database.
The flow will also be annotated as a "T" (or template) flow with the Tfolder icon in the tree and table views.
or
Other Docs
Known Problems
Using SeisSpace
The replica table has two tabs: the Replicas tab and the Constants tab. The
constants tab can be used to set values you want everyone to use all the
time that differ from the menu defaults. Examples might include a specific
ramp length for mutes or a specific stretch percentage value for NMO. The
replica tab will be populated with the values that will change for the
parameters you want to change from job to job.
The Subproject column is used for setting the names of the lines (or
subprojects) for writing the replica flows to if you select that option in the
Job Table tab. This is common for 2D work where you need the put the
replicated flows in DIFFERENT LINES.
Use MB3 inside the empty replica table for the options menu.
Other Docs
Known Problems
Using SeisSpace
Adding rows
Click Add Rows and enter a number of rows to add for your table.
Icons are also available to add and delete rows and columns in the replica
table spreadsheet.
Adding Columns
Use MB3 to open the options menu and Select Add Column.
Other Docs
Known Problems
Using SeisSpace
The Add Column dialog asks for the column name and type. The name of
the column may reflect the process and/or parameter that will have
different values from job to job. Typical column names might be min_shot,
max_shot, min_cdp, max_cdp. The three types are: String, Integer or
Float. You can also add a text description of the column. You cannot
change the data type of a column after it is created.
Note: The replica table allows you to name columns with blank spaces.
However, we advise you NOT to include blanks in the column names. For
example:
instead of using a name like: line min
use a name like:
line_min
or min_line
You can add the column to the left side or right side of the table. The
default is set to add new columns to the left. This means that the older
columns will be pushed off the right side of the display as time progresses
and as you add more and more columns.
Populating Columns
The Fill Column dialog asks for a starting value (integer or floating point)
and increment.
Other Docs
Known Problems
Using SeisSpace
Populating Strings
The Fill Column dialog allows you to build an expression based on text
constants, numerical sequences and other values in the replica table. You
can use the >> and << icons to toggle the tree view on and off where you
can choose to use values that exist in the replica table.
There are three ways that you can add in text or numerical sequences to
build the strings that you want to populate the column with: String of
Characters, Incrementing Numbers and Values from the Replica Table.
String of
Characters
Incrementing
Numbers
Values from
the Replica Table
Expand to show
the replica tree
QC window
The best way to learn to use this tool is to experiment with adding in string,
numeric and replica table values and watch the way the strings build up in
the QC window.
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
Use MB-3 to get to the Options menu and Add Rows to the table.
Give the constant a Name and a value and an optional description. For
example: you may choose a constant name of mutelen and a value of 48
with a description of "length of mute ramps".
Other Docs
Known Problems
Using SeisSpace
This example shows that three process parameters have been selected to
change from job to job. The input data file name, the ramp length to use and
the output data file name. The "yellow boxes" are populated with a
combination of text and replica values or constants.
Other Docs
Known Problems
Using SeisSpace
You can drag and drop the replica table column names into the template
from the tree view. To enable the tree view click on the Replica Tree
icon.
Click Refresh on the Validation table to verify the changes and then check
the value that will be used for each flow replica to be built.
Naming Conventions
Replacement values have the following naming conventions:
c.xxxxxx is a constant
r.xxxxxx is a replica table column
s.xxxxxx have the template name and project name available
Other Docs
Known Problems
Using SeisSpace
Other Docs
Known Problems
Using SeisSpace
Another feature is that if you select a cell or series of cells in the replica
table you will be taken to that parameter in the flow editor where it will be
outlined in a white box.
Other Docs
Known Problems
Using SeisSpace
Any template saved to the SQL database appears in the Job Table. After
you save a flow as a template, you do not need to save it every time you
change it while it is in the editor to validate the replica parameters. The
validation table and job table uses the values in the flow editor. However,
you need to save the template when you are finished with it to save all of
the processes, parameters, and replication parameters.
You can remove a template from the job status table by editing the template
flow, removing all of the replica parameter selections (un-selecting the
circles amd removing the yellow boxes), and saving the template as a
standard flow.
Note: Replication substitution parameters and equations are saved with the
flow.
Other Docs
Known Problems
Using SeisSpace
Build Failed
If you replicated into other lines then there will be a folder icon to the left
of each of the above indicating that these flows are being built in another
line.
Other Docs
Known Problems
Using SeisSpace
The Flow Description table shows the job status only as a color code with
accompanying icon but shows the flow name. The initial names of the
replicas are similar to how ProMANAGER names the replicas. That is, the
flow name is a truncated version of the original template name with the
sequence number appended. In this tab pane you can name the output
replicated flows as you prefer using text and constants and values from the
replica table as desired.
You can name the replicas the same as the original template name if you
are going to write the replica flows to different subprojects (lines).
To change the names, select a cell and use Select Columns and Fill
Column.
NOTE: this only changes the descriptive name of the flow (the
DESCNAME) not the name of the flowfolder disk file. The flow folder on
disk is named using the SQL database id number of the template and the
sequence number combination. This becomes apparent in the table view of
the navigator.
Building jobs
To build jobs, select cells in the Job table by "painting" them while holding
down MB1 and then select the Build a Replica Flow icon.
also use the MB3 - Build from the options menu.
You can
You can watch the job building status in the xterm console that was used to
start the Navigator and watch the cell status change. The Build Pending
status indicates that the cell was selected to be built but the building
process has not progressed to that point yet.
You can use the Stop icon to stop the build, build and submit or submit
procedures.
To refresh the flow list, click on the Flows folder and then click the
Refresh icon
. You will also notice that Replica Flows are in a
subtree under the template flow.
The template flow should be annotated with a T-folder and the replicas
under this template should be annotated with an R-folder.
The replicated flows have two different names, the DescName (or
descriptive name that you normally address the flows by plus the actual
Other Docs
Known Problems
Using SeisSpace
disk directory name where the packet file and job.outputs are stored.
Normally the directory name is a squished version of the DescName where
blanks and some characters are stripped out and all alpha characters are
lower case. In the case of replica flows,. the DescName is controlled by you
when you build the flows either using the default name which is a
concatenation the first 10 squished characters of the template name with
the sequence number appended, or a name that you have built in the job
table. In either case the actual directory name is a concatenation of SQL
template ID number in the database and the sequence number in the replica
table.
For example, in the picture below notice that the template name is 08apreprocessing template. The replicated flows have a user defined name that
is a concatenation of part of the original template name and some values in
the replica table for the shot range being processes. The replica flow disk
file name is a concatenation of the template ID and the sequence number:
3_______xxxxx.
In the Datasets list, the new datasets for the replica flows to create are
empty.
Other Docs
Known Problems
Using SeisSpace
Un-check to
write flows and
datasets to other
sub-projects
Other Docs
Select the
replicas to
build
Known Problems
Using SeisSpace
Refresh the subproject list to see the new subprojects with the flow and the
dataset stubs written to these subprojects.
Submitting jobs
To submit jobs, select the cells and click on one of the Job Submit icons.
Jobs are submitted in the order you selected. The Job Table will also
display the status of the jobs as they progress through the system. You can
also use MB3 to get job submit options.
Deleting Replicas
You can delete the replica flow in the Navigator tab or you can delete them
from the job status table.
select flows
to delete
Other Docs
Known Problems
94
Using SeisSpace
Glossary
Cluster
Node
Hardware node
Mayor node
Foreman node
iSitemanager
Workmanager
NetDir
Network View
Administrator Privileges Privileges allow you to add new users, passwords, and setup
cluster and project configuration. This is equivalent to a
system administrator.
Job Viewer
Log Viewer
Other Docs
Known Problems
95
Using SeisSpace
ProMAX project
Equivalent to a PROMAX_DATA_HOME
SeisSpace project
VFS
joblet
Other Docs
Known Problems
81
Other Docs
Using SeisSpace
Known Problems