xttmp 2.3.0__py3-none-any.whl

xttmp-2.3.0.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: xttmp
+Version: 2.3.0
+Summary: eXtremely Tiny Target - Motion Perception
+Author-email: Shawn MX <mingshuoxu@hotmail.com>
+Project-URL: Homepage, https://github.com/MingshuoXu/Small-Target-Motion-Detectors
+Project-URL: Source, https://github.com/MingshuoXu/Small-Target-Motion-Detectors
+Project-URL: Issues, https://github.com/MingshuoXu/Small-Target-Motion-Detectors/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+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: Topic :: Scientific/Engineering :: Image Recognition
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: matplotlib
+Requires-Dist: opencv-python
+Requires-Dist: scipy
+Requires-Dist: torch>=2.5.0
+Requires-Dist: torchvision>=0.20.0
+Dynamic: license-file
+
+# Small Target Motion Detectors, Version 2.3 (XTT-MP: Extremely Tiny Target - Motion Perception)
+
+[![PyPI version](https://img.shields.io/pypi/v/XTT-MP.svg)](https://pypi.org/project/XTT-MP/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE) [![Python](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/) [![PyTorch](https://img.shields.io/badge/pytorch-1.10%2B-ee4c2c)](https://pytorch.org/)
+
+
+**XTT-MP** (Extremely Tiny Target - Motion Perception) is a natural architecture-based framework specifically designed for detecting and perceiving the motion of **extremely small targets** in complex environments.
+
+This release is torch-first: CPU, CUDA, and Apple platforms all use the same torch tensor path, so there is no longer a numpy-only CPU branch to maintain. The model layer now follows a standard `nn.Module` flow with `__init__` and `forward`, while core blocks keep their internal lifecycle helpers such as `setup` and `reset_buffer`.
+
+Built with modularity and extensibility in mind, XTT-MP provides a robust suite of tools for researchers and developers to iterate on tiny-object detection and motion analysis algorithms.
+
+---
+
+## ✨ Key Features
+
+- **Tiny Target Specialist**: Optimized feature extraction and attention mechanisms tailored for sub-8x8 pixel objects.
+- **Motion-Aware Architecture**: Integrated spatiotemporal modules to enhance temporal consistency and motion trajectory estimation.
+- **Decoupled Design**: model and core layers are separated cleanly, which makes future learning modules easier to integrate.
+- **Torch-Only Runtime**: inference and post-processing stay in torch tensors on both CPU and GPU, with Apple users able to run the same code path without a CUDA-specific fallback.
+
+## 📦 Installation
+
+### Prerequisites
+- Python 3.8+
+- PyTorch 1.10+
+- CUDA 11.3+ (optional, for NVIDIA acceleration)
+- Apple Silicon or macOS users can use the same torch-based workflow without numpy-specific CPU code.
+
+### Version Notes
+- Model classes now expose the standard `__init__` + `forward` flow.
+- Core classes provide lifecycle helpers such as `setup` and `reset_buffer`.
+- CPU and GPU outputs are both represented as torch tensors.
+
+### Example Resources
+- Example data and demo assets stay in the GitHub repository under `example-data/`.
+- They are not packaged into the PyPI distribution.
+- After `pip install xttmp`, use the installed code and bring your own input data, or run from a repository checkout to access the bundled examples.
+
+### Via PyPI
+```bash
+pip install xttmp
+xttmp-gui
+```
+
+### Citation
+
+If you find this project useful for your research, please consider citing by this.
+```
+@misc{STMDgit,
+	author       = {Xu, Mingshuo},
+	title        = {Small-Target-Motion-Detectors, Version 2},
+	year         = {2024},
+	url          = {https://github.com/MingshuoXu/Small-Target-Motion-Detectors},
+	note         = {Accessed: 2025-12-12}
+}
+```

xttmp-2.3.0.dist-info/RECORD

@@ -0,0 +1,45 @@
+xttmp/__init__.py,sha256=1W3RkAt0T2naEtt2Gq3R9Mp8xBXpZMSbOUKHzvzz1HA,34
+xttmp/main.py,sha256=IOnOgQAjVqIT2WUPmPlv6kZ-T3yKFS7WP97IFpDmfwU,301
+xttmp/api/__init__.py,sha256=XsHRFRcUgn_U-MQIZj19_GiJjHKmGAnJ9knKmr68prM,167
+xttmp/api/evaluate.py,sha256=xHlqYCH0J5knQQy_3QTPvGkyoBM67Dzakha_z83Ouiw,5472
+xttmp/api/get_visualize_handle.py,sha256=ypGl9e1ie6uNhyTA5cCe--ANx2T3wHWpjQzn96gtjDM,964
+xttmp/api/instancing_model.py,sha256=1oEPr1_dOIDL3vmvBhxxj486EuKRFfkPaWxj_xn_TcY,907
+xttmp/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xttmp/core/apgstmd_core.py,sha256=D_aLtzc2ARri93TGvqCCHbiC9S11hNHngI7XJc-3zjc,6645
+xttmp/core/apgstmdv2_core.py,sha256=yKhtctFVufAfj0NU4MRksKf44ZXDbbVgZIizhM3loc4,2398
+xttmp/core/base_core.py,sha256=qTZUTZLcTurc4y4kzjK4spdw7HmoycKVxsmq1vSNT2A,653
+xttmp/core/dstmd_core.py,sha256=1_9cjUjB1TGQQlTFjfqaJNJKYR5IG_rH4_DX7DyZ5Sk,7537
+xttmp/core/estmd_backbone.py,sha256=xxAcPU-ki8TLVxbWS4TJ3Wjxl4alrjX6llw35I5o0UU,3288
+xttmp/core/estmd_core.py,sha256=22msfoJi73DxvETNPcYf9iAiAHphTyh9i-kYPcEtDHs,10873
+xttmp/core/feedbackstmd_core.py,sha256=uC35477S2C6lVJ8fU7YkfUu80aeH913g5ObkSJMLMyE,2170
+xttmp/core/fracstmd_core.py,sha256=YtX972hBjzUmvQPor1ihpcBgpp2_wIQKpng7Y_wlQ5M,3111
+xttmp/core/fstmd_core.py,sha256=7WJVvv_m8jKecLgNfTPWwXzJblpE1vKjA5NEm3zC4Fg,427
+xttmp/core/fstmdv2_core.py,sha256=RjZ3cZUgraunhsABGIFWzep7ccx-SB_aHPYNSH8kahQ,1357
+xttmp/core/haarstmd_core.py,sha256=XSW_D4o0d2zGgSaLeVJwJ_4UUqxIkVo-22nwYWn1Up0,5734
+xttmp/core/math_operator.py,sha256=rCUioqULDV-9FEmBRqIVorBJCSDxwEUdKVtQhFY-jfM,11699
+xttmp/core/stfeedbackstmd_core.py,sha256=3oOQ8Amyqt5Z1Yzp87fQD8rfK7WWLwRD8q9rWoV8Vo0,8319
+xttmp/core/stmdplus_core.py,sha256=fFQYTb-Ny0pocvGItvKOP0GbjnJYP629XItUmr1FcDU,8394
+xttmp/core/stmdplusv2_core.py,sha256=5sL1US4qml7_L-oc8rKJ4fkl2JqTQCXmTn3i9sgjDTI,3063
+xttmp/core/vstmd_core.py,sha256=g-MwvYcvsxzlJZbc2idzhp57sKMcS-v7bFoBB74NbvQ,15287
+xttmp/demo/evaluate_model.py,sha256=6IMCFvC7vMojyT81mK8dScrViyV2Hk6g6GC89lJcmDM,3430
+xttmp/demo/inference_gui.py,sha256=G-oGw6oSkkpAhCe2yk1SjOUrBh_iJKkHqDe2KdJcte8,5460
+xttmp/demo/inference_gui_single_process.py,sha256=VoYePYaFQnEDtkqRpfUXulKs3B9kHEaN8dGHEWRBR6U,4673
+xttmp/demo/inference_image_stream.py,sha256=VSyQLSDH3iRDo-F5fYZqojPACrPRwo36uv--8nJWWTA,2041
+xttmp/demo/inference_video.py,sha256=d8EYxoQIsVOMivdkeWjdyyITYpNGW_rBE-xXsa-akXs,2035
+xttmp/model/__init__.py,sha256=gav-Fo1x7wScAzohzqZ2S_9viedm0xTl53uFL_sQvBk,562
+xttmp/model/backbone.py,sha256=o_6Hys_inHQGIZvvSUEAP5qrPVt4IcesXU02cAB1ewc,22482
+xttmp/model/facilitated_model.py,sha256=o6_ypSNQo6pdgjhobWCTlNYN3ENT1Gd0N52pJjEokPU,10090
+xttmp/model/feedback_model.py,sha256=IDEaGb9iaIKV7acIlpSAOYgLa1E5HC-HOq2P8ZDy0BA,10303
+xttmp/model/haarstmd.py,sha256=fyYkApeFtZCkvvz0zNhyAlcB4kY0HqxaCMwURFwit5Y,2176
+xttmp/model/vstmd.py,sha256=k0EdwSVh3HS5G6Te6SPUgHs--ZELWSlI9NOi47i1GzQ,16381
+xttmp/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xttmp/util/compute_module.py,sha256=CVZf8HH5OfEdOf7id1oOxlnuJ33g0EtGAnkNDVyFaWQ,12380
+xttmp/util/create_kernel.py,sha256=FAMOnZ5ry55gsqLrcAv-q4oD0TKFaSi0KrXlfrkHAmU,12844
+xttmp/util/evaluate_module.py,sha256=14D4AmWsfOBM2HtB6Q6pPRENSupNmmtMj7so05lmnW0,27937
+xttmp/util/iostream.py,sha256=EeiWe5IDCIRAja5te9s0m28Rjuc_KnIRHo7brRLHK_4,26546
+xttmp-2.3.0.dist-info/licenses/LICENSE,sha256=g6mqXg3HVkaCzj3DIMKsuOTqiZVY7Mo6qzt-66swTqA,10581
+xttmp-2.3.0.dist-info/METADATA,sha256=SVc9yytDKPkMwOPTi3n-ajRQ6U4rR5f8ZxD8mNrCheo,4253
+xttmp-2.3.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+xttmp-2.3.0.dist-info/entry_points.txt,sha256=jdk6DA-szNHIl8s5nY7vkIQnU-m9DA3NyHlYaX11-QA,46
+xttmp-2.3.0.dist-info/top_level.txt,sha256=lok2PfgxSEKjxlcnaW62x7qd9mg8JS0Pqx9DJW-Yo5Y,6
+xttmp-2.3.0.dist-info/RECORD,,

xttmp-2.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

xttmp-2.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+xttmp-gui = xttmp.main:main

xttmp-2.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the
+original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable by
+such Contributor that are necessarily infringed by their Contribution(s)
+alone or by combination of their Contribution(s) with the Work to
+which such Contribution(s) was submitted. If You institute patent
+litigation against any entity (including a cross-claim or counterclaim
+in a lawsuit) alleging that the Work or a Contribution incorporated
+within the Work constitutes direct or contributory patent infringement,
+then any patent licenses granted to You under this License for that
+Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You meet
+the following conditions:
+
+   a. You must give any other recipients of the Work or Derivative
+      Works a copy of this License; and
+
+   b. You must cause any modified files to carry prominent notices
+      stating that You changed the files; and
+
+   c. You must retain, in the Source form of any Derivative Works
+      that You distribute, all copyright, patent, trademark, and
+      attribution notices from the Source form of the Work,
+      excluding those notices that do not pertain to any part of
+      the Derivative Works; and
+
+   d. If the Work includes a "NOTICE" text file as part of its
+      distribution, then any Derivative Works that You distribute
+      must include a readable copy of the attribution notices
+      contained within such NOTICE file, excluding those notices
+      that do not pertain to any part of the Derivative Works,
+      in at least one of the following places: within a NOTICE text
+      file distributed as part of the Derivative Works; within the
+      Source form or documentation, if provided along with the
+      Derivative Works; or, within a display generated by the
+      Derivative Works, if and wherever such third-party notices
+      normally appear. The contents of the NOTICE file are for
+      informational purposes only and do not modify the License.
+      You may add Your own attribution notices within Derivative
+      Works that You distribute, alongside or as an addendum to the
+      NOTICE text from the Work, provided that such additional
+      attribution notices cannot be construed as modifying the
+      License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all other
+commercial damages or losses), even if such Contributor has been
+advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only on
+Your own behalf and on Your sole responsibility, not on behalf of
+any other Contributor, and only if You agree to indemnify, defend,
+and hold each Contributor harmless for any liability incurred by,
+or claims asserted against, such Contributor by reason of your
+accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following
+boilerplate notice, with the fields enclosed by brackets "[]"
+replaced with your own identifying information. (Don't include
+the brackets!)  The text should be enclosed in the appropriate
+comment syntax for the file format. We also recommend that a
+file or class name and description of purpose be included on the
+same "printed page" as the copyright notice for easier
+identification within third-party archives.
+
+Copyright 2026 Shawn MX
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

xttmp-2.3.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+xttmp