| Name | une-ai JSON |
| Version |
1.1.5
JSON |
| download |
| home_page | |
| Summary | Modules used to facilitate the tutorial sessions for UNE unit COSC350/550 |
| upload_time | 2023-07-24 17:51:21 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.7 |
| license | MIT License Copyright (c) 2023, University of New England (UNE) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
une
ai
teaching
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# une_ai: a library of models and exercises for COSC350/550 unit (Artificial Intelligence)
## What is it?
**une_ai** is a Python package that provides models and classes that can be used to practice Artificial Intelligence algorithms. The package is structured so to offer the tools required during the weekly practical workshops and it also includes classes that can be used as base for the implementation of the practical assignments.
## How to install it
UNE students have access to the Turing server machine via ssh command or X2go. This machine runs a Linux based environment and already provides Python3 and pip. It also supports Python virtual environments with venv and conda.
To minimise technical issues and assistance, it is recommended to use the Turing server to implement your code for the workshops and assignments. However, if you feel confident to install Python3 on your machine, you can use the same instructions provided below. Note: these instructions are for Linux or MacOS machines (Windows machines may require different instructions and it is recommended to use Turing instead).
Although not required, it is best to create a Python virtual environment that you will use for your implementations during the unit. You have at least two options: using conda or using venv. In this README file we only provide instructions to install the package using conda (recommended option).
### conda environment and package installation with pip
For this option you need to have conda installed on the machine you are using to install this package. If you are using Turing, conda is already installed and supported (no stress :D).
First, we need to create the virtual environment. We will call it *cosc350* and once created it will be there until we decide to delete it. In other words, you need to create it once. Remember to answer y and press Enter when conda asks you to provide a y/n answer.
```sh
conda create -n cosc350
```
Now that we created the conda virtual environment, we need to activate it. Remember: you must execute this command everytime you open a new terminal window that you will use to run Python code using this package.
```sh
conda activate cosc350
```
If everything is good, you should see *(cosc350)* on the left side in the terminal window. That means that now we are using the virtual environment we just created.
To install this package using pip, we need to first install pip in this virtual environment. To do this, type the following command (and answer y when required).
```sh
conda install pip
```
Now that pip was installed on the conda virtual environment, we can install the une_ai package. Once installing, the package will automatically install all the necessary dependencies (again, no stress :D).
```sh
pip install une_ai
```
Again, remember to answer y if conda asks you to install necessary dependencies.
Now, to test that everything is good, let's access the Python console and import a class from the une_ai package. To access the Python3 console type:
```sh
python3
```
Now that you are in the Python3 console, type the following Python commands:
```python
from une_ai.models import GridMap
my_map = GridMap(5, 5)
print(my_map.get_map())
```
If everything is correct, you should not see errors and you should see a 5 by 5 boolean 2D numpy array. Hurray! :D
To exit the Python3 console type the following instruction and press Enter:
```Python
exit()
```
If you want to deactivate the conda environment (i.e. you do not need it anymore for now and you want to exit the virtual environment), type the following command on the terminal:
```sh
conda deactivate
```
You can achieve the same objective by simply closing the terminal window.
## Dependencies
- [NumPy - Adds support for large, multi-dimensional arrays, matrices and high-level mathematical functions to operate on these arrays](https://www.numpy.org)
- [pygame - Provides a cross-platform library for the development of multimedia applications like video games using Python](https://www.pygame.org/news)
## License
[MIT](LICENSE)
## Documentation
For the documentation on how to use the offered classes, visit the weekly workshops. During each workshop there will be instructions introducing the classes used for the proposed exercises.
## Getting Help
For usage questions, the best place to go to is the forum of the unit on Moodle.
Further, more assistance can be provided by contacting your unit coordinator (via email).
Raw data
{
"_id": null,
"home_page": "",
"name": "une-ai",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "UNE,AI,teaching",
"author": "",
"author_email": "Jonathan Vitale <jvitale@une.edu.au>",
"download_url": "https://files.pythonhosted.org/packages/e0/fb/371685fd91c123344f9b123d2751f23ebfeac9f29fd29b9d62ac1839f4a1/une_ai-1.1.5.tar.gz",
"platform": null,
"description": "# une_ai: a library of models and exercises for COSC350/550 unit (Artificial Intelligence)\n\n## What is it?\n\n**une_ai** is a Python package that provides models and classes that can be used to practice Artificial Intelligence algorithms. The package is structured so to offer the tools required during the weekly practical workshops and it also includes classes that can be used as base for the implementation of the practical assignments.\n\n## How to install it\n\nUNE students have access to the Turing server machine via ssh command or X2go. This machine runs a Linux based environment and already provides Python3 and pip. It also supports Python virtual environments with venv and conda.\n\nTo minimise technical issues and assistance, it is recommended to use the Turing server to implement your code for the workshops and assignments. However, if you feel confident to install Python3 on your machine, you can use the same instructions provided below. Note: these instructions are for Linux or MacOS machines (Windows machines may require different instructions and it is recommended to use Turing instead).\n\nAlthough not required, it is best to create a Python virtual environment that you will use for your implementations during the unit. You have at least two options: using conda or using venv. In this README file we only provide instructions to install the package using conda (recommended option).\n\n### conda environment and package installation with pip\n\nFor this option you need to have conda installed on the machine you are using to install this package. If you are using Turing, conda is already installed and supported (no stress :D).\n\nFirst, we need to create the virtual environment. We will call it *cosc350* and once created it will be there until we decide to delete it. In other words, you need to create it once. Remember to answer y and press Enter when conda asks you to provide a y/n answer.\n\n```sh\nconda create -n cosc350\n```\n\nNow that we created the conda virtual environment, we need to activate it. Remember: you must execute this command everytime you open a new terminal window that you will use to run Python code using this package.\n\n```sh\nconda activate cosc350\n```\n\nIf everything is good, you should see *(cosc350)* on the left side in the terminal window. That means that now we are using the virtual environment we just created.\n\nTo install this package using pip, we need to first install pip in this virtual environment. To do this, type the following command (and answer y when required).\n\n```sh\nconda install pip\n```\n\nNow that pip was installed on the conda virtual environment, we can install the une_ai package. Once installing, the package will automatically install all the necessary dependencies (again, no stress :D).\n\n```sh\npip install une_ai\n```\n\nAgain, remember to answer y if conda asks you to install necessary dependencies.\n\nNow, to test that everything is good, let's access the Python console and import a class from the une_ai package. To access the Python3 console type:\n\n```sh\npython3\n```\n\nNow that you are in the Python3 console, type the following Python commands:\n\n```python\nfrom une_ai.models import GridMap\n\nmy_map = GridMap(5, 5)\n\nprint(my_map.get_map())\n```\n\nIf everything is correct, you should not see errors and you should see a 5 by 5 boolean 2D numpy array. Hurray! :D\n\nTo exit the Python3 console type the following instruction and press Enter:\n\n```Python\nexit()\n```\n\nIf you want to deactivate the conda environment (i.e. you do not need it anymore for now and you want to exit the virtual environment), type the following command on the terminal:\n\n```sh\nconda deactivate\n```\n\nYou can achieve the same objective by simply closing the terminal window.\n\n## Dependencies\n- [NumPy - Adds support for large, multi-dimensional arrays, matrices and high-level mathematical functions to operate on these arrays](https://www.numpy.org)\n- [pygame - Provides a cross-platform library for the development of multimedia applications like video games using Python](https://www.pygame.org/news)\n\n## License\n[MIT](LICENSE)\n\n## Documentation\n\nFor the documentation on how to use the offered classes, visit the weekly workshops. During each workshop there will be instructions introducing the classes used for the proposed exercises.\n\n## Getting Help\n\nFor usage questions, the best place to go to is the forum of the unit on Moodle.\nFurther, more assistance can be provided by contacting your unit coordinator (via email).\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2023, University of New England (UNE) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "Modules used to facilitate the tutorial sessions for UNE unit COSC350/550",
"version": "1.1.5",
"project_urls": null,
"split_keywords": [
"une",
"ai",
"teaching"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "60c9ac60b3ca4465daa695607153db0444ed70f2413eb2fddc08ee2d1e22a221",
"md5": "cea8fcb4b6c616ec14d050d7ba9c028a",
"sha256": "cf616044fa95d43ff5ca63e9b2ab35cc9618bdb79596b975467d349db80a3e63"
},
"downloads": -1,
"filename": "une_ai-1.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cea8fcb4b6c616ec14d050d7ba9c028a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 31490,
"upload_time": "2023-07-24T17:51:19",
"upload_time_iso_8601": "2023-07-24T17:51:19.014947Z",
"url": "https://files.pythonhosted.org/packages/60/c9/ac60b3ca4465daa695607153db0444ed70f2413eb2fddc08ee2d1e22a221/une_ai-1.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e0fb371685fd91c123344f9b123d2751f23ebfeac9f29fd29b9d62ac1839f4a1",
"md5": "9270e6d8d1f0e5e4405efc0baf3fb4fb",
"sha256": "350a0c79b6c3435ce902ae24d43a61aa367c82e2eb07a7fd3cb358fb50d38435"
},
"downloads": -1,
"filename": "une_ai-1.1.5.tar.gz",
"has_sig": false,
"md5_digest": "9270e6d8d1f0e5e4405efc0baf3fb4fb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 24138,
"upload_time": "2023-07-24T17:51:21",
"upload_time_iso_8601": "2023-07-24T17:51:21.246019Z",
"url": "https://files.pythonhosted.org/packages/e0/fb/371685fd91c123344f9b123d2751f23ebfeac9f29fd29b9d62ac1839f4a1/une_ai-1.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-24 17:51:21",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "une-ai"
}
