lost_ds 1.2.0a4__tar.gz

lost_ds-1.2.0a4/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

lost_ds-1.2.0a4/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

lost_ds-1.2.0a4/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,28 @@
+# My Title
+<!--- Provide a general summary of your changes in the Title above -->
+
+## Checklist
+<!--- Put an `x` in all the boxes that apply: -->
+- [ ] CHANGELOG was updated
+  - Please add your changes in the **unreleased section** 
+  - Add a note if your changes apply to an **older version** of this software 
+- [ ] The destination branch has been merged into my branch before I created this merge request
+- [ ] All interfaces to the outside world have been documented
+  - For Python use [google doc style](https://google.github.io/styleguide/pyguide.html) -> [examples here](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html) 
+
+## Types of changes
+<!--- What types of changes does your code introduce? Put an `x` in all the boxes that apply: -->
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+
+## How Has This Been Tested?
+<!--- Please describe in detail how you tested your changes. -->
+<!--- Include details of your testing environment, and the tests you ran to -->
+<!--- see how your change affects other areas of the code, etc. -->
+- [ ] Changes have been tested in the destination environment
+- [ ] Unit tests have been written
+- [ ] I did not test anything BECAUSE: 
+- [ ] Nothing from above, I tested this way:
+
+## Screenshots (if appropriate):

lost_ds-1.2.0a4/.gitignore

@@ -0,0 +1,4 @@
+**__pycache__
+**dask-worker-space
+**launch.json
+.vscode

lost_ds-1.2.0a4/.gitlab-ci.yml

@@ -0,0 +1,27 @@
+image: python:3.8
+
+stages:
+- test-lost_ds
+- release-lost_ds
+
+test-lost_ds:
+  stage: test-lost_ds
+  script:
+    - echo "hello from teststage"
+  rules:
+    - if: '$CI_COMMIT_BRANCH =~ /master/'
+    - if: '$CI_COMMIT_TAG =~ /.*/'
+
+release-lost_ds:
+  variables:
+    UV_PUBLISH_TOKEN: $TWINE_PASSWORD
+  stage: release-lost_ds
+  script:
+    - sed -i 's/version = "0.0.0-alpha.0"/version = "'"$CI_COMMIT_TAG"'"/' pyproject.toml
+    - echo "__version__='${CI_COMMIT_TAG}'" >> lost_ds/__init__.py
+    - pip install uv
+    - uvx --from=toml-cli toml set --toml-path pyproject.toml project.version ${CI_COMMIT_TAG}
+    - uv build
+    - uv publish
+  only:
+    - tags

lost_ds-1.2.0a4/CHANGELOG.md

@@ -0,0 +1,105 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [unreleased]
+### Changed
+- switched package build system to uv
+- fix bug in unique labels
+- add crop shape and overlap shape to filename when cropping ds
+
+## [1.1.2] - 2024-01-30
+### Changed
+- Moved package building to pyproject.toml
+### Fixed
+- Fixed Pipy build
+
+## [1.1.1] - 2024-01-22
+### Fixed
+- Try to fix pypy build
+
+## [1.1.0] - 2024-01-22
+### Changed
+- `split_train_test` now filters samples with too few unique sources to prevent errors in sklearn
+- refactored to_abs and to_rel method for easier readability and better performance
+### Added
+- retry reading a parquet file without opening as buffer if it fails
+- semantic_segmentation can store files with numeric names
+- new function: `split_train_test_multilabel` for fairly splitting multilabel datasets
+- added requirements
+### Fixed
+- vis_and_store can handle multilabel, singlelabel and None correctly now
+- polygon validation fixed. Set required amount of points from 4 to 3.
+- fixed in `validate_unique_annos` pandas drop() future warning
+- `crop_dataset` does not produce empty duplicates of crop positions anymore
+- `segmentation_to_lost` fix bug where some contours of different classes were merged accidentially
+- `mask_dataset` won't overwrite input dataframe anymore
+- added a serialization case where a columns has empty lists
+
+## [1.0.0] - 2023-01-10
+### Added
+- fixed voc_eval bug where gt_df bboxes weren't handled correctly
+- fixed coco_eval bug - different dataframes having same uids for images and labels now
+- to_coco meethod has arguments predef_img_mapping and predef_lbl_mapping now to hand over predefined label and image uids
+- export method crop_img to lost_ds (lost_ds.crop_img and ds.crop_img formerly lost_ds.DSCropper.crop_img)
+- resolve FutureWarning at transform_bbox_style
+- make crop_dataset compatible with pandas > 1.5.0 
+- crop_component indexing is imagewise instead of global
+- improve some filter and transform functions
+### Breaking changes
+- Add parallel option for multiple functions
+- fix typo in some methods arguments
+
+## [0.5.0] - 2022-12-02
+### Added
+- method `split_train_test` which allows the stratify option for i.e. classification datasets
+- `coco_eval` method for detection (mAP, Average Recall)
+- `voc_eval` method for detection (tp, fp, fn, precision, revall, ap)
+- `to_coco` improvements and bugfixes
+- `voc_score_iou_multiplex` method: shifting bbox score and iou_thresholds to find optimal thresolds
+- cropping method return additional column 'crop_position' now
+- added arg 'random_state' for dataset-splitting
+- added arg for optional parallelistaion
+- added color selection for vis and store - can take column now
+- improved detetion metrics
+
+## [0.4.0] - 2022-05-01 
+### Changed
+- file_man: Allow other Fsspec filesystems
+### Added
+- Progress callback for pack_ds
+- Argument `fontscale` at `vis_and_store` to enable manually control for textsize
+- Argument `cast_others` at `segmentation_to_lost` to allow ignoring unspecified pixel values
+
+## [0.3.0] - 2022-04-05 
+### Added 
+- Added zip support for pack_ds method
+
+## [0.2.0] - 2022-04-04 
+### Added 
+- `bbox_nms` method to directly apply non-max-suppresseion for bboxes
+- Argument `path_col` in methods `to_abs` and `to_rel` to enable explicit column specification to look for image paths
+- Argument `mode` for method `remap_img_path` to enable not only replacement but also prepending of root paths
+- Set argument default of `inplace` of method `pack_ds` to False
+- Enable visualization of annos without `anno_lbl` specified
+
+## [0.1.0] - 2022-02-09
+### Changes
+- `validate_unique_annos` uses data-hash for dropping duplicates now
+- `vis_and_store` text-boxes won't be outside the image anymore
+- `vis_and_store` can determine optimal text-size for labeling when passing 
+    arg. line_thickness 'auto'.
+### Added
+- dependencies for lost_ds in requirements.txt + setup.py
+- examples dataset and code-snippets
+- improved function to load datasets at LOSTDataset
+- new function `segmentation_to_lost` to convert pixelmaps to lost-annotations
+- new function `crop_components` to crop dataset based on annotations
+- new function `vis_semantic_segmentation` to color sem-seg. dataset
+- new function `to_coco` to generate and store coco datasets from LOSTDataset
+
+## [0.0.0] - 2021-10-26
+### Added
+- First version

lost_ds-1.2.0a4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 L3bm GmbH
+
+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.

lost_ds-1.2.0a4/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: lost_ds
+Version: 1.2.0a4
+Summary: Lost Dataset library
+Project-URL: Repository, https://github.com/l3p-cv/lost_ds
+Author-email: L3bm GmbH <info@l3bm.com>
+License: MIT
+License-File: LICENSE
+Keywords: python
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <4.0,>=3.9
+Requires-Dist: fsspec
+Requires-Dist: iterative-stratification
+Requires-Dist: joblib
+Requires-Dist: numpy
+Requires-Dist: opencv-python
+Requires-Dist: pandas
+Requires-Dist: pillow
+Requires-Dist: pyarrow
+Requires-Dist: python-dateutil
+Requires-Dist: pytz
+Requires-Dist: scikit-learn
+Requires-Dist: scipy
+Requires-Dist: shapely
+Requires-Dist: six
+Requires-Dist: threadpoolctl
+Requires-Dist: tqdm
+Requires-Dist: tzdata
+Requires-Dist: wtforms>=3.2.1
+Description-Content-Type: text/markdown
+
+[![pipeline status](https://gitlab.com/l3p-cv/lost_ds/badges/master/pipeline.svg)](https://gitlab.com/l3p-cv/lost_ds/pipelines)
+<!-- [![Documentation Status](https://readthedocs.org/projects/lost_ds/badge/?version=latest)](https://lost_ds.readthedocs.io/en/latest/?badge=latest) -->
+
+### LOSTDataset
+
+This is a library to handle datasets generated by LOST. LOSTDataset enables 
+directily producing semantic segmentations, anno-type transformations (i.e. polygon to bbox), 
+anno-style transformations (i.e. bbox xywh -> bbox x1x2y1y2), crop datasets, 
+visualize annotations, lost2coco and some more.
+
+Checkout some explanation and examples [here](https://github.com/l3p-cv/lost_ds/blob/master/examples/example.ipynb).
+

lost_ds-1.2.0a4/README.md

@@ -0,0 +1,12 @@
+[![pipeline status](https://gitlab.com/l3p-cv/lost_ds/badges/master/pipeline.svg)](https://gitlab.com/l3p-cv/lost_ds/pipelines)
+<!-- [![Documentation Status](https://readthedocs.org/projects/lost_ds/badge/?version=latest)](https://lost_ds.readthedocs.io/en/latest/?badge=latest) -->
+
+### LOSTDataset
+
+This is a library to handle datasets generated by LOST. LOSTDataset enables 
+directily producing semantic segmentations, anno-type transformations (i.e. polygon to bbox), 
+anno-style transformations (i.e. bbox xywh -> bbox x1x2y1y2), crop datasets, 
+visualize annotations, lost2coco and some more.
+
+Checkout some explanation and examples [here](https://github.com/l3p-cv/lost_ds/blob/master/examples/example.ipynb).
+

lost_ds-1.2.0a4/docs/sphinx/.gitignore

@@ -0,0 +1,2 @@
+old
+build/*

lost_ds-1.2.0a4/docs/sphinx/Makefile

@@ -0,0 +1,19 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

lost_ds-1.2.0a4/docs/sphinx/requirements.txt

@@ -0,0 +1,104 @@
+absl-py==0.11.0
+appdirs==1.4.3
+argon2-cffi==20.1.0
+astunparse==1.6.3
+async-generator==1.10
+attrs==20.3.0
+backcall==0.2.0
+bleach==3.2.1
+cachetools==4.1.1
+certifi==2020.11.8
+cffi==1.14.4
+chardet==3.0.4
+cycler==0.10.0
+decorator==4.4.0
+defusedxml==0.6.0
+entrypoints==0.3
+gast==0.3.3
+google-auth==1.23.0
+google-auth-oauthlib==0.4.2
+google-pasta==0.2.0
+grpcio==1.33.2
+h5py==2.10.0
+idna==2.10
+imageio==2.9.0
+imagesize==1.2.0
+importlib-metadata==3.1.0
+ipykernel==5.3.4
+ipython==7.16.1
+ipython-genutils==0.2.0
+jedi==0.17.2
+Jinja2==2.11.2
+joblib==0.17.0
+json5==0.9.5
+jsonschema==3.2.0
+Keras-Preprocessing==1.1.2
+kiwisolver==1.3.1
+Mako==1.1.0
+Markdown==3.3.3
+MarkupSafe==1.1.1
+matplotlib==3.3.3
+mistune==0.8.4
+nbclient==0.5.1
+nbconvert==6.0.7
+nbformat==5.0.8
+nest-asyncio==1.4.3
+networkx==2.5
+notebook==6.1.5
+oauthlib==3.1.0
+opencv-python==4.2.0.32
+opt-einsum==3.3.0
+packaging==20.4
+pandas==1.1.4
+pandocfilters==1.4.3
+parso==0.7.1
+pexpect==4.8.0
+pickleshare==0.7.5
+pika==1.1.0
+Pillow==6.2.0
+prometheus-client==0.9.0
+prompt-toolkit==3.0.8
+protobuf==3.14.0
+ptyprocess==0.6.0
+pudb==2019.2
+pyasn1==0.4.8
+pyasn1-modules==0.2.8
+pycparser==2.20
+Pygments==2.7.2
+pyparsing==2.4.7
+pyrsistent==0.17.3
+python-dateutil==2.8.1
+pytools==2019.1.1
+pytz==2020.4
+PyWavelets==1.1.1
+PyYAML==5.3.1
+pyzmq==20.0.0
+requests==2.25.0
+requests-oauthlib==1.3.0
+rsa==4.6
+scikit-image==0.17.2
+scikit-learn==0.23.2
+scipy==1.4.1
+seaborn==0.11.0
+Send2Trash==1.5.0
+Shapely==1.7.1
+six==1.12.0
+sklearn==0.0
+tensorboard==2.4.0
+tensorboard-plugin-wit==1.7.0
+tensorflow==2.3.0
+tensorflow-estimator==2.3.0
+termcolor==1.1.0
+terminado==0.9.1
+testpath==0.4.4
+threadpoolctl==2.1.0
+tifffile==2020.9.3
+tornado==6.1
+traitlets==4.3.3
+urllib3==1.26.2
+urwid==2.1.2
+wcwidth==0.2.5
+webencodings==0.5.1
+Werkzeug==1.0.1
+wrapt==1.12.1
+zipp==3.4.0

lost_ds-1.2.0a4/docs/sphinx/source/conf.py

@@ -0,0 +1,216 @@
+# -*- coding: utf-8 -*-
+#
+# Configuration file for the Sphinx documentation builder.
+#
+# This file does only contain a selection of the most common options. For a
+# full list see the documentation:
+# http://www.sphinx-doc.org/en/master/config
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+
+import os
+import sys
+#sys.path.insert(0, os.path.abspath('.'))
+sys.path.append(os.path.abspath('../../../../lost_ds/'))
+
+
+# -- Project information -----------------------------------------------------
+
+project = 'lost_ds'
+copyright = '2021, L3bm GmbH'
+author = 'L3bm GmbH'
+
+# The short X.Y version
+version = ''
+# The full version, including alpha/beta/rc tags
+release = '1.0.x'
+
+
+# -- General configuration ---------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#
+# needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.todo',
+    'sphinx.ext.viewcode',
+    #'sphinx.ext.githubpages',
+    'sphinx.ext.napoleon',
+]
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_init_with_doc = False
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = True
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
+# napoleon_show_inheritance = True
+
+autodoc_default_options = {
+    'undoc-members':False,
+    'members': True,
+    'private-members': False,
+    'inherited-members': True
+}
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = ['.rst', '.md']
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = []
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = None
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+# html_theme = 'bizstyle'
+# html_theme = 'haiku'
+# html_theme = 'alabaster'
+html_theme = 'sphinx_rtd_theme'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#
+# html_theme_options = {}
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# Custom sidebar templates, must be a dictionary that maps document names
+# to template names.
+#
+# The default sidebars (for documents that don't match any pattern) are
+# defined by theme itself.  Builtin themes are using these templates by
+# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
+# 'searchbox.html']``.
+#
+# html_sidebars = {}
+
+
+# -- Options for HTMLHelp output ---------------------------------------------
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'lost_dsdoc'
+
+
+# -- Options for LaTeX output ------------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #
+    # 'papersize': 'letterpaper',
+
+    # The font size ('10pt', '11pt' or '12pt').
+    #
+    # 'pointsize': '10pt',
+
+    # Additional stuff for the LaTeX preamble.
+    #
+    # 'preamble': '',
+
+    # Latex figure (float) alignment
+    #
+    # 'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (master_doc, 'lost_ds.tex', 'lost_ds Documentation',
+     'L3bm GmbH', 'manual'),
+]
+
+
+# -- Options for manual page output ------------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, 'lost_ds', 'lost_ds Documentation',
+     [author], 1)
+]
+
+
+# -- Options for Texinfo output ----------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (master_doc, 'lost_ds', 'lost_ds Documentation',
+     author, 'lost_ds', 'One line description of project.',
+     'Miscellaneous'),
+]
+
+
+# -- Options for Epub output -------------------------------------------------
+
+# Bibliographic Dublin Core info.
+epub_title = project
+
+# The unique identifier of the text. This can be a ISBN number
+# or the project homepage.
+#
+# epub_identifier = ''
+
+# A unique identification for the text.
+#
+# epub_uid = ''
+
+# A list of files that should not be packed into the epub file.
+epub_exclude_files = ['search.html']
+
+
+# -- Extension configuration -------------------------------------------------
+
+# -- Options for todo extension ----------------------------------------------
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True

lost_ds-1.2.0a4/docs/sphinx/source/index.rst

@@ -0,0 +1,27 @@
+.. lost_ds documentation master file, created by
+   sphinx-quickstart on Wed Nov 14 10:46:34 2018.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Welcome to lost_ds's documentation!
+================================
+
+.. figure:: images/lost_ds.jpg
+
+
+About lost_ds
+============
+TODO Describe it here
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+        lds.hello <lds.hello.rst>
+        
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`search`