1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
.. _sunpy-tutorial-installing:
************
Installation
************
This is the first chapter in the sunpy tutorial, and by the end of it you should have a working installation of Python and ``sunpy``.
For further information and alternative methods for installing ``sunpy`` beyond the recommended approach outlined below, refer to :ref:`sunpy-topic-guide-installing`.
Installing Python
=================
There are many ways to install Python, but even if you have Python installed somewhere on your computer we recommend following these instructions anyway.
That's because we will create a new Python virtual environment.
As well as containing a Python installation, this virtual environment provides an isolated place to install Python packages (like ``sunpy``) without affecting any other current Python installation.
If you already have Python and ``conda`` working you can skip the next section.
`If you are using Anaconda, we recommend that you uninstall it as the default package channel(s) have a restrictive license which means you might not be able to use it for free <https://sunpy.org/posts/2024/2024-08-09-anaconda/>`__.
Instead, we recommend that you use miniforge which is a minimal installer that setups ``conda`` with the ``conda-forge`` channel, which is free to use for everyone.
If you are using miniforge, you can skip the next section
.. _sunpy-tutorial-installing-miniforge:
Installing miniforge (and conda)
================================
If you don't already have a Python installation then we recommend installing Python with `miniforge <https://github.com/conda-forge/miniforge/#miniforge>`__.
Miniforge will install ``conda`` and automatically configure the default channel (a channel is a remote software repository) to be ``conda-forge``, which is where ``sunpy`` is available.
First, download the installer for your system and architecture from the links below:
.. note::
sunpy packages are not yet available on conda-forge for aarch64 or ppc64le
architectures on linux, you will have to install sunpy from pip on these
platforms.
.. grid:: 3
.. grid-item-card:: Linux
`x86-64 <https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh>`__
`aarch64 <https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-aarch64.sh>`__
`ppc64le <https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-ppc64le.sh>`__
.. grid-item-card:: Windows
:link: https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Windows-x86_64.exe
`x86-64 <https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Windows-x86_64.exe>`__
.. grid-item-card:: Mac
`arm64 (Apple
Silicon) <https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-arm64.sh>`__
`x86-64 <https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-x86_64.sh>`__
Then select your platform to install miniforge:
.. tab-set::
.. tab-item:: Linux & Mac
:sync: platform
For Linux & Mac, run the downloaded script above using the following command:
``bash <filename>``. The following should work:
.. code-block:: console
bash Miniforge3-$(uname)-$(uname -m).sh
Once the installer has completed, restart your terminal or system if the changes don't take effect.
.. tab-item:: Windows
:sync: platform
Double click the executable file downloaded from
the links above.
Once the installer has completed you should have a new "miniforge
Prompt" entry in your start menu.
In a new terminal (miniforge Prompt on Windows) run ``conda list`` to test that the install has worked.
Installing sunpy
================
To install ``sunpy``, start by launching a terminal (under a UNIX-like system) or the miniforge Prompt (under Windows).
Now we will create and activate a new virtual environment to install ``sunpy`` into:
.. code-block:: bash
$ conda create --name sunpy
$ conda activate sunpy
In this case the virtual environment is named 'sunpy'.
Feel free to change this to a different environment name.
The benefit of using a virtual environment is that it allows you to install packages without affecting any other Python installations or versions on your system.
This also means you can work on multiple projects (research or coding) with different package requirements without them interfering with each other.
.. dropdown:: Click here if you haven't installed miniforge
:color: warning
If you have installed miniforge or are using Anaconda you need to configure conda to get your packages from conda-forge as well as the defaults channel.
SunPy no longer recommends using the defaults channel at all, see `this blog post <https://sunpy.org/posts/2024/2024-08-09-anaconda/>`__ for details as to why.
Therefore, if you are using Anaconda or miniconda we would suggest you uninstall it and install miniforge in its place.
We also appreciate this isn't going to be possible for everyone, so what follows is our best instructions for how to proceed if you are using miniconda or Anaconda.
The commands you need to run to add conda-forge and make it the default location to install conda packages from are:
.. code-block:: bash
$ conda config --add channels conda-forge
$ conda config --set channel_priority strict
These commands are taken from the
`conda-forge documentation <https://conda-forge.org/docs/user/introduction/#how-can-i-install-packages-from-conda-forge>`__.
Running these commands affect all the environments in your conda installation, critically, including the base Anaconda environment.
We highly recommend that you do not install new packages, upgrade packages or use your base environment.
Instead create new environments for all your projects, as you are much less likely to run into any pitfalls while using `multiple channels <https://conda-forge.org/docs/user/tipsandtricks/#multiple-channels>`__ by doing this.
Now that we have a fresh virtual environment, we can proceed with installing ``sunpy``:
.. code-block:: bash
$ conda install sunpy
This will install ``sunpy`` and all of its dependencies.
To ensure that ``sunpy`` was installed correctly, run the following command:
.. code-block:: bash
$ conda list sunpy
This checks if ``sunpy`` was installed correctly.
If you want to install another package later, you can run ``conda install <package_name>``.
Now we've got a working installation of ``sunpy``, in the next few chapters we'll look at some of the basic data structures ``sunpy`` uses for representing times, coordinates, and data with physical units.
|
