Skip to content

Commit 07bb49d

Browse files
rahul799rahul799
committed
ipynb notebooks generated
1 parent 16607af commit 07bb49d

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

50 files changed

+13213
-0
lines changed

‎docs/source/apidocs/index.ipynb

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
{
2+
"cells": [
3+
{
4+
"cell_type": "markdown",
5+
"metadata": {},
6+
"source": [
7+
"# API docs\n",
8+
"\n",
9+
"This is an overview over all classes available in pyopenms\n",
10+
"\n",
11+
"pyopenms\n",
12+
"\n",
13+
"pyopenms.Constants pyopenms.plotting"
14+
],
15+
"id": "dba185af-ba10-40e0-a268-48430acfcc86"
16+
}
17+
],
18+
"nbformat": 4,
19+
"nbformat_minor": 5,
20+
"metadata": {}
21+
}

‎docs/source/community/adding_pure_python.ipynb

+31
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
{
2+
"cells": [
3+
{
4+
"cell_type": "markdown",
5+
"metadata": {},
6+
"source": [
7+
"# Adding pure python classes/functionality\n",
8+
"\n",
9+
"Pure python modules can be found <span class=\"title-ref\">here\n",
10+
"\\<https://github.com/OpenMS/OpenMS/tree/develop/src/pyOpenMS/pyopenms\\></span>.\n",
11+
"Just add a new <span class=\"title-ref\">.py</span> file and a new\n",
12+
"submodule will appear that can be imported with\n",
13+
"<span class=\"title-ref\">import pyopenms.submodule</span>.\n",
14+
"\n",
15+
"Remember to add additional requirements in the setup.py but try to avoid\n",
16+
"large dependencies unless absolutely necessary.\n",
17+
"\n",
18+
"Testing is done via pytest. Every new module, class, function, member\n",
19+
"should be documented with Sphinx reStructuredText docstrings. See the\n",
20+
"<span class=\"title-ref\">Sphinx-RTD-Tutorial\n",
21+
"\\<https://sphinx-rtd-tutorial.readthedocs.io/en/latest/docstrings.html\\></span>\n",
22+
"and the <span class=\"title-ref\">Python Developers Guide\n",
23+
"\\<https://devguide.python.org/documentation/start-documenting/index.html\\></span>."
24+
],
25+
"id": "93f47dfd-8bf4-4f90-8ea7-5b5d2ed6f8c9"
26+
}
27+
],
28+
"nbformat": 4,
29+
"nbformat_minor": 5,
30+
"metadata": {}
31+
}

‎docs/source/community/build_from_source.ipynb

+81
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
{
2+
"cells": [
3+
{
4+
"cell_type": "markdown",
5+
"metadata": {},
6+
"source": [
7+
"# Build from Source\n",
8+
"\n",
9+
"To install pyOpenMS from `source`, you will first have to compile OpenMS\n",
10+
"successfully on your platform of choice (note that for MS Windows you\n",
11+
"will need to match your compiler and Python version). Please follow the\n",
12+
"[official\n",
13+
"documentation](https://abibuilder.cs.uni-tuebingen.de/archive/openms/Documentation/release/latest/html/index.html)\n",
14+
"in order to compile OpenMS for your platform. Next you will need to\n",
15+
"install the following software packages\n",
16+
"\n",
17+
"On Microsoft Windows: you need the 64 bit C++ compiler from Visual\n",
18+
"Studio 2015 to compile the newest pyOpenMS for Python 3.5, 3.6 or 3.7.\n",
19+
"This is important, else you get a clib that is different than the one\n",
20+
"used for building the Python executable, and pyOpenMS will crash on\n",
21+
"import. The OpenMS wiki has [detailed\n",
22+
"information](https://github.com/OpenMS/OpenMS/wiki/Build-pyOpenMS-on-Windows)\n",
23+
"on building pyOpenMS on Windows.\n",
24+
"\n",
25+
"You can install all necessary Python packages on which pyOpenMS depends\n",
26+
"through\n",
27+
"\n",
28+
"``` bash\n",
29+
"pip install -U setuptools\n",
30+
"pip install -U pip\n",
31+
"pip install -U autowrap\n",
32+
"pip install -U pytest\n",
33+
"pip install -U numpy\n",
34+
"pip install -U wheel\n",
35+
"```\n",
36+
"\n",
37+
"Depending on your systems setup, it may make sense to do this inside a\n",
38+
"virtual environment\n",
39+
"\n",
40+
"``` bash\n",
41+
"virtualenv pyopenms_venv\n",
42+
"source pyopenms_venv/bin/activate\n",
43+
"```\n",
44+
"\n",
45+
"Next, configure OpenMS with pyOpenMS: execute `cmake` as usual, but with\n",
46+
"parameters `DPYOPENMS=ON`. Also, if using virtualenv or using a specific\n",
47+
"Python version, add `-DPYTHON_EXECUTABLE:FILEPATH=/path/to/python` to\n",
48+
"ensure that the correct Python executable is used. Compiling pyOpenMS\n",
49+
"can use a lot of memory and take some time, however you can reduce the\n",
50+
"memory consumption by breaking up the compilation into multiple units\n",
51+
"and compiling in parallel, for example\n",
52+
"`-DPY_NUM_THREADS=2 -DPY_NUM_MODULES=4` will build 4 modules with 2\n",
53+
"threads. You can then configure pyOpenMS:\n",
54+
"\n",
55+
"``` bash\n",
56+
"cmake -DPYOPENMS=ON\n",
57+
"make pyopenms\n",
58+
"```\n",
59+
"\n",
60+
"Build pyOpenMS (now there should be pyOpenMS specific build targets).\n",
61+
"Afterwards, test that all went well by running the tests:\n",
62+
"\n",
63+
"``` bash\n",
64+
"ctest -R pyopenms\n",
65+
"```\n",
66+
"\n",
67+
"Which should execute all the tests and return with all tests passing.\n",
68+
"\n",
69+
"## Further Questions\n",
70+
"\n",
71+
"In case the above instructions did not work, please refer to the [Wiki\n",
72+
"Page](https://github.com/OpenMS/OpenMS/wiki/pyOpenMS), contact the\n",
73+
"development team on github or send an email to the OpenMS mailing list."
74+
],
75+
"id": "378c8fe3-aa9a-4e23-b61f-89efdd9372a0"
76+
}
77+
],
78+
"nbformat": 4,
79+
"nbformat_minor": 5,
80+
"metadata": {}
81+
}

‎docs/source/community/index.ipynb

+40
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
{
2+
"cells": [
3+
{
4+
"cell_type": "markdown",
5+
"metadata": {},
6+
"source": [
7+
"# Contribute\n",
8+
"\n",
9+
"## pyopenms docs\n",
10+
"\n",
11+
"Contribution to the pyOpenMS documentation is easy and we would love to\n",
12+
"expand it with you. To edit a tutorial page you can click on the \"Edit\n",
13+
"on GitHub\" link at the top right of each page. Once you changed (or\n",
14+
"added new) .rst files you can and open a pull request.\n",
15+
"\n",
16+
"(Note that edits you perform on binder don't get stored in this\n",
17+
"repository. Thus, binder and the displayed jupyter notebooks can not be\n",
18+
"used to edit the existing documentation. All edits need to happen\n",
19+
"through the .rst files in the OpenMS/pyopenms-docs repository.)\n",
20+
"\n",
21+
"If you are unsure how to do that or want to discuss questions (e.g. your\n",
22+
"example workflow can be included on this webpage) contact us via the\n",
23+
"[OpenMS Gitter chat channel](https://gitter.im/OpenMS/OpenMS/).\n",
24+
"\n",
25+
"## pyopenms sources\n",
26+
"\n",
27+
"pyopenms mostly consists of Cython wrappers around the OpenMS C++\n",
28+
"library. Below you will find information on how to build pyopenms from\n",
29+
"source and how to wrap new classes. You can of course also contribute\n",
30+
"classesa and functionality in pure python.\n",
31+
"\n",
32+
"build_from_source wrapping_workflows_new_classes adding_pure_python"
33+
],
34+
"id": "3da92b5b-9d71-42d9-b9d1-2c1e4c7e69d4"
35+
}
36+
],
37+
"nbformat": 4,
38+
"nbformat_minor": 5,
39+
"metadata": {}
40+
}

0 commit comments

Comments
 (0)