Skip to content

Commit

Permalink
docs to res, tutorial.md
Browse files Browse the repository at this point in the history
  • Loading branch information
jeog committed Dec 4, 2015
1 parent 18bb3cc commit 5266aa0
Show file tree
Hide file tree
Showing 22 changed files with 20 additions and 281 deletions.
File renamed without changes.
File renamed without changes.
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,9 +84,9 @@ Obviously the core implementation is not portable, but the python interface does
The detached signature for each binary; sha256 checksums for binaries, signatures, and the jeog.dev public key
- */docs*
- */res*
Documentation, Tutorials, Licenses etc.
Miscellaneous resources
### Modules
Expand Down Expand Up @@ -180,7 +180,7 @@ The following sections will outline how to setup TOSDB's core C/C++ libraries. A
12. Make sure the TOS Platform is running, execute your program or start the python wrapper(see below).
![](./docs/SCss1.png)
![](./res/SCss1.png)
### Python Wrapper
- - -
Expand All @@ -199,7 +199,7 @@ Remeber, if installing on a non-windows system to utilize the virtual interface
> **IMPLEMENTATION NOTE:** We recently shifted from providing (low-level) constants via a C++ extension to having the setup.py script automatically pull constants and topic enum values from tos_databridge.h to generate _tosdb.py, all in pure python. This avoids a number of portability and build issues.
tosdb/ is structured as a package with the bulk of its code in \__init__.py and \_win.py , the latter holding the non-portable parts that \__init__.py will import if it determines it's being run on a windows sytem. This structure allows you to simply import the package(*import tosdb*) or, if needed, extensions like intervalize.py(*from tosdb import intervalize*). Once imported you'll have to initialize it, which requires the path or general location of the underlying library it's going to load (the tos-databridge[].dll) or the root directory it's going to search in for the latest version. Please see the (currently somewhat outdated) tutorial in /docs for a walk-through with screen-shots.
tosdb/ is structured as a package with the bulk of its code in \__init__.py and \_win.py , the latter holding the non-portable parts that \__init__.py will import if it determines it's being run on a windows sytem. This structure allows you to simply import the package(*import tosdb*) or, if needed, extensions like intervalize.py(*from tosdb import intervalize*). Once imported you'll have to initialize it, which requires the path or general location of the underlying library it's going to load (the tos-databridge[].dll) or the root directory it's going to search in for the latest version. Please see tosdb/TUTORIAL.md for a walk-through with screen-shots.
> **IMPORTANT:** There is a minor issue with how python uses the underlying library to deallocate shared resources used by it and the Service. Generally calls like **`TOSDB_CloseBlock()`** and **`TOSDB_RemoveTopic()`** handle this on a case by case basis or the DLL's DllMain method attempts to close the necessary resources and signal the Service with the corresponding requests when the library is freed.
Expand Down
Binary file removed docs/PyTut1.png
Binary file not shown.
Binary file removed docs/PyTut2.png
Binary file not shown.
Binary file removed docs/PyTut3.png
Binary file not shown.
Binary file removed docs/PyTut4.png
Binary file not shown.
Binary file removed docs/PyTut5.png
Binary file not shown.
Binary file removed docs/PyTut6.png
Binary file not shown.
Binary file removed docs/PyTut7.png
Binary file not shown.
Binary file removed docs/PyTut8.png
Binary file not shown.
Binary file removed docs/PyTut9.png
Binary file not shown.
277 changes: 0 additions & 277 deletions docs/PythonTutorial.html

This file was deleted.

16 changes: 16 additions & 0 deletions python/TUTORIAL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
### tosdb tutorial
---

![](./../res/tosdb_tutorial_1.png)

![](./../res/tosdb_tutorial_2.png)

![](./../res/tosdb_tutorial_3.png)

![](./../res/tosdb_tutorial_4.png)

![](./../res/tosdb_tutorial_5.png)

![](./../res/tosdb_tutorial_6.png)

![](./../res/tosdb_tutorial_7.png)
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes

0 comments on commit 5266aa0

Please sign in to comment.