ScatterSim:Installing - Revision history

JulienLhermitte: /* Installing ScatterSim */

2017-07-18T22:33:05Z

‎Installing ScatterSim

JulienLhermitte: /* Installing ScatterSim */

2017-06-14T14:34:28Z

‎Installing ScatterSim

JulienLhermitte: /* Installing ScatterSim */

2017-06-14T14:34:05Z

‎Installing ScatterSim

JulienLhermitte: Created page with "== Installing ScatterSim == Here are some rough guidelines into installing ScatterSim. There are a few ways to do it, but this is a recommended method.

Download and..."

2017-06-14T14:15:19Z

Created page with "== Installing ScatterSim == Here are some rough guidelines into installing ScatterSim. There are a few ways to do it, but this is a recommended method. <ol> <li> Download and..."

New page

== Installing ScatterSim ==
Here are some rough guidelines into installing ScatterSim. There are a few ways to do it, but this is a recommended method.

<ol>
<li>
Download and install Anaconda <br />
https://www.continuum.io/downloads
</li>

<li>
Download and install git: <br />

https://git-scm.com/downloads

</li>
<li>
Download the ScatterSim library using git
<ol>
<li> Open a terminal and choose a directory where you want to install ScatterSim, for example:
<pre>
cd ~/
mkdir -p software
cd software
</pre>
</li>
<li>
Download and install ScatterSim using git:
<ol>
<li>Download using git:<br/>

<pre>
git clone https://github.com/CFN-softbio/ScatterSim.git
</pre>
</li>
</li>
<li>
Now install ScatterSim
<pre>
cd ScatterSim
python setup.py develop
</pre>
It should now be installed.
</li>
</li>
</ol>
<li>
You should be able to now run ScatterSim in a python environment.
</ol>

== Testing ScatterSim ==
To test that ScatterSim was properly installed, let's make a folder where we can add code and test.
<ol>
<li>
Create a folder where you'll want to store your notebooks, for example, in a terminal, type:
<pre>
cd ~/software
mkdir -p ScatterSim-examples
cd ScatterSim-examples
</pre>
</li>
<li>
In this folder, in the terminal, type:
<pre>
jupyter notebook
</pre>
This will open your web browser to run jupyter notebooks.
</li>
<li>
Click "New" and select one of the entries under "Notebook". Likely it will say something like "Python 3" or something similar. You should only have one entry (unless you've manually created extra notebook kernels, or installed jupyter on its own).
</li>
<li>
To test that ScatterSim is installed, type in a cell:
<pre>
from ScatterSim.NanoObjects import SphereNanoObject
</pre>
and hit SHIFT + ENTER. If you do not receive an error, then it is installed. If you do receive an error, then try to use another kernel (the entries under notebook mentioned in the previous step).
</li>
</ol>

Troubleshooting If this was not successful, then here are some things you may try:
<ul>
<li> you have two instances of jupyter installed and you are not running the correct one. Try to find them and uninstall everything. The command (linux/mac) <pre>which jupyter</pre> can help hint where the jupyter version you're using is installed. </li>
<li> Another possibilty is that you are not in the right conda environment. Simply closing your terminal and opening it again could help. Else, you may need to find out the name of your conda environments by typing in a terminal:
<pre>
conda env list
</pre>
and finally selecting the correct environment by typing:
<pre>
source activate ENV
</pre>
where ENV is one of the names in the list you saw. (it should be one entry unless you've purposely added more environments)
</li>
</ul>

== Updating ScatterSim ==
If you installed using git, you can also update ScatterSim using git. When an update is pushed to the server, it may be retrieved as follows:

<ol>
<li>
Go into ScatterSim directory. Ex:
<pre>
cd ~/software/ScatterSim
</pre>
</li>
<li>
Then run the following two commands:<br />
<pre>
git checkout master
git pull origin master
</pre>
</li>
</ol>

NOTE : If you made any changes to ScatterSim, git will complain (this could happen by accidentally opening a file and adding in a whitespace for example). To resolve this, you delete all changes you may have made by typing:
<pre>
git reset --hard
</pre>
If you wanted to keep your changes, then one option is to create a new branch for them, such as:
may either need to add the changes:
<pre>
git checkout -b development-branch-name
git add <files...>
git commit -m "MY Commit message for these edits"
</pre>
Now your changes are saved and may always be accessed by running:
<pre>
git checkout development-branch-name
</pre>
This is likely unnecessary, unless you are digging into the code.

@@ Line 1: / Line 1: @@
 == Installing ScatterSim ==
-Here are some rough guidelines into installing ScatterSim. There are a few ways to do it, but this is a recommended method.
+Here are some rough guidelines into installing ScatterSim.
 <ol>
-<li>
+  <li>
 Download and install Anaconda <br />
 https://www.continuum.io/downloads
-</li>
+  </li>
-<li>
+  <li> Download the ScatterSim Library, either:
 Download and install git: <br />
 https://git-scm.com/downloads
+    </li>
-</li>
+    <li>
-<li>
+  Download the ScatterSim library using git
-Download the ScatterSim library using git
+    <ol>
-<ol>
+      <li> Open a terminal and choose a directory where you want to install ScatterSim, for example:
 <pre>
 cd ~/
@@ Line 23: / Line 36: @@
 cd software
 </pre>
-</li>
+      </li>
-<li>
-Download and install ScatterSim using git:
+      <li>clone:<br/>
 <pre>
@@ Line 33: / Line 44: @@
 </pre>
 (For more information, you may also visit the [http://github.com/CFN-softbio/ScatterSim github page])
-</li>
+      </li>
-</li>
+    </ol>
-<li>
+    </li>
 Now install ScatterSim
 <pre>
@@ Line 42: / Line 56: @@
 </pre>
 It should now be installed.
-</li>
-</li>
-</ol>
+  </ol>
-<li>
 You should be able to now run ScatterSim in a python environment.
 == Testing ScatterSim ==

@@ Line 32: / Line 32: @@
 git clone https://github.com/CFN-softbio/ScatterSim.git
 </pre>
-(For more information, you may also visit the [http://github.com/CFN-softbio/ScatterSim| github page])
+(For more information, you may also visit the [http://github.com/CFN-softbio/ScatterSim github page])
 </li>
 </li>

ScatterSim:Installing - Revision history

JulienLhermitte: /* Installing ScatterSim */

JulienLhermitte: /* Installing ScatterSim */

JulienLhermitte: /* Installing ScatterSim */

JulienLhermitte: Created page with "== Installing ScatterSim == Here are some rough guidelines into installing ScatterSim. There are a few ways to do it, but this is a recommended method. Download and..."

JulienLhermitte: Created page with "== Installing ScatterSim == Here are some rough guidelines into installing ScatterSim. There are a few ways to do it, but this is a recommended method.

Download and..."