Skip to content

Installation

Caleb edited this page May 1, 2017 · 18 revisions

This installation guide is focused on getting first time users started on the Fisk CubeSat code repository. Advanced users can skip most (or all) of this installation guild. Please make improvements to this guide as issue crop up.

It is always a good idea to back up you commuter before making any major changes. That way you can always start over if something undesirable happens.

Windows 10 install

Step 1: Determine if the computer is a 32-bit or 64-bit system

You first need to check if you computer is running a 32-bit or 64-bit version of windows. a) Find window Settings b) Click on System Settings c) Click on About d) Scroll to System Type and there you can find information about the bit-ness of your operating system (OS) and your processor. Mine says "System type 64-bit operating system, x64-based processor"

Step 2: Download and install GIT, a common version control software.

Next download the version of GIT for Window, if you are lucky the link will still exist here: https://git-scm.com/download/win

a) Run the downloaded program, and start the installation. b) I unchecked the Windows Explorer integration and its sub-options. c) I selected use GIT from the Windows Command Prompt d) I selected Use the OpenSSL library e) Please select Chechout Windows-style, commit UNIX style line endings f) I selected Use Widows' default console window. g) I left Enable file system caching and Enable GIT Credential Manager checked.

This is mostly the default installation, feedback on how this choices effect the end result is appreciated.

Step 3: Sign up for GitHub, an online code repository and version control service (free for our uses).

a) Create a username, and password by signing up here https://github.com/. b) Don't forget to confirm you email address at the end of the sign up.

Note: this is the site that hosts the Fisk Cubesat code and this wiki that you are currently reading.

Step 4: Download and install PyCham, an interactive development environment (IDE) for Python.

Download the PyCham Community Edition for your Window' computers' bitness at the following link. https://www.jetbrains.com/pycharm/download/#section=windows

a) Run the the downloaded program and start the installation. b) I selected to create a 64-bit launcher and to make associations with files the end in the suffix .py, otherwise I did the default installation. c) Finish the installation and run PyCham. d) For a fresh install, select Do not import settings e) Accept the privacy policy. f) I like the following settings for PyCham's Keymap and look; Keymap scheme: IntelliJ IDEA Classic, IDE theme: Darcula, Editor colors and fonts: Monokai.

Step 5: Getting The Fisk CubeSat code from GitHub.

a) Launch PyCham and select Check out From Version Control and from the drop down menu select GitHub. b) Change Auth Type: to password and enter the user name and password that you registered and confirmed in step 3. c) For the Git Repository ULR carefully cut-and-paste https://github.com/chw3k5/fiskCubeSat.git. The other test boxes should look like Parent Directory: C:\Users\my username\PycharmProjects, and Directory Name: fiskCubeSat d) Click on Clone e) Close the tip of the day f) In the lower-left of the PyCham Window, click on the small square icon. This pops up short cuts to some of the many development features for PyCham g) In the left side of the window click on project to expand the directory structure of the Fisk CubeSat code repository. h) Expand the directory structure by clicking on the clicking on the triangle to the left of fiskCubeSat and select a .py file to open.

Step 6: install Python 2.7 on your computer.

This step can be skipped if you already have python 2.7 somewhere on your computer.

a) Navigate to https://www.python.org/downloads/windows/ and click the link for Latest Python 2 release At the time this wiki was written it was python 2.7.13. I expect it to be python 2.7.x, as micro releases are now the only updates for Python 2. This micro releases mostly add backwards compatibility for Python 2 to work with new projects and ideas that are made for Python 3. b) depending on the bit-ness of your computer (see step 1) you will use a different installer. For 64-bit installation I selected Windows x86-64 MSI installer to download. c) Run the Python installer. d) Install for all users. Install in _C:\Python27_. This is the default installation. Window may complain about a program making change to your computer, allow those changes. e) Finish the installation

Step 7: Configureing the Python interpreter in PyCham.

a) Open fiskCubesat protect in PyCham. b) In PyCham, go to File -> Settings (Or Use Ctl-Alt-S). Then select click the triangle next to Project: fiskCubeSat and select "Project Interpreter". c) In the main settings window area on the right, you will see the entry at the top of the window for Project Interpreter: with a drop down menu. d) Click on the down triagle for the drop down menu and select the (which may have been freshly installed in step 6) C:\Python27\python.exe. e) Click the Apply button at the bottom-right of the settings window.

Step 8: Installing and updating Python packages using PyCham

Clone this wiki locally