Changes between Version 2 and Version 3 of doc/app/dvr
- Timestamp:
- Sep 16, 2010 1:51:35 PM (14 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
doc/app/dvr
v2 v3 1 1 == Plots of isosurfaces, 2d cross sections and particles with dvr == 2 2 3 '''Preliminary note:''' 3 === Preliminary note: === 4 4 5 5 Usage of the '''dvr'''-software requires installation of additional software components ('''dvr'''-library, streaming-server, browser-plugin) which are not part of the PALM distribution. Currently (May 2009), this software is only available on the HLRN/IMUK-system and partly on RIAM's NEC-system. If you are interested in using '''dvr''' on your system, please contact the PALM developers. [[BR]] [[BR]] 6 6 7 '''General remarks:''' 7 === General remarks: === 8 8 9 9 The '''dvr''' software was originally developed by [http://www.rrzn.uni-hannover.de RRZN] stuff (Stephan Olbrich, Carsten Chmielewski). Meanwhile, further development under the name '''dsvr''' is done by the University of Hamburg (Prof. Stephan Olbrich, see [http://www.dsvr-software.de/dsvr webpage]). It allows to create 3d-animations with PALM, which can be displayed via a special plugin for internet browsers. With suitable graphic hardware (e.g. NVIDIA quattro FX cards) even stereoscopic views are possible. … … 13 13 The coupling of '''dvr''' software and PALM as well as the visualization of the model results via '''dvr''' has been the main focus of the BMBF project "Application of tele-immersion in long-distance networks" (2001-2002), which was a joint project of RRZN, ZIB and IMUK. This work was continued by RRZN in the DFG-funded project "[http://www.rrzn.uni-hannover.de/evita.html EVITA] - Untersuchung effizienter Methoden zur visuellen und haptischen tele-immersiven Exploration komplexer Volumen- und Strömungsdaten aus parallelisierten, dynamischen 3D-Simulationen" (2005-2007). [[BR]] [[BR]] 14 14 15 '''Using dvr with PALM:''' 15 === Using dvr with PALM: === 16 16 17 17 The calls of the '''dvr''' routines are contained within a PALM [wiki:/doc/app/packages software package]. To use this package, the additional option {{{-p 'dvrp_graphics'}}} has to be given in the '''mrun''' call. This automatically links the required libraries. Steering of the plot output is done via the [wiki:/doc/app/dvrpar dvr package parameters]. In contrast to all other PALM output, '''dvr''' graphic data are not output to local files but directly to a special remote computer which is defined via the package parameter [wiki:/doc/app/dvrpar#dvrp_host dvrp_host]. If the default values of the '''dvr''' parameters are used, data are send to a so-called streaming server at the RRZN. Apart from graphic data an additional html-file is created, which can be opened by an internet browser to view the data (a special '''dvr''' plugin is required for this). [[BR]] [[BR]] 18 18 19 Quickstart guide for using dvrp on the HLRN/IMUK-System (June 2010): 19 === Quickstart guide for using dvrp on the HLRN/IMUK-System (June 2010): === 20 20 21 In the following, please replace the string <UNAME> with your IMUK username, wherever it appears. Please also replace the string <UDIR>with a subdirectory name of your choice.21 In the following, please replace the string {{{<UNAME>}}} with your IMUK username, wherever it appears. Please also replace the string {{{<UDIR>}}} with a subdirectory name of your choice. 22 22 23 1. Add the following define statements for environment variables to the configuration file ( .mrun.config):24 23 1. Add the following define statements for environment variables to the configuration file ({{{.mrun.config}}}): 24 {{{ 25 25 %dvr_inc -I/home/h/niksiraa/dvr_mvapich2/lib lcsgih parallel 26 26 %dvr_lib -L/home/h/niksiraa/dvr_mvapich2/lib:-lDVRP2:-lftp lcsgih parallel 27 }}} 27 28 28 29 2. Add the dvrp-steering parameters to your NAMELIST-parameter file, e.g. 30 29 2. Add the '''dvr'''-steering parameters to your NAMELIST-parameter file, e.g. 30 {{{ 31 31 &d3par end_time = 3600.0, 32 32 ... / … … 35 35 dvrp_host = '130.75.105.6', 36 36 dvrp_directory = '<UNAME>/<UDIR>', ... / 37 }}} 38 For other '''dvr'''-parameters see [wiki:/doc/app/dvrpar list of dvr package parameters]. An example parameter file can be found in the repository under [source:palm/trunk/EXAMPLES/dvr]. 37 39 38 For other dvrp-parameters see chapter 4.2. An example parameter file can be found in directory ..../trunk/EXAMPLES/dvr.40 3. Ask the IMUK system operator (Notker Fechner) to mount the filesystem {{{/dvrdata}}} on your local computer. 39 41 40 3. Ask the IMUK system operator (Notker Fechner) to mount the filesystem /dvrdata on your local computer. 41 42 4. On the IMUK-system (your local computer), create a subdirectory in which the dvrp-data are stored and give it access permit for group palm. 43 42 4. On the IMUK-system (your local computer), create a subdirectory in which the '''dvr'''-data are stored and give it access permit for group palm. 43 {{{ 44 44 mkdir /dvrdata/<UNAME> 45 45 chmod g+rwx /dvrdata/<UNAME> 46 }}} 47 Steps 3. and 4. have to be done only once, before '''dvr''' is used for the first time. 46 48 47 Steps 3. and 4. have to be done only once, before dvrp is used for the first time. 49 5. Submit the job with '''mrun'''-command 50 {{{ 51 mrun .... -p dvrp_graphics .... 52 }}} 53 6. After the job has finished, the '''dvr'''-output can be found on the IMUK-cluster in a subdirectory under {{{/dvrdata}}}. The name of the subdirectory is determined by the '''dvr'''-parameter [wiki:/doc/app/dvrpar#dvrp_directory dvrp_directory] (see above), i.e. if the user has set {{{dvrp_directory}}} = '' '<UNAME>/movie_1' '', the '''dvr'''-data are stored under {{{/dvrdata/<UNAME>/movie_1}}}. 48 54 49 5. Submit the job with mrun-command 55 7. Change to this subdirectory (e.g. {{{/dvrdata/<UNAME>/movie_1}}}) and enter the command 56 {{{ 57 process_dvr_output 58 }}} 59 It will create a file with name {{{all_streams_streaming.html}}}. 50 60 51 mrun .... -p dvrp_graphics ....61 8. Call the opera-browser (i.e. enter the command {{{opera}}}) and open the file {{{all_streams_streaming.html}}}. 52 62 53 6. After the job has finished, the dvrp-output can be found on the IMUK-cluster in a subdirectory under /dvrdata. The name of the subdirectory is determined by the dvrp-parameter dvrp_directory (see above), i.e. if the user has set dvrp_directory = '<UNAME>/movie_1', the dvrp-data are stored under /dvrdata/<UNAME>/movie_1. 63 [[BR]] [[BR]] 54 64 55 7. Change to this subdirectory (e.g. /dvrdata/<UNAME>/movie_1) and enter the command 65 === Further features: === 56 66 57 process_dvr_output 67 The script [source:palm/trunk/SCRIPTS/process_dvr_output process_dvr_output] has additional options: 58 68 59 It will create a file with name all_streams_streaming.html. 60 61 8. Call the opera-browser (i.e. enter the command opera) and open the file all_streams_streaming.html. 62 63 Further features: 64 The script process_dvr_output has additional options: 65 66 -s : create sequence output. All streams (and static scenes) are collected to one sequence (one static scene), which can be displayed with a browser without using the streaming server (the so-called sequence mode). This allows e.g. to show animations on a notebook without beeing connected to the internet. When the script is called with this option, the sequence is generated in subdirectory sequence_data. Copy this subdirectory and the file all_streams_sequence.html to a directory on your local computer and open the file all_streams_sequence.html with your browser. For this, you will need to install the the dvr-plugin (see webpage of the dsvr-software) on your local computer, which is also available for Windows. 67 68 -a : acceleration factor. If, in case of sequence mode, the performance of the animation is to slow, you can accelerate it. E.g., by using "-a 2", only every second frame of the original streams will be used for the sequence. 69 ||{{{-s}}} ||: create sequence output. All streams (and static scenes) are collected to one sequence (one static scene), which can be displayed with a browser without using the streaming server (the so-called sequence mode). This allows e.g. to show animations on a notebook without beeing connected to the internet. When the script is called with this option, the sequence is generated in subdirectory {{{sequence_data}}}. Copy this subdirectory and the file {{{all_streams_sequence.html}}} to a directory on your local computer and open the file {{{all_streams_sequence.html}}} with your browser. For this, you will need to install the the '''dvr'''-plugin (see [http://www.dsvr-software.de/dsvr webpage of the dsvr-software]) on your local computer, which is also available for Windows.|| 70 ||{{{-a}}} ||: acceleration factor. If, in case of sequence mode, the performance of the animation is to slow, you can accelerate it. E.g., by using {{{"-a 2"}}}, only every second frame of the original streams will be used for the sequence.|| 71 [[BR]] [[BR]] 69 72 70 73 74 == Current limitations (May 09): == 71 75 72 73 Current limitations (May 09): 74 Only a special opera-version on host "bora" can be used. Log-in on "bora" and call /usr/bin/opera. Before that(!!!), enter the command "export LD_PRELOAD=libXm.so" ! 76 Only a special opera-version on host "bora" can be used. Log-in on "bora" and call {{{/usr/bin/opera}}}. Before that (''' !!! '''), enter the command "{{{export LD_PRELOAD=libXm.so}}}" !
