Add README.md to accommodate Gogs
README.md is an excerpt of doc/owlps.t2t, and integrates the information from the former README.t2t, which was deleted.
This commit is contained in:
parent
bc6ec14fa8
commit
f67d7892a8
|
@ -0,0 +1,54 @@
|
|||
# Owl Positioning System
|
||||
|
||||
**OwlPS** (_Owl Positioning System_) is a positioning (localization) system
|
||||
based on the IEEE 802.11 radio network (Wi-Fi), targeting mainly indoor
|
||||
environments. It uses an infrastructure-centred architecture, which means the
|
||||
infrastructure does the measurements and computes the mobile terminals'
|
||||
positions, rather than the terminals computing their own positions (as it is
|
||||
the case for instance with the GPS).
|
||||
|
||||
OwlPS implements various positioning techniques and algorithms based on the
|
||||
radio signal strength. It features a self-calibration (or autocalibration)
|
||||
mechanism that avoids the time-consuming manual fingerprinting phase and allows
|
||||
considering dynamic changes of the environment (human, climatic, etc.) when
|
||||
computing the location of mobile terminals.
|
||||
|
||||
**This presentation is an excerpt of `doc/owlps.t2t`. Please refer to this file
|
||||
for a more in-depth introduction to OwlPS.**
|
||||
|
||||
## News
|
||||
|
||||
OwlPS is not currently actively maintained, as I'm not working on indoor
|
||||
positioning at the moment, but I'll happily consider any contribution (or
|
||||
job offer).
|
||||
|
||||
The `CHANGELOG` file lists the changes that occurred in OwlPS, version by
|
||||
version, since its early stages.
|
||||
|
||||
## Contribute
|
||||
|
||||
If you would like to contribute to OwlPS, you can:
|
||||
|
||||
* use it, test it, and report suggestions and bugs on the forge:
|
||||
<https://code.lm7.fr/mcy/owlps/issues/>
|
||||
|
||||
* get the latest development code, add functionalities and send me pull
|
||||
requests by email or on the forge: <https://code.lm7.fr/mcy/owlps/pulls>
|
||||
|
||||
If you're looking for ideas, the `TODO.t2t` file could be a good start.
|
||||
|
||||
## Installation
|
||||
|
||||
For a guide to installing OwlPS, please consult `INSTALL.t2t`.
|
||||
|
||||
## License
|
||||
|
||||
OwlPS is free software, released under the terms of the CeCILL license (GNU
|
||||
GPL-compatible). For more detail, please consult `COPYRIGHT.t2t`.
|
||||
|
||||
## Note on the t2t file extension
|
||||
|
||||
Most of the documentation in this repository is provided as text files in the
|
||||
**txt2tags** format (`*.t2t` files). You can convert them to various formats
|
||||
(HTML, man pages, etc.) using the [txt2tags](http://txt2tags.org/) utility; if
|
||||
you mind the markup tags, you can even strip them using the `txt` output.
|
25
README.t2t
25
README.t2t
|
@ -1,25 +0,0 @@
|
|||
This is the OwlPS (Owl Positioning System) software distribution.
|
||||
|
||||
|
||||
For an introduction to OwlPS, please consult ``doc/owlps.t2t``, which is
|
||||
the documentation's entry point.
|
||||
|
||||
For copyright and license informations, please consult
|
||||
``COPYRIGHT.t2t``.
|
||||
|
||||
For a guide to installing OwlPS, please consult ``INSTALL.t2t``.
|
||||
|
||||
The file ``CHANGELOG`` lists the changes occured in OwlPS, version by
|
||||
version, since its early stages.
|
||||
|
||||
Finally, the file ``TODO.t2t`` is a list of potential work to do on the
|
||||
system. If you are willing to contribute and are looking for ideas, that
|
||||
can be a good start.
|
||||
|
||||
|
||||
: Note on the t2t file extension
|
||||
The documentation is provided as text files in the txt2tags format
|
||||
(file extension ``*.t2t``). You can convert them to various formats
|
||||
(HTML, man pages, etc.) using the ``txt2tags`` utility; if you mind
|
||||
the markup tags, you can even strip them using the ``txt`` output.
|
||||
``txt2tags`` is distributed at http://txt2tags.org/
|
Loading…
Reference in New Issue