Skip to content

Commit

Permalink
Update installation instructions (#313)
Browse files Browse the repository at this point in the history
* Update installation instructions
---------

Co-authored-by: Edoardo Pasca <[email protected]>
  • Loading branch information
DanicaSTFC and paskino committed Jun 25, 2024
1 parent fdf6a79 commit cc7bb4d
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 11 deletions.
4 changes: 3 additions & 1 deletion CHANGES.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,10 @@ Bug fixes:

Enhancements:
* Add units to rotation angle in point cloud #311

Documentation:
* Edits results documentation and help text #309
* Edit results documentation and help text #309
* Edit installation documentation #313

## v24.0.0
New features:
Expand Down
21 changes: 11 additions & 10 deletions docs/source/installation.rst
Original file line number Diff line number Diff line change
@@ -1,26 +1,27 @@
Installation
************

Currently the app is available to install on windows. Linux and MacOS versions are currently a work in progress.
Binary installation of iDVC can be achieved with conda. Currently we only tested the app on Windows.

Installing the App
==================
1. Install miniconda: https://docs.conda.io/en/latest/miniconda.html
2. Open an anaconda prompt (miniconda) and type...
3. ``conda create --name idvc idvc=22.3.0 -c ccpi -c paskino -c conda-forge -c defaults --override-channels`` (or replace 22.3.0 with the latest version number)
4. ``activate idvc``
5. ``idvc``
2. Open an anaconda prompt (miniconda).
3. Create a new environment and install the software by typing ``conda create --name idvc_environment -c conda-forge -c ccpi idvc=24.0.0`` (or replace ``24.0.0`` with the latest version number).
4. Activate the environment by typing ``activate idvc_environment``.
5. Run the app by typing ``idvc``.

Please note that whenever you would like to open the app you need to carry out steps 2, 4 and 5 above.
Alternatively, use miniforge (https://github.com/conda-forge/miniforge) instead of miniconda.

Updating the App
================
If you have previously installed the app, to get an updated version:

1. Open anaconda prompt (miniconda) and type…
2. ``activate idvc`` (note that when you created your environment, if you called it something else you need to replace 'idvc' with your environment name.)
3. ``conda install idvc=22.3.0 -c ccpi -c paskino -c conda-forge -c defaults --override-channels`` (or replace 22.3.0 with the latest version number)
4. Then use: ``idvc`` to open up the app, as normal
1. Open anaconda prompt (miniconda).
2. Type ``activate idvc_environment`` (note that when you created your environment, if you called it something else you need to replace ``idvc`` with your environment name.)
3. Type ``conda install idvc=24.0.1 -c ccpi -c conda-forge`` (or replace ``24.0.1`` with the latest version number)
4. Type ``idvc`` to open up the app, as normal.

Installing the DVC Executable Only
==================================
Expand All @@ -29,7 +30,7 @@ Alternatively, if you would only like to install the dvc executable and not the

1. Install miniconda<https://docs.conda.io/en/latest/miniconda.html>
2. Open an anaconda prompt (miniconda) and type….
3. ``conda create --name dvc-core ccpi-dvc -c ccpi -c paskino -c conda-forge -c defaults --override-channels``
3. ``conda create --name dvc-core ccpi-dvc -c ccpi -c conda-forge ``

Check warning on line 33 in docs/source/installation.rst

View workflow job for this annotation

GitHub Actions / build

Inline literal start-string without end-string.

Check warning on line 33 in docs/source/installation.rst

View workflow job for this annotation

GitHub Actions / build

Inline literal start-string without end-string.

Check warning on line 33 in docs/source/installation.rst

View workflow job for this annotation

GitHub Actions / build

Inline literal start-string without end-string.
4. ``activate dvc-core``
5. ``dvc``

Expand Down

0 comments on commit cc7bb4d

Please sign in to comment.