Skip to content

Latest commit

 

History

History
76 lines (40 loc) · 3.96 KB

functionality.md

File metadata and controls

76 lines (40 loc) · 3.96 KB

A Tour of SageMathCloud

SageMathCloud contains a lot of functionality, including the ability to run Linux terminals, Jupyter Notebooks and Sage Worksheets, along with a wide range of course management facilities.

In this section, we'll take a closer look at some of the features not related to course management. Course management features are described elsewhere in this session.

Create your first project

Log into SageMathCloud and click on the projects icon in the top left hand corner of the screen.

Projects icon

Click on Create New Project, fill out the Title and Description and click on Create Project.

Create Project

Once you've created your project, click on the project title to open it. It will initially be empty, so we'll start creating files.

Linux terminal

SageMathCloud provides full access to the Linux terminal. To open a terminal, click on New and give your session a name. I've used terminal session in the example. Click on >_ Terminal to begin your session

Create Terminal

This starts up a traditional looking Bash session

Running Terminal

The terminal welcome message gives you an idea of some of the software that's available. A partial list includes

  • C, C++ and Fortran compilers such as gcc and clang and gfortran
  • Mathematical and statistical software such as Sage, GNU Octave, R and Gap
  • Text editors, including vim, emacs, joe and nano
  • Programming languages such as julia and ocaml
  • The popular alternative zsh to Bash
  • Version control via git
  • LaTeX

The distribution is based on Ubuntu Linux but it is not possible to install software yourself using apt-get.

If you need something installed, contact the SageMathCloud team for some help. Anything they install is then available to all SageMathCloud projects.

When you start a terminal session called foo, a file called foo.term is created. Its contents are not particularly interesting as they only mean something to the SageMathCloud system. The file is useful, however, in that it can be used to re-open a terminal session at the same place you previously left off (unless the session ends due to inactivity).

Jupyter Notebooks

To start a new Jupyter notebook, click on New and give your notebook a name. I've used example_notebook in the example. Click on Jupyter Notebook to open the notebook.

Open Notebook

The notebook starts with a Python 2 kernel by default. Change the kernel by clicking on kernel->change kernel and selecting the kernel you want. There are several available including Python 3, R, Julia, Octave, SageMath and Apache Spark.

kernel choice

TODO: SMC Enhancements to the notebook Publish Time Travel. Backup policy at https://github.com/sagemathinc/smc/wiki/FAQ#backup

Sage Worksheets

TODO

What can't be done in SageMathCloud?

SageMathCloud does not have integrated web-based support for X Windows, which means that applications that require a GUI cannot be used. This includes things like gedit, Spyder and xclock. (You can use ssh -X ... from a computer with X windows support to display applications that run on SMC locally on your computer.)

Since SageMathCloud is Linux based, it is not possible to run Windows applications such as Microsoft Word, Powerpoint and Excel.

You might think it wouldn't be possible, but it is possible to install commercial software such as MATLAB or Mathematica on SageMathCloud if you have an appropriate license (some users do this).

Getting help

If you need help from the SageMath team, you can create a support ticket by emailing [email protected] or clicking on the help icon in the top right hand corner of most SageMathCloud screens.

Running Terminal