# PINGInstaller
[![PyPI - Version](https://img.shields.io/pypi/v/pinginstaller?style=flat-square&label=Latest%20Version%20(PyPi))](https://pypi.org/project/pinginstaller/)
Light-weight application for installing [PINGMapper](https://github.com/CameronBodine/PINGMapper) and associated packages. `PINGInstaller` is designed to install a `conda` environment from a yml specified as a URL or localy hosted yml.
Example yml file structure:
```bash
name: ping
channels:
- conda-forge
- defaults
dependencies:
- python < 3.13
- gdal
- numpy
- git
- pandas
- geopandas
- pyproj
- scikit-image
- joblib
- matplotlib
- rasterio
- h5py
- pip
- pip:
- pingverter
- pingmapper
- pingwizard
- pinginstaller
- doodleverse_utils
- psutil
- tensorflow
- tf-keras
- transformers
- pysimplegui == 5.0.*
```
The special thing about `PINGInstaller` is that it will install the `conda` environment based on the `conda` prompt it is launched from. This enables end-users with multiple `conda` installations to choose the flavor of `conda` as needed.
Supported prompts include (but may not be limited to):
- [Miniforge](https://conda-forge.org/download/)
- [Miniconda](https://docs.anaconda.com/miniconda/install/)
- [Anaconda](https://www.anaconda.com/download)
- [ArcGIS Python Command Prompt](https://pro.arcgis.com/en/pro-app/3.3/arcpy/get-started/installing-python-for-arcgis-pro.htm)
`PINGInstaller` is also compatible with projects in the [Doodlevers](https://github.com/settings/organizations).
## Installation & Usage
### Step 1
Open (download, if not already available) the `conda` prompt you want to use (ex: On Windows 11 - Start --> All --> Anaconda (miniconda3) --> Anaconda Powershell Prompt).
### Step 2
Install `PINGInstaller` in the `base` environment with:
```bash
pip install pinginstaller
```
### Step 3
Then install the environment from a web or locally hosted yml with:
```bash
python -m pinginstaller https://github.com/CameronBodine/PINGMapper/blob/main/conda/PINGMapper.yml
```
That's it! Your environment is now ready to use.
If you want to update the environment, simply re-run the environment installation script with:
```bash
python -m pinginstaller https://github.com/CameronBodine/PINGMapper/blob/main/conda/PINGMapper.yml
```
Ta-ta for now!
Raw data
{
"_id": null,
"home_page": null,
"name": "pinginstaller",
"maintainer": null,
"docs_url": null,
"requires_python": ">3",
"maintainer_email": null,
"keywords": "pingmapper, sonar, ecology, remotesensing, sidescan, sidescan-sonar, aquatic, humminbird, lowrance, gis, oceanography, limnology",
"author": "Cameron Bodine",
"author_email": "bodine.cs@gmail.email",
"download_url": "https://files.pythonhosted.org/packages/1d/01/b301184c8bd2f932dc26e3105888d985f1cbd7512a46811543fa6cb151c1/pinginstaller-1.0.13.tar.gz",
"platform": null,
"description": "# PINGInstaller\r\n\r\n[![PyPI - Version](https://img.shields.io/pypi/v/pinginstaller?style=flat-square&label=Latest%20Version%20(PyPi))](https://pypi.org/project/pinginstaller/)\r\n\r\nLight-weight application for installing [PINGMapper](https://github.com/CameronBodine/PINGMapper) and associated packages. `PINGInstaller` is designed to install a `conda` environment from a yml specified as a URL or localy hosted yml.\r\n\r\nExample yml file structure:\r\n\r\n```bash\r\nname: ping\r\nchannels:\r\n - conda-forge\r\n - defaults\r\ndependencies:\r\n - python < 3.13\r\n - gdal\r\n - numpy\r\n - git\r\n - pandas\r\n - geopandas\r\n - pyproj\r\n - scikit-image\r\n - joblib\r\n - matplotlib\r\n - rasterio\r\n - h5py\r\n - pip\r\n - pip:\r\n - pingverter\r\n - pingmapper\r\n - pingwizard\r\n - pinginstaller\r\n - doodleverse_utils\r\n - psutil\r\n - tensorflow\r\n - tf-keras\r\n - transformers\r\n - pysimplegui == 5.0.*\r\n```\r\n\r\nThe special thing about `PINGInstaller` is that it will install the `conda` environment based on the `conda` prompt it is launched from. This enables end-users with multiple `conda` installations to choose the flavor of `conda` as needed. \r\n\r\nSupported prompts include (but may not be limited to):\r\n\r\n- [Miniforge](https://conda-forge.org/download/)\r\n- [Miniconda](https://docs.anaconda.com/miniconda/install/)\r\n- [Anaconda](https://www.anaconda.com/download)\r\n- [ArcGIS Python Command Prompt](https://pro.arcgis.com/en/pro-app/3.3/arcpy/get-started/installing-python-for-arcgis-pro.htm)\r\n\r\n`PINGInstaller` is also compatible with projects in the [Doodlevers](https://github.com/settings/organizations).\r\n\r\n## Installation & Usage\r\n\r\n### Step 1\r\n\r\nOpen (download, if not already available) the `conda` prompt you want to use (ex: On Windows 11 - Start --> All --> Anaconda (miniconda3) --> Anaconda Powershell Prompt).\r\n\r\n### Step 2\r\n\r\nInstall `PINGInstaller` in the `base` environment with:\r\n\r\n```bash\r\npip install pinginstaller\r\n```\r\n\r\n### Step 3\r\n\r\nThen install the environment from a web or locally hosted yml with:\r\n\r\n```bash\r\npython -m pinginstaller https://github.com/CameronBodine/PINGMapper/blob/main/conda/PINGMapper.yml\r\n```\r\n\r\nThat's it! Your environment is now ready to use.\r\n\r\nIf you want to update the environment, simply re-run the environment installation script with:\r\n\r\n```bash\r\npython -m pinginstaller https://github.com/CameronBodine/PINGMapper/blob/main/conda/PINGMapper.yml\r\n```\r\n\r\nTa-ta for now!\r\n\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Light-weight interface for running PING ecosystem (PINGMapper, etc.)",
"version": "1.0.13",
"project_urls": {
"GitHub": "https://github.com/CameronBodine/PINGInstaller",
"Homepage": "https://cameronbodine.github.io/PINGMapper/",
"Issues": "https://github.com/CameronBodine/PINGInstaller/issues"
},
"split_keywords": [
"pingmapper",
" sonar",
" ecology",
" remotesensing",
" sidescan",
" sidescan-sonar",
" aquatic",
" humminbird",
" lowrance",
" gis",
" oceanography",
" limnology"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3c69712d397a977f2498d23cbf33784af2795bfc133b2f775198955df0cad3d5",
"md5": "a6e2d58b8477104c2094ce4b2915668a",
"sha256": "9bef4b01e466fa0d06bc7327d3b0b402a37ab295a1a90df87bbd2035c6006362"
},
"downloads": -1,
"filename": "pinginstaller-1.0.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a6e2d58b8477104c2094ce4b2915668a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">3",
"size": 7012,
"upload_time": "2025-01-23T13:36:44",
"upload_time_iso_8601": "2025-01-23T13:36:44.831997Z",
"url": "https://files.pythonhosted.org/packages/3c/69/712d397a977f2498d23cbf33784af2795bfc133b2f775198955df0cad3d5/pinginstaller-1.0.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1d01b301184c8bd2f932dc26e3105888d985f1cbd7512a46811543fa6cb151c1",
"md5": "bb67c94b118d1945601cc786e3e7d1db",
"sha256": "7dbb0dc109abb9cc972f3ad2492270e407287f24a2055ad95cbdf4a5f83a7196"
},
"downloads": -1,
"filename": "pinginstaller-1.0.13.tar.gz",
"has_sig": false,
"md5_digest": "bb67c94b118d1945601cc786e3e7d1db",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">3",
"size": 5921,
"upload_time": "2025-01-23T13:36:46",
"upload_time_iso_8601": "2025-01-23T13:36:46.953811Z",
"url": "https://files.pythonhosted.org/packages/1d/01/b301184c8bd2f932dc26e3105888d985f1cbd7512a46811543fa6cb151c1/pinginstaller-1.0.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-23 13:36:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "CameronBodine",
"github_project": "PINGInstaller",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pinginstaller"
}