Skip to content

Improve README with Examples & Real-World Applications #145

Description

@Unnati-2061

Right now, the README explains what AtomDB does, but it could be more beginner-friendly. Adding simple code examples and real-world use cases will help new users quickly understand how to use the library and why it’s useful.

Proposed Improvements:

  • Code Examples in the Functionality Section

Like Showing how to retrieve atomic properties, calculate electron density, and use promolecular models.

from atomdb import AtomDB

atom = AtomDB.get_element("O")  # Get Oxygen properties
print(atom.atomic_mass, atom.ionization_potential)
  • Add links to the full API docs for deeper exploration.

Adding another section - "How People Use AtomDB"
Highlight practical applications, such as:

  • Computational Chemistry – Using atomic data for simulations.
  • Material Science – Estimating molecular properties.
  • Machine Learning – Training AI models with atomic behavior predictions.

Why this important ?

  • Makes it easier for new users to get started.
  • Shows AtomDB’s real-world impact.
  • Encourages more people to use and contribute to the project.

Would love to hear your point of view on this !

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomers

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions