[Feature&Doc] Add ijcai code url (#968)

* support setting iters_per_epoch -1 fo adaptive length of dataloader

* update ijcai2024 code url

* change install order

Author: HydrogenSulfate

README.md

@@ -13,7 +13,10 @@
 
 [**PaddleScience使用文档**](https://paddlescience-docs.readthedocs.io/zh-cn/latest/)
 
-🔥 [IJCAI 2024: 任意三维几何外形车辆的风阻快速预测竞赛](https://competition.atomgit.com/competitionInfo?id=7f3f276465e9e845fd3a811d2d6925b5)，欢迎报名参赛。
+🔥 [IJCAI 2024: 任意三维几何外形车辆的风阻快速预测竞赛](https://competition.atomgit.com/competitionInfo?id=7f3f276465e9e845fd3a811d2d6925b5)，track A, B, C 代码：
+
+- [paddle实现](../jointContribution/IJCAI_2024/README.md)
+- [pytorch实现](https://competition.atomgit.com/competitionInfo?id=7f3f276465e9e845fd3a811d2d6925b5)(点击**排行榜**可查看各个赛道前10名的代码)
 
 <!-- --8<-- [start:description] -->
 ## 👀简介
@@ -168,13 +171,13 @@ python -c "import paddle; paddle.utils.run_check()"
 
     - pip 安装
 
-        执行以下命令以 pip 的方式安装 nightly build / release 版本的 PaddleScience。
+        执行以下命令以 pip 的方式安装 release / nightly build 版本的 PaddleScience。
         <!-- --8<-- [start:pip_install] -->
         ``` shell
-        # nightly build
-        pip install https://paddle-qa.bj.bcebos.com/PaddleScience/whl/latest/dist/paddlesci-0.0.0-py3-none-any.whl
         # release
-        # pip install -U paddlesci
+        pip install -U paddlesci
+        # nightly build
+        # pip install https://paddle-qa.bj.bcebos.com/PaddleScience/whl/latest/dist/paddlesci-0.0.0-py3-none-any.whl
         ```
         <!-- --8<-- [end:pip_install] -->
 

docs/index.md

@@ -4,7 +4,10 @@
 ./README.md:status
 --8<--
 
-🔥 [IJCAI 2024: 任意三维几何外形车辆的风阻快速预测竞赛](https://competition.atomgit.com/competitionInfo?id=7f3f276465e9e845fd3a811d2d6925b5)，欢迎报名参赛。
+🔥 [IJCAI 2024: 任意三维几何外形车辆的风阻快速预测竞赛](https://competition.atomgit.com/competitionInfo?id=7f3f276465e9e845fd3a811d2d6925b5)，track A, B, C 代码：
+
+- [paddle实现](../jointContribution/IJCAI_2024/README.md)
+- [pytorch实现](https://competition.atomgit.com/competitionInfo?id=7f3f276465e9e845fd3a811d2d6925b5)(点击**排行榜**可查看各个赛道前10名的代码)
 
 <style>
     .container {
@@ -158,7 +161,7 @@
 === "方式2: pip安装"
 
     ``` sh
-    pip install paddlesci
+    pip install -U paddlesci
     ```
 
 **完整安装流程**：[安装与使用](./zh/install_setup.md)

ppsci/solver/solver.py

@@ -69,7 +69,9 @@ class Solver:
         optimizer (Optional[optimizer.Optimizer]): Optimizer object. Defaults to None.
         lr_scheduler (Optional[optimizer.lr.LRScheduler]): Learning rate scheduler. Defaults to None.
         epochs (int, optional): Training epoch(s). Defaults to 5.
-        iters_per_epoch (int, optional): Number of iterations within an epoch. Defaults to 20.
+        iters_per_epoch (int, optional): Number of iterations within an epoch. If set to -1,
+            than will be automatically set to the length of dataloader of given constraint.
+            Defaults to 20.
         update_freq (int, optional): Update frequency of parameters. Defaults to 1.
         save_freq (int, optional): Saving frequency for checkpoint. Defaults to 0.
         log_freq (int, optional): Logging frequency. Defaults to 10.
@@ -215,6 +217,18 @@ def __init__(
             self.start_eval_epoch = start_eval_epoch
             self.eval_freq = eval_freq
 
+        if self.iters_per_epoch == -1 and self.constraint is not None:
+            if len(self.constraint) != 1:
+                raise NotImplementedError(
+                    f"Multiple({len(self.constraint)}) constraints are detected, "
+                    "which is not supported yet, when 'iters_per_epoch' is set to -1."
+                )
+            self.iters_per_epoch = len(next(iter(self.constraint.values())).data_loader)
+            logger.message(
+                "Detected 'iters_per_epoch' is set to -1, 'iters_per_epoch' is now "
+                f"reset to the length of dataloader({self.iters_per_epoch}) of given constraint."
+            )
+
         # initialize training log(training loss, time cost, etc.) recorder during one epoch
         self.train_output_info: Dict[str, misc.AverageMeter] = {}
         self.train_time_info = {

ppsci/utils/config.py

@@ -116,10 +116,15 @@ def epochs_check(cls, v):
 
         @field_validator("iters_per_epoch")
         def iters_per_epoch_check(cls, v):
-            if v <= 0:
+            if v <= 0 and v != -1:
                 raise ValueError(
-                    "'TRAIN.iters_per_epoch' should be a positive integer when is type of int"
-                    f", but got {v}"
+                    f"'TRAIN.iters_per_epoch' received an invalid value({v}), "
+                    "but is expected one of: \n"
+                    "* A positive integer, to manually specify the number of iterations per epoch, "
+                    "which is commonly used in PINN training.\n"
+                    "* -1, to automatically set the number of iterations per epoch to "
+                    "the length of dataloader of given constraint, which is commonly "
+                    f"used in data-driven training.\n"
                 )
             return v