Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rough out an explanatory readme #59

Open
ngraymon opened this issue Jun 3, 2022 · 4 comments
Open

Rough out an explanatory readme #59

ngraymon opened this issue Jun 3, 2022 · 4 comments
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@ngraymon
Copy link
Owner

ngraymon commented Jun 3, 2022

Gives basic idea of how to use driver.py and _glue_.py and "roughly" where things are structured in files and what the user should expect out of the program.

@ngraymon ngraymon added this to the Migrating to github milestone Jun 3, 2022
@ngraymon
Copy link
Owner Author

ngraymon commented Jun 6, 2022

@ngraymon ngraymon added the documentation Improvements or additions to documentation label Jun 6, 2022
@lhprice
Copy link
Collaborator

lhprice commented Jun 8, 2022

residual_term_builder (tempname)

About

Install

pip install (final name)

Usage

driver.py is the main argparse interface py driver.py -h

-t : provide truncations
-a, --ansatz : specify ansatz

explain 3 ansatz and their trunc keys

-es, --excited_state : by default this is True but if provided will only produce the ground state
-rf, --remove_f_terms : remove f terms (TODO: f terms explanation)
-c, --code : generate the python code files instead of the Latex
-lhs : Turn on the LHS generator for easier finding of dt/dtau (might need some advanced desc here)

On top of the driver explanation need to give a basic idea of glue so that one can create a "in-house" driver.py if they desire

@ngraymon
Copy link
Owner Author

ngraymon commented Jun 8, 2022

Probably start by just copying the output of -h argument passed to driver.py
Maybe show that you "could" directly call generate_full_cc_latex from latex_full_cc.py but why would you want to?
Maybe mention that _glue_.py just contains some processing to check the input truncations and also to stitch together the filenames?

Maybe just saying that driver.py + _glue_.py are effectively user UI / interface to the actual package?
People are free to directly access the modules, but might run into errors if input args are not correctly formatted.

@ngraymon
Copy link
Owner Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants