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

add the explanation of autotest to doc #891

Closed
wants to merge 10 commits into from
Closed

add the explanation of autotest to doc #891

wants to merge 10 commits into from

Conversation

yato0422
Copy link
Contributor

add the explanation of "autotest"

yato0422 and others added 3 commits August 19, 2022 09:36
add the explanation of autotest

Signed-off-by: yato0422 <73833089+yato0422@users.noreply.github.com>
doc/index.rst Outdated Show resolved Hide resolved
@codecov-commenter
Copy link

codecov-commenter commented Aug 19, 2022

Codecov Report

Merging #891 (cca9bbd) into devel (8dea29e) will increase coverage by 3.07%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##            devel     #891      +/-   ##
==========================================
+ Coverage   35.13%   38.21%   +3.07%     
==========================================
  Files          96       99       +3     
  Lines       16804    17818    +1014     
==========================================
+ Hits         5904     6809     +905     
- Misses      10900    11009     +109     
Impacted Files Coverage Δ
dpgen/generator/lib/make_calypso.py 70.06% <0.00%> (-7.46%) ⬇️
dpgen/generator/run.py 62.13% <0.00%> (-1.55%) ⬇️
dpgen/data/gen.py 47.88% <0.00%> (-0.60%) ⬇️
dpgen/tools/relabel.py 14.60% <0.00%> (-0.14%) ⬇️
dpgen/simplify/simplify.py 0.00% <0.00%> (ø)
dpgen/generator/lib/run_calypso.py 10.00% <0.00%> (ø)
dpgen/generator/lib/calypso_run_opt.py 0.00% <0.00%> (ø)
dpgen/generator/lib/calypso_check_outcar.py 0.00% <0.00%> (ø)
dpgen/generator/lib/calypso_run_model_devi.py 0.00% <0.00%> (ø)
dpgen/auto_test/Gamma.py 62.84% <0.00%> (ø)
... and 21 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

Signed-off-by: yato0422 <73833089+yato0422@users.noreply.github.com>
Signed-off-by: yato0422 <73833089+yato0422@users.noreply.github.com>
@njzjz
Copy link
Member

njzjz commented Aug 19, 2022

Please set a proper PR tiltle.


where the key `structures` provides the structures to relax. `interaction` is provided with `deepmd`, and other options are `vasp`, `eam`, `meam`...

Yuzhi:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe remove this line?

doc/index.rst Outdated
@@ -46,6 +46,7 @@ DPGEN's documentation
:maxdepth: 2
:caption: Autotest

Autotest/autotest
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please use a lowercase directory.

@wanghan-iapcm wanghan-iapcm changed the title Dev hujunwei add the explanation of autotest to doc Aug 20, 2022
@kevinwenminion
Copy link
Collaborator

We have already revised the autotest part in the ''readme'' file of dpgen several days ago. We will finalize it and pr to dpgen in next few days.

@@ -0,0 +1,35 @@
For the implementation, one should do :
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a title to each document.

yato0422 and others added 3 commits August 26, 2022 10:26
Signed-off-by: yato0422 <73833089+yato0422@users.noreply.github.com>
@njzjz
Copy link
Member

njzjz commented Aug 27, 2022

I open the preview but see nothing new in the TOC:

image

Signed-off-by: yato0422 <73833089+yato0422@users.noreply.github.com>
mp-1/eos_00 mp-2/eos_00 mp-3/eos_00
```

where `00` are suffix of the task.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are also many other properties.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is just a simple example. A full one see Property-get-started-and-input-examples.md.

}
}
```
# Auto test: to do list
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we need to add the ''to do list" inside.

3. Task.make_input_file(Property.task_type): Prepare input files for a computational task.
For example, the VASP prepares INCAR.
LAMMPS (including DeePMD, MEAM...) prepares in.lammps.
The parameter of this task will be stored in 'output_dir/task.json'
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure if we need to add the to-do-list for autotest in documentation because this is not intended for users. If this is for developers, we may add more explanations to help developers in adding new features.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure if we need to add the to-do-list for autotest in documentation because this is not intended for users.

Agree. It should not be in a user guide.

3. Task.make_input_file(Property.task_type): Prepare input files for a computational task.
For example, the VASP prepares INCAR.
LAMMPS (including DeePMD, MEAM...) prepares in.lammps.
The parameter of this task will be stored in 'output_dir/task.json'
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure if to-do-list is needed in the documentation because this is not for users. If this is intended for developers, we may add more explanations to help developers in adding new features.


where the key `structures` provides the structures to relax. `interaction` is provided with `deepmd`, and other options are `vasp`, `eam`, `meam`...

Yuzhi:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

leave this out (same comment as Jinzhe)

}
]
}
```
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

May compare this example with the current example in README. The example for eos here is not for the current autotest.

}
}
}
```
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Need to change the example for EOS (see README).

HuangJiameng added a commit to HuangJiameng/dpgen that referenced this pull request Aug 27, 2022
- fix contents according to comments in deepmodeling#891
- reorganize the document structure
@HuangJiameng
Copy link
Collaborator

Since the author of this pr is quite busy these days, I take it over in #923. This pr can be closed.

@AnguseZhang
Copy link
Collaborator

Since the author of this pr is quite busy these days, I take it over in #923. This pr can be closed.

Closed. Thanks again for all the contributors in this PR.

wanghan-iapcm pushed a commit that referenced this pull request Sep 2, 2022
- fix contents according to suggestions in #891
- reorganize the document structure
- this doc is based on autotest wiki and README(devel)

Signed-off-by: yato0422 <73833089+yato0422@users.noreply.github.com>
Co-authored-by: hp <junwei.hu12@gmail.com>
Co-authored-by: yato0422 <73833089+yato0422@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants