zhyang-dev/CFDEMcoupling-PFM
1
0
Fork 0
mirror of https://github.com/ParticulateFlow/CFDEMcoupling-PFM.git synced 2025-12-08 06:37:44 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

release on 2012-07-17_15-56-10

Browse Source
This commit is contained in:
cfdem
2012-07-17 15:56:10 +02:00
parent 811a525493
commit 0323774ed4
1167 changed files with 81304 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

141
doc/githubAccess_public.txt Normal file
View File

@ -0,0 +1,141 @@
"CFDEMproject WWW Site"_lws - "CFDEM Commands"_lc :c
:link(lws,http://www.cfdem.com)
:link(lc,CFDEMcoupling_Manual.html#comm)
:link(github,http://github.com)
:link(gitHelp,http://help.github.com/linux-set-up-git)
:line
githubAccess_public :h3
:line
[Description:]
This routine describes how to setup a github account and pull repositories of the CFDEMproject.
After setting some environment variables LIGGGHTS and CFDEMcoupling can be compiled
[Procedure:]
Basically the following steps have to be performed:
{git clone} the desired repository :ulb,l
update your repositories by {git pull} :l
set environment variables :l
compile LIGGGHTS and CFDEMcoupling :l
run your own cases :l
:ule
[{git clone} the desired repository:]
If not already done, open a terminal and create a directory for LIGGGHTS in $HOME:
cd :pre
mkdir LIGGGHTS :pre
cd LIGGGHTS :pre
To clone the public LIGGGHTS repository, open a terminal and execute:
git clone git://cfdem.git.sourceforge.net/gitroot/cfdem/liggghtsdev LIGGGHTS-PUBLIC :pre,h6
If not already done, open a terminal and create a directory for CFDEMcoupling in $HOME:
cd :pre
mkdir CFDEM :pre
cd CFDEM :pre
Make sure that OpenFOAM(R)-2.1.x is already set up correctly!
To clone the public CFDEMcoupling repository, open a terminal and execute:
git clone git://github.com/CFDEMproject/CFDEMcoupling-PUBLIC.git CFDEMcoupling-PUBLIC-$WM_PROJECT_VERSION :pre,h6
Troubles? See Troubleshooting section below.
[Update your repositories by {git pull}:]
To get the latest version, open a terminal, go to the location of your local installation and type:
{Warning: git stash will remove your changes in $HOME/CFDEM/CFDEMcoupling-PUBLIC-$WM_PROJECT_VERSION !}
cd $HOME/CFDEM/CFDEMcoupling-PUBLIC-$WM_PROJECT_VERSION
git stash
git pull :pre
[Set Environment Variables:]
Now you need to set some environment variables in ~/.bashrc (if you use c-shell, manipulate ~/.cshrc accordingly). Open ~/.bashrc
gedit ~/.bashrc & :pre
add the lines (you find them also in .../cfdemParticle/etc/bashrc and cshrc respectively):
#================================================#
#- source cfdem env vars
export CFDEM_VERSION=PUBLIC
export CFDEM_PROJECT_DIR=$HOME/CFDEM/CFDEMcoupling-$CFDEM_VERSION-$WM_PROJECT_VERSION
export CFDEM_SRC_DIR=$CFDEM_PROJECT_DIR/src/lagrangian/cfdemParticle
export CFDEM_SOLVER_DIR=$CFDEM_PROJECT_DIR/applications/solvers
export CFDEM_DOC_DIR=$CFDEM_PROJECT_DIR/doc
export CFDEM_UT_DIR=$CFDEM_PROJECT_DIR/applications/utilities
export CFDEM_TUT_DIR=$CFDEM_PROJECT_DIR/tutorials
export CFDEM_PROJECT_USER_DIR=$HOME/CFDEM/$LOGNAME-$CFDEM_VERSION-$WM_PROJECT_VERSION
export CFDEM_bashrc=$CFDEM_SRC_DIR/etc/bashrc
export CFDEM_LIGGGHTS_SRC_DIR=$HOME/LIGGGHTS/LIGGGHTS-PUBLIC/src
export CFDEM_LIGGGHTS_MAKEFILE_NAME=fedora_fpic
export CFDEM_LPP_DIR=$HOME/LIGGGHTS/mylpp/src
export CFDEM_PIZZA_DIR=$HOME/LIGGGHTS/PIZZA/gran_pizza_17Aug10/src
. $CFDEM_bashrc
#================================================# :pre
Save the ~/.bashrc, open a new terminal and test the settings. The commands:
$CFDEM_PROJECT_DIR
$CFDEM_SRC_DIR
$CFDEM_LIGGGHTS_SRC_DIR :pre
should give "...: is a directory" otherwise something went wrong and the environment variables in ~/bashrc are not set correctly.
To specify the paths of pizza, please check the settings in $CFDEM_SRC_DIR/etc/bashrc.
If $CFDEM_SRC_DIR is set correctly, you can type
cfdemSysTest :pre
to get some information if the paths are set correctly.
[Compile LIGGGHTS and CFDEMcoupling:]
If above settings were done correctly, you can compile LIGGGHTS by typing:
cfdemCompLIG :pre
and you can then compile CFDEMcoupling by typing:
cfdemCompCFDEM :pre
You can run the tutorial cases by executing .../etc/testTutorial.sh through the alias {cfdemTestTUT}.
Alternatively you can run each tutorial using the {Allrun.sh} scripts in the tutorial directories.
In case questions concerning the installation arise, please feel free to contact our forum at www.cfdem.com.
[Run Your Own Cases:]
If you want to run your own cases, please do so in $CFDEM_PROJECT_USER_DIR/run which is automatically being generated. E.g. copy one of the tutorial cases there, adapt it to your needs.
Changes in $CFDEM_TUT_DIR will be lost after every {git stash}!
[Troubleshooting:]
toubles with git clone? :ulb,l
:ule
[a)] The git protocol will not work if your computer is behind a firewall which blocks the relevant TCP port, you can use alternatively (write command in one line):
git clone https://user@github.com/CFDEMproject/CFDEMcoupling-PUBLIC.git
CFDEMcoupling-PUBLIC-$WM_PROJECT_VERSION
[b)] If you face the error: "error: SSL certificate problem, verify that the CA cert is OK. Details: error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed while accessing https://github.com/...",
please use: env GIT_SSL_NO_VERIFY=true git clone https://github...
(see http://stackoverflow.com/questions/3777075/https-github-access)