Update README.md

README.md

@@ -10,12 +10,9 @@ tags:
 license: other        
 ---
 
-
 # tle-orbit-explainer
 
-A LoRA adapter for **Qwen-1.5-7B** that transforms raw Two-Line Elements (TLEs)
-into natural-language orbit explanations, decay risk scores, and anomaly flags
-for Space-Domain-Awareness (SDA) workflows.
+A LoRA adapter for **Qwen-1.5-7B** that translates raw Two-Line Elements (TLEs) into natural-language orbit explanations, decay risk scores, and anomaly flags for general space awareness workflows.
 
 ---
 
@@ -23,23 +20,23 @@ for Space-Domain-Awareness (SDA) workflows.
 
 ### Model Description
 
-| | |
-|---|---|
-| **Developed by** | Jack Al-Kahwati / Stardrive |
-| **Funded by** | ⬜️ (Self-funded) |
-| **Shared by** | jackal79 (Hugging Face) |
-| **Model type** | LoRA adapter (`peft==0.10.0`) |
-| **Languages** | English |
-| **License** | apache-2.0 |
+|                    |                                                             |
+| ------------------ | ----------------------------------------------------------- |
+| **Developed by**   | Jack Al-Kahwati / Stardrive                                 |
+| **Funded by**      | ⬜️ (Self-funded)                                            |
+| **Shared by**      | jackal79 (Hugging Face)                                     |
+| **Model type**     | LoRA adapter (`peft==0.10.0`)                               |
+| **Languages**      | English                                                     |
+| **License**        | apache-2.0                                                  |
 | **Finetuned from** | [`Qwen/Qwen1.5-7B`](https://huggingface.co/Qwen/Qwen1.5-7B) |
 
 ### Model Sources
 
-| | |
-|---|---|
-| **Repository** | <https://huggingface.co/jackal79/tle-orbit-explainer> |
-| **Paper / Blog** | ⬜️ (optional link) |
-| **Demo** | ⬜️ Gradio / Space (optional) |
+|                  |                                                                                                            |
+| ---------------- | ---------------------------------------------------------------------------------------------------------- |
+| **Repository**   | [https://huggingface.co/jackal79/tle-orbit-explainer](https://huggingface.co/jackal79/tle-orbit-explainer) |
+| **Paper / Blog** | ⬜️ (optional link)                                                                                         |
+| **Demo**         | ⬜️ Gradio / Space (optional)                                                                               |
 
 ---
 
@@ -47,36 +44,36 @@ for Space-Domain-Awareness (SDA) workflows.
 
 ### Direct Use
 
-* Rapid orbital-state summarisation for flight-dynamics teams  
-* Analyst chat-assistants that translate TLEs into plain English  
-* Offline dataset annotation (adding orbit-class labels)
+* Quick summarization of satellite orbital states for analysts
+* Plain-language TLE explanations for educational purposes
+* Offline dataset labeling (orbital classifications)
 
 ### Downstream Use
 
-* Fuse with SGP4 for full position forecasting  
-* Embed in on-board autonomy stacks 
-* Pre-prompted agent in secure pipelines 
+* Combine with SGP4 for enhanced position forecasting
+* Integration into satellite autonomy stacks (cubesats, small-scale hardware)
+* Pre-prompted agent support in secure orbital management workflows
 
 ### Out-of-Scope Use
 
-* Precise orbit propagation without a physics engine  
-* Weapon-targeting or lethal-autonomy decision loops  
-* Any jurisdiction that prohibits ML export (check ITAR/EAR)
+* High-precision orbit propagation without additional physics modeling
+* Applications related to targeting, weapons systems, or lethal autonomous decisions
+* Jurisdictions prohibiting ML or data export (verify with ITAR/EAR guidelines)
 
 ---
 
 ## Bias, Risks, & Limitations
 
-| Category | Note |
-|----------|------|
-| **Data bias** | Trained only on *decayed* objects (`DECAY = 1`) → may under-predict longevity for active constellations. |
-| **Temporal limits** | Snapshot reasoning; no 1 Hz time-series learned yet. |
-| **Language** | English explanations only. |
-| **Security** | Model could hallucinate wrong decay dates → always cross-check. |
+| Category            | Note                                                                                                          |
+| ------------------- | ------------------------------------------------------------------------------------------------------------- |
+| **Data bias**       | Trained primarily on decayed objects (`DECAY = 1`), possibly underestimating longevity for active satellites. |
+| **Temporal limits** | Operates on snapshot data; does not handle continuous high-frequency time-series.                             |
+| **Language**        | Supports explanations in English only.                                                                        |
+| **Accuracy**        | Potential inaccuracies in decay date predictions; verify independently.                                       |
 
 ### Recommendations
 
-Integrate physics-based checks before acting on decay predictions; keep human-in-the-loop for any safety-critical task.
+Incorporate independent physics-based validation before operational use and maintain a human-in-the-loop for any critical or high-risk decisions.
 
 ---
 
@@ -102,3 +99,4 @@ prompt = """### Prompt:
 ### Reasoning:
 """
 print(pipe(prompt, max_new_tokens=120)[0]["generated_text"])
+```