Added setup instructions

README.md

@@ -1,47 +1,18 @@
 # ShallowWaterGPU
 
-## Systems
-Connection and run details for all potential benchmark systems.
+## Setup
+A good place to start exploring this codebase is the notebooks. Complete the following steps to run the notebooks:
 
-### OsloMet 2 x Quadro RTX 6000 (VPN necessary)
-Connect:  
-ssh -AX ip-from-webpage  
+1. Install conda (see e.g. Miniconda or Anaconda)
+2. Change directory to the repository root and run the following commands
+3. conda env create -f conda_environment.yml
+4. conda activate ShallowWaterGPU
+5. jupyter notebook
 
-For Jupyter Notebook:  
-Access https://seymour.cs.oslomet.no in browser and open terminal 
-(one time operation) conda env create -f conda_environment.yml  
-conda activate ShallowWaterGPU / choose the "conda:ShallowWaterGPU" kernel in the notebook  
+Make sure you are running the correct kernel ("conda:ShallowWaterGPU"). If not, change kernel using the "Kernel"-menu in the notebook.
 
-### Simula DGX-2
-Connect:  
-ssh -YAC2 dnat.simula.no -p 60441 (and then ssh -Y g001 for direct login to DGX-2 box)
+If you do not need to run notebooks you may use the conda environment found in conda_environment_hpc.yml
 
-Example job script:  
-dgx-2-test.job
+## Troubleshooting
+Have a look at the conda documentation and https://towardsdatascience.com/how-to-set-up-anaconda-and-jupyter-notebook-the-right-way-de3b7623ea4a
 
-Submit:  
-module use /cm/shared/ex3-modules/latest/modulefiles   # Latest ex3-modules    
-module load slurm/20.02.7                              # To load slurm module  
-sbatch dgx-2-test.job
-
-### PPI 4 x P100 (VPN necessary)
-Connect:  
-ssh -AX gpu-01.ppi.met.no  
-ssh -AX gpu-02.ppi.met.no  
-ssh -AX gpu-03.ppi.met.no  
-ssh -AX gpu-04.ppi.met.no
-
-Submit:  
-run_script_ppi.sh
-
-### Saga 8 nodes with 4 x P100
-Connect:  
-ssh -AX saga.sigma2.no
-
-Example job script:  
-saga-dev.job
-
-Submit:  
-sbatch saga-dev.job
-
-### Granada: 2 x RTX 2080 + 1 x RTX "new" + X x P100

SYSTEMS.md

@@ -0,0 +1,62 @@
+$ANSIBLE_VAULT;1.1;AES256
+61316265663939333638336466323036663861343233316466646432313138653633623662353937
+3232313165656633346432376237383566363537366534310a303231343936663438653835373161
+35616161323432653062323164623861353065333761663136313137333732313230626665386336
+6166656538396463370a356166316363326133313864386536323236346634323537393639653038
+66336337336132613061353964613638326233356336323962366531333932366539366339623563
+36333365326463616634323939333062363263636663373635653064626138363464666233316561
+63393735393233616437386537393739393433663631313864646535636262616336333631396166
+38643636323530386565396338623366393232313838356536303537393338393634666632656234
+65353930303762333639376638336364303439306132626531326132376264623063376464636430
+32333536386134333136313139313861306364333037323363393463333664633764653937623866
+34313064346261313330373132353563343761323435393930303136353865303163373937623831
+64343038373162333039653161643233353764633337366434396638376530636261323362373434
+38393630613065356632663533333331633039663935663732353234643131306665343339373265
+64356563653838613337663132663234356462343333623139626662363764656239326637653832
+35396636643937336431623531306133643137623831333936313839333738333730373136666336
+35623965643664343164373630313362656663386638376237616134343631386366313336626138
+62376436383837376539663438346431633138383363633862356366376537393932626262383637
+31323365333139653736623233636233323162343039663035346135326638633430303134396337
+36353264313835346130643736663665386364343835643166383361316631373338663731373335
+30313530326662663937666330643565363565616566633333363535656539656531666266613638
+30306264613438363265646332386535383238373433396337633636616532626161343236336533
+36366362653137333739353737386563613136653164383437316237643533633133313735633363
+64326433356266363133343339626333633063326533383632353639613163663966376465396231
+36663034363534396430316463386564663465323036613636343136643262666566303533346439
+63396466656639623836613130363835346435633437666463363333356231343038356434343861
+66643636633739336666316566653136363862346336353862653130346335363334616430366435
+30376365383262326438306266366265363030353764633630333034663037643037343132303631
+39316364366234363339363130333765616432306331373566393530653963356539636437383062
+34633938643563656363633864656361643539663833356638356365373061663964363530393535
+37646533386235613763396638393539303062326239633238373763326561313634313265613135
+64646138313562313732393732303133343234323438616165326530333234626363393735636530
+62353735313231353662353533636134306530623339383730306332613636663366653566313935
+32343935353566656130393533323639353863666436333839386463396337336635356663373136
+61323734613239396236393266363631313465363630306565636663396235626132336339623938
+62383435643661623938393662363262376566613365613465323432343534356433323330666133
+30303963656635303734316539333038663962626331313366666337663165323230646564623935
+61316630353739386365323339626166323562616630383538393733353864396565353039656333
+30343038636231363531383061613836653038373937616163643963393231356235626531366239
+62343333326434636665363931376235313535343135626261336439636663323233383565633964
+65333830613131396630336337646230393038386536336365313738316335386261393838383961
+64656331363738616539346663613261386639353437316231636533353031336464383432623939
+65386164396231393735643563663337643563633233373338643630313739373861356166616463
+35306263333963663434376263396464323135346663376334356134393066653439376263376231
+30333730383163366636323533393334336331633234306536376634313735613263366537346536
+62366564383861656662353738366665396639313833323038356661306135393338333466333563
+32653861346166663163383036386432343833333137663462343030363762663139366534326466
+66313864623438336164333430613766373430656536323964633863333931643036656563353639
+30313835666366383035343031643265386263316165323537613636656533376239633964393866
+61646163343032313036303738643763383364663134356634373262633361383035306231636364
+39333232636538643033313438396332383962656131363365666566633239366532326336363133
+38393064643030333538333562643435663434343863383834663266373337336433313663646164
+36343334343965623830613736393231666361643239663062393239613233376335383362666161
+66383035653330373736613234303631386163656561383138613363613539396332376162316131
+61313532653531653836343731636535623066383231613635316432323331623761383833623333
+39343632623961613561373261653939636363366531303839336237383166363733303538363237
+36373362636263666334316163633766303334373033636539353464393536356466636664333665
+32643135626366666137626464393961366165383334343063356334373534633764326162363837
+38643662326266313464343464646166643235663663303761313639376537306337353863336264
+66376335333738366265343636376363366365306137336665623466626261653937656461303332
+32613561616662383032393562613831626666373134303032626134313262363830326530643632
+61366133663564313933366430396430353762386133396436633839303766653765