PERIODIC EVO 1.2
================

Author: smaggelThief
Platform: TI-84 Evo with the Python App

ARCHIVE DESCRIPTION
-------------------

Periodic Evo is a fast, full-featured periodic-table explorer for the
TI-84 Evo. It includes all 118 known elements, element details with units,
spatial table navigation, alphabetical and atomic-number sorting, chemical
family highlighting, property graphs, and calculator-list export.

ABOUT THE AUTHOR
----------------

smaggelThief created Periodic Evo as an independent TI-84 Evo community
project. It is not affiliated with or endorsed by Texas Instruments.

REQUIREMENTS
------------

* TI-84 Evo graphing calculator
* TI-84 Evo Python App
* TI Connect Evo and a USB-C data cable

This program is for the TI-84 Evo. It is not a TI-84 Plus CE program.

INSTALLATION
------------

1. Extract this ZIP archive on your computer.
2. Connect the TI-84 Evo with a USB-C data cable.
3. Open TI Connect Evo and transfer PERIODIC.py to the calculator.
4. Open the Python App on the calculator.
5. Select PERIODIC and run it.

The Python shell may briefly show "from PERIODIC import *" while loading.
The graphical periodic-table interface should then appear automatically.

CONTROLS
--------

Main table:
  LEFT/RIGHT  Previous or next atomic number
  UP/DOWN     Move spatially through the table
  ENTER       Open the selected element's details
  2ND         Open the main menu
  CLEAR       Exit
  Y=          Open the main menu
  WINDOW      Open the element list
  ZOOM        Open the selected element's details
  TRACE       Open About
  GRAPH       Exit

To graph a property, press Y= on the main table and select GRAPH PROPERTIES.

The main table starts in fast-loading mode with colored, outlined cells and no
element symbols. Open Menu > Options and select HIGH DETAIL LOADING to toggle
the element symbols on or off. The setting resets to OFF when the program exits.

Element details:
  UP/DOWN     Select a property
  LEFT/RIGHT  Previous or next element
  ENTER       Show an explanation of the selected property
  2ND         Store a numeric property in calculator list PVAL
  CLEAR       Return to the table

Element list:
  UP/DOWN     Move one element
  LEFT/RIGHT  Move eight elements
  2ND         Sort by atomic number, name, or symbol
  ENTER       Open element details
  CLEAR       Return

Graphs:
  LEFT/RIGHT  Trace available property values
  ENTER       Open the traced element's details
  CLEAR       Return

FEATURES
--------

* Complete 118-element periodic table
* Atomic mass, neutron estimate, proton count, electron configuration,
  atomic radius, first ionization energy, electronegativity, density,
  melting point, boiling point, standard state, oxidation states,
  discovery year, and chemical family
* Highlighting by chemical family
* Graphs and calculator-list exports for selected numeric properties
* Units displayed directly beside applicable values
* Optimized table rendering for the TI-84 Evo display
* Incremental graph tracing without reloading the complete graph on each step
* Optional high-detail table symbols, disabled by default for faster loading

UNITS AND DATA NOTES
--------------------

  Atomic mass            u
  Atomic radius          pm
  First ionization       eV
  Electronegativity      Pauling scale
  Density                g/cm3
  Melting/boiling point  K

Element properties come from the PubChem Periodic Table dataset maintained
by the U.S. National Library of Medicine. The included values were retrieved
on August 29, 2026 and compared field-by-field with the PubChem JSON dataset.

https://pubchem.ncbi.nlm.nih.gov/rest/pug/periodictable/JSON

Unavailable source values appear as --. Neutron counts are estimates found
by rounding the listed atomic mass and subtracting the atomic number. They do
not describe every isotope of an element.

CALCULATOR LISTS
----------------

Pressing 2ND on a numeric detail stores that value in PVAL. Property export
creates NUM for atomic numbers and one of these property lists:

  RAD   Atomic radius (pm)
  ION   First ionization energy (eV)
  ENEG  Electronegativity (Pauling scale)
  DEN   Density (g/cm3)
  MELT  Melting point (K)

Unknown exported values use -1. If the calculator limits a list to 100 items,
the program creates A and B list pairs, such as NUMA/NUMB and RADA/RADB.

FILES
-----

  PERIODIC.py  Calculator program
  README.txt   Documentation
  LICENSE.txt  Redistribution license

REDISTRIBUTION
--------------

The program code was created for this project and is released under the MIT
License in LICENSE.txt. No third-party images, video, or binary assets are
included. Chemical element facts are attributed to PubChem above.

VERSION HISTORY
---------------

1.2  Added author credit and publication documentation; corrected the Evo
     polygon-size limit; added graph-row softkeys, incremental graph tracing,
     optional high-detail symbols, removed the redundant expanded-table view,
     added direct graph access from the main menu, and refined detail controls.
1.1  Added visible units, verified PubChem values, improved highlight spacing,
     clarified list storage, and accelerated table rendering.
