diff --git a/installation_instructions/windows/images/image-19.png b/installation_instructions/windows/images/image-19.png index 7c12e35fd8209138b21632c2cee2bacc7f84178d..a2b31c4299dac0c498288abb47171169d7bb7ab9 100644 Binary files a/installation_instructions/windows/images/image-19.png and b/installation_instructions/windows/images/image-19.png differ diff --git a/installation_instructions/windows/images/image-28.png b/installation_instructions/windows/images/image-28.png new file mode 100644 index 0000000000000000000000000000000000000000..0b7337887ffb61c9fc37f0093d4bcfa8506104a6 Binary files /dev/null and b/installation_instructions/windows/images/image-28.png differ diff --git a/installation_instructions/windows/images/image-29.png b/installation_instructions/windows/images/image-29.png new file mode 100644 index 0000000000000000000000000000000000000000..2e9df6f3689db8c7e94e09d7f22e4d994f3039b7 Binary files /dev/null and b/installation_instructions/windows/images/image-29.png differ diff --git a/installation_instructions/windows/images/image-30.png b/installation_instructions/windows/images/image-30.png new file mode 100644 index 0000000000000000000000000000000000000000..e885e4dddc9ffff6b2af3730dba8716b8f407cf4 Binary files /dev/null and b/installation_instructions/windows/images/image-30.png differ diff --git a/installation_instructions/windows/images/image-31.png b/installation_instructions/windows/images/image-31.png new file mode 100644 index 0000000000000000000000000000000000000000..2ea04744ea666cf72b2192c17b5e23eec9bd5d94 Binary files /dev/null and b/installation_instructions/windows/images/image-31.png differ diff --git a/installation_instructions/windows/images/image-32.png b/installation_instructions/windows/images/image-32.png new file mode 100644 index 0000000000000000000000000000000000000000..48f0900385b4e90aa8b654b5542bba8a4ca5ed88 Binary files /dev/null and b/installation_instructions/windows/images/image-32.png differ diff --git a/installation_instructions/windows/images/image-33.png b/installation_instructions/windows/images/image-33.png new file mode 100644 index 0000000000000000000000000000000000000000..4eb49949fab33cb10fb0ac1ec2a38a8df18fd100 Binary files /dev/null and b/installation_instructions/windows/images/image-33.png differ diff --git a/installation_instructions/windows/images/image-34.png b/installation_instructions/windows/images/image-34.png new file mode 100644 index 0000000000000000000000000000000000000000..453ea32996b5c909a1a50f2b0b1a0815a596a168 Binary files /dev/null and b/installation_instructions/windows/images/image-34.png differ diff --git a/installation_instructions/windows/images/image-35.png b/installation_instructions/windows/images/image-35.png new file mode 100644 index 0000000000000000000000000000000000000000..7f3c9be113553e94f9f5a6d5b81c7e1be03de477 Binary files /dev/null and b/installation_instructions/windows/images/image-35.png differ diff --git a/installation_instructions/windows/images/image-36.png b/installation_instructions/windows/images/image-36.png new file mode 100644 index 0000000000000000000000000000000000000000..994f5474ce1deb5095d87d426f42f7b0478dc629 Binary files /dev/null and b/installation_instructions/windows/images/image-36.png differ diff --git a/installation_instructions/windows/images/image-37.png b/installation_instructions/windows/images/image-37.png new file mode 100644 index 0000000000000000000000000000000000000000..8368e05b3c830062fa4f972e5ea332e0f61858eb Binary files /dev/null and b/installation_instructions/windows/images/image-37.png differ diff --git a/installation_instructions/windows/images/image-6.png b/installation_instructions/windows/images/image-6.png index 2679b7564faa09fe5dbcc4642fa6d3d72859ed28..a455bd47117e5fd2f653a03b4d3469a849790ca5 100644 Binary files a/installation_instructions/windows/images/image-6.png and b/installation_instructions/windows/images/image-6.png differ diff --git a/installation_instructions/windows/installation_instructions.html b/installation_instructions/windows/installation_instructions.html index 2fabc2506fa0032700736c5937bee6cfe6f0e39c..7044823d6114159ebfca7587982498a74467a6fe 100644 --- a/installation_instructions/windows/installation_instructions.html +++ b/installation_instructions/windows/installation_instructions.html @@ -7496,7 +7496,7 @@ a.anchor-link { <p>Download and run the installer. On the "Install for:" page select "Just Me (recommended)" and then accept the default installation folder.</p> <p><img alt="Install for Just Me" src="images/image-4.png"/> <img alt="Keep Default Install Location" src="images/image-5.png"/></p> -<p>On the Advanced Installation Options, keep the default first and third checkmarks to create a shortcut and register Anaconda3 as the default for Python.</p> +<p>On the Advanced Installation Options, keep the default first and third checkmarks to create a shortcut and register Anaconda3 as the default for Python. Keep the second checkmarks to allow using conda in command prompt (which we will learn about it later).</p> <p><img alt="Keep Default Checkmarks" src="images/image-6.png"/></p> <p>Finish running the installer.</p> <p><img alt="Final Installation Screen" src="images/image-10.png"/></p> @@ -7504,24 +7504,47 @@ a.anchor-link { <p><img alt="Command to Install Proper Version of Python" src="images/image-14.png"/></p> <p><img alt="Proceed to Installation" src="images/image-13.png"/></p> <p><img alt="Command to Check Python Version" src="images/image-15.png"/></p> -<h2 id="3.-Enable-the-debugger">3. Enable the debugger<a class="anchor-link" href="#3.-Enable-the-debugger">¶</a></h2><p>One feature of Jupyter Lab that we will use this semester is the debugger. It is disabled by default. To enable it you will need to edit a text file. Start by opening the file explorer - <img alt="File Explorer Icon" src="images/image-18.png"/> and in the sidebar, click on <em>home</em>.</p> -<p><img alt="Home option in File Explorer" src="images/image-19.png"/></p> -<p>Browse inside the <code>anaconda3</code> folder to the <code>share\jupyter\kernels\python3\</code> folder and double click to open the kernel.json file in Notepad.</p> +<h2 id="3.-Enable-the-debugger">3. Enable the debugger<a class="anchor-link" href="#3.-Enable-the-debugger">¶</a></h2><p>One feature of Jupyter Lab that we will use this semester is the debugger. It is disabled by default. To enable it you will need to edit a text file. Start by opening the file explorer</p> +<p><img alt="File Explorer Icon" src="images/image-18.png"/> and in the sidebar, click on your C disk <em>(C:)</em>.</p> +<p><img alt="C: disk option in File Explorer" src="images/image-19.png"/></p> +<p>Browse inside the <code>Users</code> folder and select the one that looks like your name (i.e. 'yunha' in the image below).</p> +<p><img alt="Users folder" src="images/image-28.png"/></p> +<p><img alt="user folder" src="images/image-29.png"/></p> +<p>If you install anaconda correctly, you should found a folder name <code>anaconda3</code> in this folder.</p> +<p><img alt="inside user folder" src="images/image-30.png"/></p> +<p>Browse inside the <code>anaconda3</code> folder. Scroll down a little bit and you should find a folder name <code>share</code>.</p> +<p><img alt="share" src="images/image-31.png"/></p> +<p>Click <code>share</code>, then click <code>jupyter</code>,<code>kernels</code>, <code>python3</code> to the <code>share\jupyter\kernels\python3\</code> folder.</p> +<p><img alt="jupyter" src="images/image-32.png"/></p> +<p><img alt="kernels" src="images/image-33.png"/></p> +<p><img alt="python3" src="images/image-34.png"/></p> +<p>Double click to open the kernel.json file in Notepad.</p> <p><img alt="Content of anaconda3/share/jupyter/kernels/python3 folder" src="images/image-20.png"/></p> -<p><img alt="Open kernel.json file with Noepad" src="images/image-21.png"/></p> +<p><img alt="Open kernel.json file with Notepad" src="images/image-21.png"/></p> <p>The line that reads <code>"debugger": false</code> needs to be changed to be <code>"debugger": true</code> and then save the file.</p> <p><img alt="Original content of kernel.json" src="images/image-16.png"/> <img alt="New content of kernel.json" src="images/image-17.png"/></p> -<h2 id="4.-Associate-Notebook-Files-with-Jupyter-Lab">4. Associate Notebook Files with Jupyter Lab<a class="anchor-link" href="#4.-Associate-Notebook-Files-with-Jupyter-Lab">¶</a></h2><p>The files that we will be working with this semester are called <em>Jupyter Notebook</em> files. These files have a file extension of <code>.ipynb</code>. You can make it so that when you double click on a file that ends in <code>.ipynb</code> that it will be opened by Jupyter Lab. Download the <a href="../test_configuration.ipynb" target="_blank" download>Test Configuration Notebook</a> which we will use to change the file assocation. Then open your Downloads folder in the File Explorer. At the top of the window, click on the <strong>View -> Show -> File name extensions</strong> option so you can see the file extension of the notebook file.</p> +<h2 id="4.-Associate-Notebook-Files-with-Jupyter-Lab">4. Associate Notebook Files with Jupyter Lab<a class="anchor-link" href="#4.-Associate-Notebook-Files-with-Jupyter-Lab">¶</a></h2><p>The files that we will be working with this semester are called <em>Jupyter Notebook</em> files. These files have a file extension of <code>.ipynb</code>. You can make it so that when you double click on a file that ends in <code>.ipynb</code> that it will be opened by Jupyter Lab. Download the <a download="" href="../test_configuration.ipynb" target="_blank">Test Configuration Notebook</a> which we will use to change the file assocation. Then open your Downloads folder in the File Explorer. At the top of the window, click on the <strong>View -> Show -> File name extensions</strong> option so you can see the file extension of the notebook file.</p> <p><img alt="Show File Name Extensions" src="images/image-22.png"/></p> -<p>Now double click to try and open the notebook file. It will ask you to select an app to open the file. Click on the <strong>Choose an app on your PC</strong> and browse to your username and open the anaconda3/Scripts folder and select <code>jupyter-lab.exe</code>.</p> +<p>Now double click to try and open the notebook file. It will ask you to select an app to open the file. Click on the <strong>Choose an app on your PC</strong></p> +<p>Now similar to part 3, browse to your username and open the <code>anaconda3</code> folder. But now after you click inside the <code>anaconda3</code> folder, click into the <code>Scripts</code> folder instead of the <code>share</code> folder. The <code>Scripts</code> folder should be right on top of the <code>share</code> folder. Inside the <code>Scripts</code> folder select <code>jupyter-lab.exe</code>.</p> <p><img alt="Select an App to open .ipynb files" src="images/image-23.png"/></p> <p><img alt="Scripts folder inside ananconda3 folder" src="images/image-24.png"/></p> <p><img alt="jupyter-lab.exe file" src="images/image-25.png"/></p> <p>Now click the <strong>jupyter-lab.exe</strong> option and click the <code>Always</code> button.</p> <p><img alt="Selecting jupyter-lab.exe always" src="images/image-26.png"/></p> <h2 id="5.-Test-the-configuration">5. Test the configuration<a class="anchor-link" href="#5.-Test-the-configuration">¶</a></h2><p>Now, whenever you double-click on a Jupyter Notebook file, it should open that file in Jupyter Lab. Follow the steps in the notebook to check your configuration and your software should be installed and configured correctly.</p> +<h2 id="6.-FAQ">6. FAQ<a class="anchor-link" href="#6.-FAQ">¶</a></h2><h4 id="1)-I-encounter-%22'conda'-is-not-recognized-as-the-name-of-a-cmdlet,-function,-script-file,-or-operable-program.%22.-What-should-I-do?">1) I encounter "'conda' is not recognized as the name of a cmdlet, function, script file, or operable program.". What should I do?<a class="anchor-link" href="#1)-I-encounter-%22'conda'-is-not-recognized-as-the-name-of-a-cmdlet,-function,-script-file,-or-operable-program.%22.-What-should-I-do?">¶</a></h4><p>This is likely because "conda" was not set as an environment variables (in part 1). There two ways of solving this problem:</p> +<p>a. Follow the instruction in this <a href="https://docs.anaconda.com/anaconda/uninstall/">link</a> and uninstall Anaconda completely. Then reinstall Anaconda and add "conda" as environment variables as described in part 1.<br/> +b. Follow the instrcution in this <a href="https://www.geeksforgeeks.org/how-to-setup-anaconda-path-to-environment-variable/">link</a> and correctly add conda to the environment variables.</p> +<h4 id="2)-I-could-not-find-anaconda3-folder.">2) I could not find <code>anaconda3</code> folder.<a class="anchor-link" href="#2)-I-could-not-find-anaconda3-folder.">¶</a></h4><p>This is likely because you did not install anaconda in the location described above. To check the exact location of the <code>anaconda3</code> folder, simply search "anaconda3" in the search bar. Once you see the anaconda3 folder as below, click open file location will take you to the folder where <code>anaconda3</code> is installed.</p> +<p><img alt="searchbar" src="images/image-35.png"/></p> +<h4 id="3)-I-can't-open-the-notebook-with-jupyter-lab.">3) I can't open the notebook with jupyter lab.<a class="anchor-link" href="#3)-I-can't-open-the-notebook-with-jupyter-lab.">¶</a></h4><p>This is likely because your default browser is not google chrome. Changing your default browser to google chrome should resolve this issue. This <a href="https://support.google.com/chrome/answer/95417?hl=en&co=GENIE.Platform%3DDesktop#zippy=%2Cwindows">link</a> have instructions on how to set the default browser to chrome.</p> +<h4 id="4)-I-have-python-installed-previously-and-is-a-different-version,-what-should-I-do?">4) I have python installed previously and is a different version, what should I do?<a class="anchor-link" href="#4)-I-have-python-installed-previously-and-is-a-different-version,-what-should-I-do?">¶</a></h4><p>In search bar type "Anaconda Prompt" and you should see an anaconda prompt app as shown in the below image. Click on the anaconda prompt and a command prompt should open up.</p> +<p><img alt="anaconda prompt" src="images/image-36.png"/></p> +<p>But now you will see a "(base)" in front. This tells you that you are in the conda environment. Now type "python --version" and <code>shift</code> + <code>enter</code> to see what is the current python version in conda environment. If it is not correct, follow the above instruction in the anaconda prompt to install the correct python version.</p> +<p><img alt="anaconda commadn prompt" src="images/image-37.png"/></p> +<h4 id="5)-My-debugger-is-not-working">5) My debugger is not working<a class="anchor-link" href="#5)-My-debugger-is-not-working">¶</a></h4><p>Open up the <code>kernel.json</code> file. Double check whether you have correctly changed and saved the content in the <code>kernel.json</code>.</p> </div> </div> </div> diff --git a/installation_instructions/windows/installation_instructions.ipynb b/installation_instructions/windows/installation_instructions.ipynb index bf41e3dfe68adf8d5b058e8f5a23051fd37546dd..1c9434fa1db4e15fa8d19152cbf798c482d74407 100644 --- a/installation_instructions/windows/installation_instructions.ipynb +++ b/installation_instructions/windows/installation_instructions.ipynb @@ -28,7 +28,7 @@ "\n", "\n", "\n", - "On the Advanced Installation Options, keep the default first and third checkmarks to create a shortcut and register Anaconda3 as the default for Python.\n", + "On the Advanced Installation Options, keep the default first and third checkmarks to create a shortcut and register Anaconda3 as the default for Python. Keep the second checkmarks to allow using conda in command prompt (which we will learn about it later).\n", "\n", "\n", "\n", @@ -50,15 +50,39 @@ "## 3. Enable the debugger\n", "\n", "One feature of Jupyter Lab that we will use this semester is the debugger. It is disabled by default. To enable it you will need to edit a text file. Start by opening the file explorer\n", - "  and in the sidebar, click on *home*.\n", "\n", - "\n", + "  and in the sidebar, click on your C disk *(C:)*.\n", "\n", - "Browse inside the `anaconda3` folder to the `share\\jupyter\\kernels\\python3\\` folder and double click to open the kernel.json file in Notepad.\n", + "\n", + "\n", + "Browse inside the `Users` folder and select the one that looks like your name (i.e. 'yunha' in the image below).\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "If you install anaconda correctly, you should found a folder name `anaconda3` in this folder. \n", + "\n", + "\n", + "\n", + "Browse inside the `anaconda3` folder. Scroll down a little bit and you should find a folder name `share`.\n", + "\n", + " \n", + "\n", + "Click `share`, then click `jupyter`,`kernels`, `python3` to the `share\\jupyter\\kernels\\python3\\` folder.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "Double click to open the kernel.json file in Notepad.\n", "\n", "\n", "\n", - "\n", + "\n", "\n", "The line that reads `\"debugger\": false` needs to be changed to be `\"debugger\": true` and then save the file.\n", "\n", @@ -72,7 +96,9 @@ "\n", "\n", "\n", - "Now double click to try and open the notebook file. It will ask you to select an app to open the file. Click on the **Choose an app on your PC** and browse to your username and open the anaconda3/Scripts folder and select `jupyter-lab.exe`.\n", + "Now double click to try and open the notebook file. It will ask you to select an app to open the file. Click on the **Choose an app on your PC**\n", + "\n", + "Now similar to part 3, browse to your username and open the `anaconda3` folder. But now after you click inside the `anaconda3` folder, click into the `Scripts` folder instead of the `share` folder. The `Scripts` folder should be right on top of the `share` folder. Inside the `Scripts` folder select `jupyter-lab.exe`.\n", "\n", "\n", "\n", @@ -86,7 +112,35 @@ "\n", "## 5. Test the configuration\n", "\n", - "Now, whenever you double-click on a Jupyter Notebook file, it should open that file in Jupyter Lab. Follow the steps in the notebook to check your configuration and your software should be installed and configured correctly." + "Now, whenever you double-click on a Jupyter Notebook file, it should open that file in Jupyter Lab. Follow the steps in the notebook to check your configuration and your software should be installed and configured correctly.\n", + "\n", + "## 6. FAQ\n", + "\n", + "#### 1) I encounter \"'conda' is not recognized as the name of a cmdlet, function, script file, or operable program.\". What should I do?\n", + "This is likely because \"conda\" was not set as an environment variables (in part 1). There two ways of solving this problem: \n", + "\n", + "a. Follow the instruction in this [link](https://docs.anaconda.com/anaconda/uninstall/) and uninstall Anaconda completely. Then reinstall Anaconda and add \"conda\" as environment variables as described in part 1. \n", + "b. Follow the instrcution in this [link](https://www.geeksforgeeks.org/how-to-setup-anaconda-path-to-environment-variable/) and correctly add conda to the environment variables.\n", + "\n", + "#### 2) I could not find `anaconda3` folder. \n", + "This is likely because you did not install anaconda in the location described above. To check the exact location of the `anaconda3` folder, simply search \"anaconda3\" in the search bar. Once you see the anaconda3 folder as below, click open file location will take you to the folder where `anaconda3` is installed. \n", + "\n", + "\n", + "\n", + "#### 3) I can't open the notebook with jupyter lab.\n", + "This is likely because your default browser is not google chrome. Changing your default browser to google chrome should resolve this issue. This [link](https://support.google.com/chrome/answer/95417?hl=en&co=GENIE.Platform%3DDesktop#zippy=%2Cwindows) have instructions on how to set the default browser to chrome.\n", + "\n", + "#### 4) I have python installed previously and is a different version, what should I do?\n", + "In search bar type \"Anaconda Prompt\" and you should see an anaconda prompt app as shown in the below image. Click on the anaconda prompt and a command prompt should open up.\n", + "\n", + "\n", + "\n", + "But now you will see a \"(base)\" in front. This tells you that you are in the conda environment. Now type \"python --version\" and `shift` + `enter` to see what is the current python version in conda environment. If it is not correct, follow the above instruction in the anaconda prompt to install the correct python version.\n", + "\n", + "\n", + "\n", + "#### 5) My debugger is not working\n", + "Open up the `kernel.json` file. Double check whether you have correctly changed and saved the content in the `kernel.json`. " ] } ],