Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated notes about conda #1581

Open
wants to merge 21 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
5b40e9c
updated notes on conda.
ChrisBarker-NOAA Aug 1, 2024
934e11b
added updated conda info to the scientific packages page.
ChrisBarker-NOAA Aug 1, 2024
c864782
Update source/key_projects.rst
ChrisBarker-NOAA Aug 19, 2024
049603c
Update source/key_projects.rst
ChrisBarker-NOAA Aug 19, 2024
e0c0e7a
Update source/key_projects.rst
ChrisBarker-NOAA Aug 19, 2024
f62b5b5
reworked intro paragraph to address duplicate links, and cleaner entry
ChrisBarker-NOAA Aug 19, 2024
fd59cbe
Update source/key_projects.rst
ChrisBarker-NOAA Aug 19, 2024
e3e561f
fixed netlib link
ChrisBarker-NOAA Aug 19, 2024
78be284
Merge branch 'conda_notes' of https://github.com/ChrisBarker-NOAA/pyt…
ChrisBarker-NOAA Aug 19, 2024
6c7c95a
updated notes on conda.
ChrisBarker-NOAA Aug 1, 2024
7763ab9
added updated conda info to the scientific packages page.
ChrisBarker-NOAA Aug 1, 2024
43d4f09
Update source/key_projects.rst
ChrisBarker-NOAA Aug 19, 2024
b605abf
Update source/key_projects.rst
ChrisBarker-NOAA Aug 19, 2024
fee8b5a
Update source/key_projects.rst
ChrisBarker-NOAA Aug 19, 2024
485460a
reworked intro paragraph to address duplicate links, and cleaner entry
ChrisBarker-NOAA Aug 19, 2024
2fee517
Update source/key_projects.rst
ChrisBarker-NOAA Aug 19, 2024
0f301ce
fixed netlib link
ChrisBarker-NOAA Aug 19, 2024
8d8b310
Merge branch 'conda_notes' of https://github.com/ChrisBarker-NOAA/pyt…
ChrisBarker-NOAA Nov 4, 2024
5a59ab3
slight edit to anaconda.org link
ChrisBarker-NOAA Nov 4, 2024
7b0217b
Merge branch 'pypa:main' into conda_notes
ChrisBarker-NOAA Nov 4, 2024
4e1e75d
added https://anaconda.org to linkcheck-ignore -- the link checker do…
ChrisBarker-NOAA Nov 4, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions source/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,7 @@
# https://github.com/pypa/packaging.python.org/pull/1474
"https://stackoverflow.com/*",
"https://pyscaffold.org/*",
"https://anaconda.org",
]
linkcheck_retries = 5
# Ignore anchors for links to GitHub project pages -- GitHub adds anchors from
Expand Down
25 changes: 13 additions & 12 deletions source/guides/installing-scientific-packages.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@ In particular, `NumPy <https://numpy.org/>`__, which provides the basis
for most of the software in the `scientific Python stack
<https://scientific-python.org>`_ can be configured
to interoperate with different FORTRAN libraries, and can take advantage
of different levels of vectorised instructions available in modern CPUs.
of different levels of vectorized instructions available in modern CPUs.

Starting with version 1.10.4 of NumPy and version 1.0.0 of SciPy, pre-built
32-bit and 64-bit binaries in the ``wheel`` format are available for all major
operating systems (Windows, macOS, and Linux) on PyPI. Note, however, that on
Windows, NumPy binaries are linked against the `ATLAS
<http://www.netlib.org/atlas/>`__ BLAS/LAPACK library, restricted to SSE2
<https://math-atlas.sourceforge.net/>`__ BLAS/LAPACK library, restricted to SSE2
instructions, so they may not provide optimal linear algebra performance.

There are a number of alternative options for obtaining scientific Python
Expand Down Expand Up @@ -118,21 +118,22 @@ be loaded and unloaded from the user's environment.
The conda cross-platform package manager
----------------------------------------

`Anaconda <https://www.anaconda.com/products/individual/>`_ is a Python distribution
published by Anaconda, Inc. It is a stable collection of Open Source
packages for big data and scientific use. As of the 5.0 release of Anaconda,
about 200 packages are installed by default, and a total of 400-500 can be
installed and updated from the Anaconda repository.

``conda`` is an open source (BSD licensed) package management system and
environment management system included in Anaconda that allows users to install
environment management system that allows users to install
multiple versions of binary software packages and their dependencies, and
easily switch between them. It is a cross-platform tool working on Windows,
macOS, and Linux. Conda can be used to package up and distribute all kinds of
MacOS, and Linux. Conda can be used to package up and distribute all kinds of
packages, it is not limited to just Python packages. It has full support for
native virtual environments. Conda makes environments first-class citizens,
making it easy to create independent environments even for C libraries. It is
written in Python, but is Python-agnostic. Conda manages Python itself as a
package, so that :command:`conda update python` is possible, in contrast to
pip, which only manages Python packages. Conda is available in Anaconda and
Miniconda (an easy-to-install download with just Python and conda).
pip, which only manages Python packages.

Anaconda `Anaconda <https://docs.anaconda.com/anaconda/>`_ is a Python distribution published by Anaconda, Inc. It is a stable collection of Open Source packages for big data and scientific use, and a collection of Graphical Interface utilities for managing conda environments.

In addition to the full distribution provided by Anaconda, the conda package manager itself is available in `miniconda <https://docs.anaconda.com/miniconda/>`_, `miniforge <https://github.com/conda-forge/miniforge>`_, and `pixi <https://pixi.sh/>`_.


Conda packages are available on multiple channels on Anaconda.org, including the
default channel supported by Anaconda, Inc, the community supported conda-forge channel, which provides a wide variety of pre-built packages, and some domain-specific package collections.
40 changes: 22 additions & 18 deletions source/key_projects.rst
Original file line number Diff line number Diff line change
Expand Up @@ -404,26 +404,30 @@ conda

:doc:`Docs <conda:index>`

conda is the package management tool for `Anaconda
<https://docs.anaconda.com/anaconda/>`__ Python installations.
Anaconda Python is a distribution from `Anaconda, Inc
<https://www.anaconda.com/products/individual>`__ specifically aimed at the scientific
community, and in particular on Windows where the installation of binary
extensions is often difficult.
Conda is a package, dependency, and environment management system for any language — Python, R,
Ruby, C/C++, Fortran, and more. It is written in Python and
widely used in the Python scientific computing community, due to its support for non-Python
compiled libraries and extensions. It is used as the basis of the `Anaconda
<https://docs.anaconda.com/anaconda/>`__ Python distribution from Anaconda, Inc. It was originally
aimed at the scientific community, but can also be used on its own, or with the
:doc:`miniconda <conda:miniconda>`, `miniforge <https://github.com/conda-forge/miniforge>`_ or
`pixi <https://pixi.sh/>`_ systems. It is available for Windows, Mac and Linux systems.

Conda is a completely separate tool from :ref:`pip`, virtualenv and wheel, but provides
many of their combined features in terms of package management, virtual environment
management and deployment of binary extensions.

Conda does not install packages from PyPI and can install only from
the official Anaconda repositories, or anaconda.org (a place for
user-contributed *conda* packages), or a local (e.g. intranet) package
server. However, note that :ref:`pip` can be installed into, and work
side-by-side with conda for managing :term:`distributions
<Distribution Package>` from PyPI. Also, `conda skeleton
<https://docs.conda.io/projects/conda-build/en/latest/user-guide/tutorials/build-pkgs-skeleton.html>`__
is a tool to make Python packages installable by conda by first
fetching them from PyPI and modifying their metadata.
many of their combined features, such as package management, virtual environment
management and deployment of binary extensions and other binary code.

Conda does not install packages from PyPI -- it can only manage packages built specifically
for conda, which can be made available on a "conda channel", such as those hosted on
`anaconda.org <https://anaconda.org>`__, or a local (e.g. intranet) package server.
In addition to the "default" channels managed by `Anaconda, Inc. <https://www.anaconda.com/>`__, there are a wide variety of packages from the community supported
`conda-forge project <https://conda-forge.org/>`__

Note that :ref:`pip` can be installed into, and work side-by-side with conda
for managing :term:`distributions <Distribution Package>` from PyPI. It is also possible
to build conda packages from Python source packages using tools such as
`conda skeleton
<https://docs.conda.io/projects/conda-build/en/latest/user-guide/tutorials/build-pkgs-skeleton.html>`__: a tool to automatically make conda packages from Python packages available on PyPI.

.. _devpi:

Expand Down
Loading