Skip to content

Commit 3389a57

Browse files
committed
Add more info on how to configure TrackMate Conda path.
1 parent 3081dcc commit 3389a57

File tree

2 files changed

+104
-0
lines changed

2 files changed

+104
-0
lines changed

_pages/plugins/trackmate/trackmate-conda-path.md

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,5 +38,109 @@ Once you click OK, and if the parameters are correct, the log should output the
3838

3939
If this is correct, you can **relaunch Fiji for the new settings to be used**.
4040

41+
## How to find the right path and values on your system
4142

43+
In a terminal (where conda is runnable), run the following
44+
```sh
45+
conda info
46+
```
4247

48+
49+
#### 1. Conda Executable Location
50+
51+
52+
**How to find `{base_env}`**:
53+
Look for the **`base environment`** line in `conda info` output.
54+
Example:
55+
```
56+
base environment : /Users/username/mambaforge (writable)
57+
```
58+
`{base_env} = /Users/username/mambaforge`.
59+
60+
61+
62+
Examples:
63+
64+
| **OS** | **Path Format** | **Example** |
65+
|--------------|-----------------------------------------|------------------------------------------|
66+
| **Windows** | `{base_env}\Scripts\conda.exe` | `C:\ProgramData\miniconda3\Scripts\conda.exe` |
67+
| **macOS/Linux** | `{base_env}/bin/conda` | `/Users/username/mambaforge/bin/conda` |
68+
69+
70+
#### 2. `CONDA_ROOT_PREFIX`
71+
72+
This is **always the `base environment` path** from `conda info`.
73+
Look for:
74+
```
75+
base environment : <PATH> # <-- This is CONDA_ROOT_PREFIX
76+
```
77+
78+
**Examples**:
79+
- Windows: `C:\ProgramData\miniconda3`
80+
- macOS/Linux: `/Users/username/mambaforge` or `/home/username/anaconda3`
81+
82+
83+
84+
### Quick Reference Table
85+
86+
| **Field** | **Where to Look in `conda info`** | **Example (Windows)** | **Example (macOS/Linux)** |
87+
|-------------------------|----------------------------------------|-----------------------------|--------------------------------|
88+
| **Conda Executable** | `{base_env}/Scripts/conda.exe` or `{base_env}/bin/conda` | `C:\ProgramData\miniconda3\Scripts\conda.exe` | `/Users/username/mambaforge/bin/conda` |
89+
| **`CONDA_ROOT_PREFIX`** | `base environment : <PATH>` | `C:\ProgramData\miniconda3` | `/Users/username/mambaforge` |
90+
91+
---
92+
93+
### **Platform-Specific Notes**
94+
95+
- **Windows**:
96+
- Use backslashes (`\`) and `.exe` (e.g., `Scripts\conda.exe`).
97+
- System-wide installs are often in `C:\ProgramData\`.
98+
- User installs are in `C:\Users\<username>\`.
99+
100+
- **macOS/Linux**:
101+
- Use forward slashes (`/`) and no `.exe` (e.g., `bin/conda`).
102+
- User installs are typically in `/Users/<username>/` or `/home/<username>/`.
103+
- System installs may be in `/opt/`.
104+
105+
- **Read-Only vs. Writable**:
106+
- If `conda info` shows `(read only)`, the installation is system-wide (requires admin rights).
107+
- If `(writable)`, it’s user-specific.
108+
109+
### Example
110+
111+
112+
For instance on my system this yields:
113+
114+
```sh
115+
❯ conda info
116+
117+
active environment : base
118+
active env location : /Users/tinevez/mambaforge
119+
shell level : 1
120+
user config file : /Users/tinevez/.condarc
121+
populated config files : /Users/tinevez/mambaforge/.condarc
122+
conda version : 23.1.0
123+
conda-build version : not installed
124+
python version : 3.10.10.final.0
125+
virtual packages : __archspec=1=arm64
126+
__osx=15.7.1=0
127+
__unix=0=0
128+
base environment : /Users/tinevez/mambaforge (writable)
129+
conda av data dir : /Users/tinevez/mambaforge/etc/conda
130+
conda av metadata url : None
131+
channel URLs : https://conda.anaconda.org/conda-forge/osx-arm64
132+
https://conda.anaconda.org/conda-forge/noarch
133+
package cache : /Users/tinevez/mambaforge/pkgs
134+
/Users/tinevez/.conda/pkgs
135+
envs directories : /Users/tinevez/mambaforge/envs
136+
/Users/tinevez/.conda/envs
137+
platform : osx-arm64
138+
user-agent : conda/23.1.0 requests/2.28.2 CPython/3.10.10 Darwin/24.6.0 OSX/15.7.1
139+
UID:GID : 503:20
140+
netrc file : None
141+
offline mode : False
142+
```
143+
144+
And with this I put this in TrackMate conda config:
145+
146+
{% include img src="/media/plugins/trackmate/trackmate-configure-conda-03.png" %}
347 KB
Loading

0 commit comments

Comments
 (0)